Resumo das novas atualizações da era japonesa para .NET Framework

Este artigo apresenta as novas atualizações da era japonesa para .NET Framework.

Versão original do produto: .NET Framework versões 3.5 e posteriores
Número de KB original: 4477957

Resumo

Em 1º de maio de 2019, a nova era no calendário japonês começará. A Microsoft está se preparando para essas alterações e planeja enviar atualizações em cada versão de roll-up mensal. Esta é a primeira transição de uma era para outra desde janeiro de 1989, e também a primeira na história da .NET Framework. Este artigo destina-se a ajudar os desenvolvedores a testar e verificar como as eras funcionam em aplicativos .NET, como os aplicativos são afetados pela alteração da era e o que você, como desenvolvedor, precisa fazer para garantir que seus aplicativos lidem com as alterações da próxima era japonesa com êxito.

Para obter mais informações sobre as atualizações do Windows para a alteração da era japonesa, consulte KB 4469068.

.NET Framework atualizações

As versões a seguir contêm as atualizações da era japonesa para .NET Framework. Eles também contêm melhorias de qualidade e confiabilidade.

• .NET Framework versão prévia de setembro de 2018 da rollup de qualidade
• .NET Framework rollup de segurança e qualidade de novembro de 2018
• .NET Framework rollup de segurança e qualidade de dezembro de 2018
• atualização de março de 2019 .NET Framework
• .NET Framework rollup de segurança e qualidade de maio de 2019

Artigos da base de dados de conhecimento por .NET Framework versão para atualizações da era japonesa

As atualizações de manutenção listadas na tabela a seguir contêm todas as atualizações da era japonesa para .NET Framework que já foram incluídas nas atualizações lançadas anteriormente. As atualizações de manutenção também contêm uma nova atualização de qualidade que remove a dependência de aspas individuais para gerar o caractere Gannen na formatação de era japonesa, de modo que ou "y年""y'年'" da cadeia de caracteres de formato de data e hora personalizadas habilite .NET Framework formatar o ano número 1 para 元. Essas atualizações estão disponíveis em Windows Update, WSUS (Serviço de Atualização do Windows Server) e Windows Update Catálogo.

A Microsoft lançou um rollup de segurança e qualidade do .NET framework para versões com suporte Windows 8.1 e anteriores do Windows em maio de 2019, conforme abaixo. Todas as roll-ups de segurança e qualidade liberadas posteriormente para essas atualizações também conterão atualizações da era japonesa.

Alterações para clientes de atualização somente de segurança

Esta seção é para clientes que dependem das atualizações de SO (Somente Segurança) para versões Windows 8.1 e anteriores do Windows com suporte.

Semelhantes às atualizações de .NET Framework para Windows 10 listadas na seção anterior, as atualizações listadas na tabela a seguir contêm todas as atualizações da era japonesa para .NET Framework que já foram incluídas em atualizações lançadas anteriormente e uma nova atualização de qualidade para remover a dependência de usar aspas individuais para gerar o caractere Gannen na formatação da era japonesa.

Essas atualizações não incluem novas atualizações de segurança ou novas melhorias adicionais de qualidade e confiabilidade que ainda não foram incluídas em atualizações lançadas anteriormente, exceto a atualização para o problema da marca de cotação única. Portanto, os usuários que dependem das atualizações de SO (Somente Segurança) e das atualizações de MO (Rollup Mensal) para versões com suporte Windows 8.1 e anteriores do Windows também podem selecionar essas atualizações para a nova era japonesa. Essas atualizações estão disponíveis apenas por meio do WSUS (Serviço de Atualização do Windows Server) e Windows Update Catálogo.

Testar a nova era japonesa em .NET Framework

Para todas as versões do .NET Framework na tabela de artigos da Base de Dados de Conhecimento e também para o .NET Core em execução no Windows, as informações da era do calendário são fornecidas pelo sistema operacional Windows e recuperadas do registro do sistema quando você aplica as atualizações para .NET Framework. Para facilitar a preparação para a alteração da era japonesa, você pode controlar quando adicionar a entrada do registro de espaço reservado aos seus sistemas e escolher o tempo que atende às suas necessidades. Atualmente, o registro de espaço reservado para o sistema operacional Windows tem suporte para os seguintes sistemas:

• Cliente Windows: Windows 7 SP1 e posterior
• Windows Server: Windows Server 2008 R2 SP1 e posterior

Uma atualização para o Windows adicionará o novo valor de era ao registro depois que o nome da era e o nome da era abreviado forem conhecidos. O .NET no Windows refletirá automaticamente essa atualização.

Cenários de teste recomendados para cobrir

• Verificações de intervalo de era relaxadas

  Esse cenário de teste é verificar se os aplicativos LOB funcionam quando a nova transição de era é definida como uma data futura.

  Uma data em uma determinada era pode "transbordar" para a era a seguir e não ArgumentOutOfRangeException ou FormatException é lançada por padrão. Quando você define o valor de Switch.System.Globalization.EnforceJapaneseEraYearRanges como true, você pode restaurar verificações de era estritas.

• O primeiro ano de uma era

  Esse cenário de teste é verificar a convenção gannen (元年) em operações de formatação como o primeiro ano de uma nova era do calendário japonês.

  Por padrão, o .NET adota a convenção Gannen (元年) em operações de formatação. Você pode restaurar o comportamento anterior. Esse comportamento sempre representa o ano como "1" em vez de como Gannen (元年). Para fazer isso, defina o seguinte valor como true:

  Switch.System.Globalization.FormatJapaneseFirstYearAsANumber

Recursos compatíveis com a era japonesa

• Atualização da fonte de dados

  As informações da era japonesa foram originalmente mantidas como dados codificados em .NET Framework versões 3.5 e inferiores de .NET Framework, no entanto, da mesma forma que .NET Framework 4.0 e posterior, sua fonte para a era japonesa foi alterada de dados codificados em código privado para a chave do registro no HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Nls\Calendars\Japanese\Eras caminho do registro. A atualização para Windows adicionará a chave do registro para a nova era depois que seu nome for anunciado.

• Intervalo-relaxamento

  Quando Heisei (平成) Era termina em 30 de abril, 2019, que é Heisei (平成) 31, e a nova era começa em 1º de maio de 2019, :::no-loc text=""平成 31 年 5 月 1 日"::: torna-se inválido. Relaxamos nossos analisadores para permitir que as datas futuras ou passadas (datas gregorianas e japonesas) em aplicativos .NET, sejam convertidas em uma data relevante da era japonesa sem gerar uma exceção como ArgumentOutOfRangeException e System.FormatException. Você também poderá converter as datas futuras em Heisei para a nova era japonesa assim que o novo nome da era japonesa for anunciado. Ele pode ser desabilitado no .NET Framework. Definindo o valor de Switch.System.Globalization.EnforceJapaneseEraYearRanges como true.

• Gannen (元年) para o primeiro ano da era japonesa

  Na prática histórica, para o primeiro ano da época, um personagem especial "Gan (元)", cujo caractere Kanji significa "origem" ou "início", é usado no lugar do número "Ichi (1)". O primeiro ano "Gannen (元年)" continua até a data de término do ano civil gregoriano, 31 de dezembro. .NET Framework dá suporte a "Gannen (元年)" e "Ichinen (1 年)" para o primeiro ano da era. Para todas as versões do .NET Framework, o Gannen é ON por padrão. Ele pode ser desabilitado definindo o valor de Switch.System.Globalization.FormatJapaneseFirstYearAsANumber como true.

Atualizações lançadas anteriormente

Os clientes só precisam instalar a atualização mais recente listada acima nos artigos da Base de Dados de Conhecimento por .NET Framework versão para a seção atualizações da era japonesa ou aquelas de Windows Update, WSUS (Serviço de Atualização do Windows Server) ou catálogo de Windows Update.

Recursos adicionais

• Manipulando uma nova era no calendário japonês no .NET – Blog do .NET
• Usando o Registro para testar a nova era japonesa no Blog do Windows – agosto de 2018
• Gannen vs Ichinen - Blog de novembro de 2018