Overzicht van nieuwe Japanse tijdperkupdates voor .NET Framework

In dit artikel worden de nieuwe Japanse tijdperkupdates voor .NET Framework geïntroduceerd.

Oorspronkelijke productversie: .NET Framework 3.5 en latere versies
Origineel KB-nummer: 4477957

Samenvatting

Op 1 mei 2019 begint het nieuwe tijdperk in de Japanse kalender. Microsoft bereidt zich voor op deze wijzigingen en is van plan updates te verzenden in elke maandelijkse rollup-release. Dit is de eerste overgang van het ene tijdperk naar het andere sinds januari 1989, en ook de eerste in de geschiedenis van .NET Framework. Dit artikel is bedoeld om ontwikkelaars te helpen bij het testen en controleren hoe tijdperken werken in .NET-toepassingen, hoe toepassingen worden beïnvloed door de verandering in het tijdperk en wat u als ontwikkelaar moet doen om ervoor te zorgen dat uw toepassingen de toekomstige wijzigingen in het Japanse tijdperk met succes verwerken.

Zie KB-4469068 voor meer informatie over Windows-updates voor de wijziging van het Japanse tijdperk.

updates .NET Framework

De volgende releases bevatten de Japanse tijdperkupdates voor .NET Framework. Ze bevatten ook kwaliteits- en betrouwbaarheidsverbeteringen.

• .NET Framework september 2018 preview van kwaliteitsrollup
• .NET Framework, november 2018, beveiligings- en kwaliteitsrollup
• .NET Framework, december 2018, beveiligings- en kwaliteitsrollup
• Update van .NET Framework maart 2019
• .NET Framework mei 2019 Beveiligings- en kwaliteitsrollup

Knowledge Base-artikelen per .NET Framework-versie voor japanse tijdperkupdates

De onderhoudsupdates die in de volgende tabel worden vermeld, bevatten alle Japanse tijdperkupdates voor .NET Framework die al zijn opgenomen in de eerder uitgebrachte updates. De onderhoudsupdates bevatten ook een nieuwe kwaliteitsupdate waarmee de afhankelijkheid van enkele aanhalingstekens wordt verwijderd om het Gannen-teken uit te voeren in japanse tijdperkopmaak, zodat "y年" een of "y'年'" van de aangepaste datum- en tijdnotatietekenreeks .NET Framework jaarnummer 1 opmaakt in 元. Deze updates zijn beschikbaar op Windows Update, Windows Server Update Service (WSUS) en Windows Update Catalog.

Microsoft heeft in mei 2019 een .NET Framework-beveiligings- en kwaliteitsrollup uitgebracht voor Windows 8.1 en eerdere ondersteunde versies van Windows, zoals hieronder. Alle beveiligings- en kwaliteitspakketten die later voor deze updates worden uitgebracht, bevatten ook japanse tijdperkupdates.

Wijzigingen voor klanten die alleen beveiligingsupdates bijwerken

Deze sectie is bedoeld voor klanten die afhankelijk zijn van de updates voor alleen beveiliging (SO) voor Windows 8.1 en eerdere versies van ondersteunde Windows.

Vergelijkbaar met de .NET Framework updates voor Windows 10 die worden vermeld in de vorige sectie, bevatten de updates die in de volgende tabel worden vermeld alle japanse tijdperkupdates voor .NET Framework die al zijn opgenomen in eerder uitgebrachte updates en een nieuwe kwaliteitsupdate om de afhankelijkheid te verwijderen van het gebruik van enkele aanhalingstekens om het Gannen-teken uit te voeren in japanse tijdperkopmaak.

Deze updates bevatten geen nieuwe beveiligingsupdates of nieuwe aanvullende kwaliteits- en betrouwbaarheidsverbeteringen die nog niet zijn opgenomen in eerder uitgebrachte updates, met uitzondering van de update voor het probleem met één aanhalingsteken. Daarom kunnen gebruikers die afhankelijk zijn van de updates voor alleen beveiliging (SO) en het maandelijkse updatepakket (MO) voor Windows 8.1 en eerdere ondersteunde versies van Windows deze updates ook selecteren voor het nieuwe Japanse tijdperk. Deze updates zijn alleen beschikbaar via Windows Server Update Service (WSUS) en Windows Update Catalogus.

Test het nieuwe Japanse tijdperk op .NET Framework

Voor alle versies van .NET Framework in de knowledge base-artikelentabel en ook voor .NET Core die wordt uitgevoerd op Windows, wordt informatie over het kalendertijdperk verstrekt door het Windows-besturingssysteem en opgehaald uit het systeemregister wanneer u de updates voor .NET Framework toepast. Om het voor u gemakkelijker te maken om u voor te bereiden op de wijziging van het Japanse tijdperk, kunt u bepalen wanneer u de vermelding van de tijdelijke aanduiding voor het register toevoegt aan uw systemen en de timing kiezen die aan uw behoeften voldoet. Momenteel wordt het tijdelijke register voor het Windows-besturingssysteem ondersteund voor de volgende systemen:

• Windows-client: Windows 7 SP1 en hoger
• Windows Server: Windows Server 2008 R2 SP1 en hoger

Een update van Windows voegt de waarde van het nieuwe tijdperk toe aan het register nadat de naam van het tijdperk en de verkorte naam van het tijdperk bekend zijn. .NET in Windows weerspiegelt deze update automatisch.

Aanbevolen testscenario's om te behandelen

• Controle van het bereik van het tijdperk is versoepeld

  Dit testscenario is om te controleren of LOB-toepassingen werken wanneer de overgang naar een nieuw tijdperk is ingesteld op een toekomstige datum.

  Een datum in een bepaald tijdperk kan 'overlopen' naar het volgende tijdperk en standaard geen ArgumentOutOfRangeException of FormatException wordt gegenereerd. Wanneer u de waarde van Switch.System.Globalization.EnforceJapaneseEraYearRanges instelt op true, kunt u strikte tijdperkcontroles herstellen.

• Het eerste jaar van een tijdperk

  Dit testscenario is om de Gannen -conventie (元年) bij het opmaken van bewerkingen te verifiëren als het eerste jaar van een nieuw Japans kalendertijdperk.

  Standaard gebruikt .NET de Gannen-conventie (元年) voor opmaakbewerkingen. U kunt het vorige gedrag herstellen. Dit gedrag vertegenwoordigt het jaar altijd als '1' in plaats van als Gannen (元年). Stel hiervoor de volgende waarde in op true:

  Switch.System.Globalization.FormatJapaneseFirstYearAsANumber

Ondersteunde functies uit het Japanse tijdperk

• Gegevensbron bijwerken

  Japanse tijdperkinformatie werd oorspronkelijk onderhouden als in code vastgelegde gegevens in .NET Framework 3.5 en lagere versies van .NET Framework, maar vergelijkbaar met .NET Framework 4.0 en later, werd de bron voor het Japanse tijdperk gewijzigd van persoonlijke, in code vastgelegde gegevens in de registersleutel onder HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Nls\Calendars\Japanese\Eras registerpad. De update voor Windows voegt de registersleutel voor het nieuwe tijdperk toe nadat de naam is aangekondigd.

• Bereik-Ontspanning

  Wanneer Heisei (平成) Era eindigt op 30 april 2019, wat Heisei (平成) 31 is, en het nieuwe tijdperk begint op 1 mei 2019, ::no-loc text=""平成 31 年 5 月 1 日""::: wordt ongeldig. We hebben onze parsers versoepeld om toe te staan dat de toekomstige of eerdere datums (zowel Gregoriaanse als Japanse datums) in .NET-toepassingen kunnen worden geconverteerd naar een relevante Datum van het Japanse tijdperk zonder een uitzondering te genereren, zoals ArgumentOutOfRangeException en System.FormatException. U kunt ook de toekomstige datums in Heisei converteren naar het nieuwe Japanse tijdperk zodra de naam van het nieuwe Japanse tijdperk is aangekondigd. Deze kan worden uitgeschakeld in .NET Framework. Door de waarde van Switch.System.Globalization.EnforceJapaneseEraYearRanges in te stellen op true.

• Gannen (元年Japans: Gannen) voor het eerste jaar van de Japanse tijdrekening

  In de historische praktijk wordt voor het eerste jaar van het tijdperk een speciaal teken "Gan (元)", waarvan het Kanji-teken "oorsprong" of "begin" betekent, gebruikt in plaats van het getal "Ichi (1)". Het eerste jaar "Gannen (元年)" gaat door tot de einddatum van het Gregoriaanse kalenderjaar, 31 december. .NET Framework ondersteunt zowel "Gannen (元年)" als "Ichinen (1 年)" voor het eerste jaar van het tijdperk. Voor alle versies van .NET Framework is Gannen standaard INGESCHAKELD. Dit kan worden uitgeschakeld door de waarde van Switch.System.Globalization.FormatJapaneseFirstYearAsANumber in te stellen op true.

Eerder uitgebrachte updates

Klanten hoeven alleen de meest recente update te installeren die hierboven in de Knowledge Base-artikelen wordt vermeld op .NET Framework versie voor japanse tijdperkupdates of die van Windows Update, Windows Server Update Service (WSUS) of Windows Update Catalog.

Aanvullende bronnen

• Een nieuw tijdperk in de Japanse agenda verwerken in .NET - .NET Blog
• Het register gebruiken om het nieuwe Japanse tijdperk in Windows te testen - blog van augustus 2018
• Gannen vs Ichinen - blog van november 2018