TimeZoneNotFoundException Construtores

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Inicializa uma nova instância da classe TimeZoneNotFoundException.

Sobrecargas

TimeZoneNotFoundException()	Inicializa uma nova instância da classe TimeZoneNotFoundException com uma mensagem fornecida pelo sistema.
TimeZoneNotFoundException(String)	Inicializa uma nova instância da classe TimeZoneNotFoundException com a cadeia de caracteres de mensagem especificada.
TimeZoneNotFoundException(SerializationInfo, StreamingContext)	Obsoleto. Inicializa uma nova instância da classe TimeZoneNotFoundException com base nos dados serializados.
TimeZoneNotFoundException(String, Exception)	Inicializa uma nova instância da classe TimeZoneNotFoundException com uma mensagem de erro especificada e uma referência à exceção interna que é a causa da exceção.

TimeZoneNotFoundException()

Origem:

TimeZoneNotFoundException.cs

Inicializa uma nova instância da classe TimeZoneNotFoundException com uma mensagem fornecida pelo sistema.

public:
 TimeZoneNotFoundException();

public TimeZoneNotFoundException ();

Public Sub New ()

Comentários

Esse é o construtor sem parâmetros da TimeZoneNotFoundException classe . Esse construtor inicializa a Message propriedade da nova instância para uma mensagem fornecida pelo sistema que descreve o erro, como "O fuso horário 'timeZoneName' não foi encontrado no computador local". Essa mensagem é localizada para a cultura atual do sistema.

TimeZoneNotFoundException(String)

Origem:

TimeZoneNotFoundException.cs

Inicializa uma nova instância da classe TimeZoneNotFoundException com a cadeia de caracteres de mensagem especificada.

public:
 TimeZoneNotFoundException(System::String ^ message);

public TimeZoneNotFoundException (string? message);

new TimeZoneNotFoundException : string -> TimeZoneNotFoundException

Public Sub New (message As String)

Parâmetros

message

String

Uma cadeia de caracteres que descreve a exceção.

Comentários

A message cadeia de caracteres é atribuída à Message propriedade . A cadeia de caracteres deve ser localizada para a cultura atual.

TimeZoneNotFoundException(SerializationInfo, StreamingContext)

Origem:

TimeZoneNotFoundException.cs

Cuidado

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

Inicializa uma nova instância da classe TimeZoneNotFoundException com base nos dados serializados.

protected:
 TimeZoneNotFoundException(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);

[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected TimeZoneNotFoundException (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new TimeZoneNotFoundException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> TimeZoneNotFoundException

Protected Sub New (info As SerializationInfo, context As StreamingContext)

Parâmetros

info

SerializationInfo

O objeto que contém os dados serializados.

context

StreamingContext

O fluxo que contém os dados serializados.

Atributos

ObsoleteAttribute

Exceções

ArgumentNullException

O parâmetro info é null.

- ou -

O parâmetro context é null.

Comentários

Esse construtor não é chamado diretamente pelo código para instanciar o TimeZoneNotFoundException objeto. Em vez disso, ele é chamado pelo IFormatter método do Deserialize objeto ao desserializar o TimeZoneNotFoundException objeto de um fluxo.

TimeZoneNotFoundException(String, Exception)

Origem:

TimeZoneNotFoundException.cs

Inicializa uma nova instância da classe TimeZoneNotFoundException com uma mensagem de erro especificada e uma referência à exceção interna que é a causa da exceção.

public:
 TimeZoneNotFoundException(System::String ^ message, Exception ^ innerException);

public TimeZoneNotFoundException (string? message, Exception? innerException);

new TimeZoneNotFoundException : string * Exception -> TimeZoneNotFoundException

Public Sub New (message As String, innerException As Exception)

Parâmetros

message

String

Uma cadeia de caracteres que descreve a exceção.

innerException

Exception

A exceção que é a causa da exceção atual.

Exemplos

O exemplo a seguir tenta recuperar um fuso horário inexistente, que lança um TimeZoneNotFoundException. O manipulador de exceção encapsula a exceção em um novo TimeZoneNotFoundException objeto, que o manipulador de exceção retorna ao chamador. Em seguida, o manipulador de exceção do chamador exibe informações sobre a exceção externa e interna.

private void HandleInnerException()
{   
   string timeZoneName = "Any Standard Time";
   TimeZoneInfo tz;
   try
   {
      tz = RetrieveTimeZone(timeZoneName);
      Console.WriteLine("The time zone display name is {0}.", tz.DisplayName);
   }
   catch (TimeZoneNotFoundException e)
   {
      Console.WriteLine("{0} thrown by application", e.GetType().Name);
      Console.WriteLine("   Message: {0}", e.Message);
      if (e.InnerException != null)
      {
         Console.WriteLine("   Inner Exception Information:");
         Exception innerEx = e.InnerException;
         while (innerEx != null)
         {
            Console.WriteLine("      {0}: {1}", innerEx.GetType().Name, innerEx.Message);
            innerEx = innerEx.InnerException;
         }
      }            
   }   
}

private TimeZoneInfo RetrieveTimeZone(string tzName)
{
   try
   {
      return TimeZoneInfo.FindSystemTimeZoneById(tzName);
   }   
   catch (TimeZoneNotFoundException ex1)
   {
      throw new TimeZoneNotFoundException( 
            String.Format("The time zone '{0}' cannot be found.", tzName), 
            ex1);
   }          
   catch (InvalidTimeZoneException ex2)
   {
      throw new InvalidTimeZoneException( 
            String.Format("The time zone {0} contains invalid data.", tzName), 
            ex2); 
   }      
}

open System

let retrieveTimeZone tzName =
    try
        TimeZoneInfo.FindSystemTimeZoneById tzName
    with 
    | :? TimeZoneNotFoundException as ex1 ->
        raise (TimeZoneNotFoundException($"The time zone '{tzName}' cannot be found.", ex1) )
    | :? InvalidTimeZoneException as ex2 ->
        raise (InvalidTimeZoneException($"The time zone {tzName} contains invalid data.", ex2) )

let handleInnerException () =
    let timeZoneName = "Any Standard Time"
    try
        let tz = retrieveTimeZone timeZoneName
        printfn $"The time zone display name is {tz.DisplayName}."
    with :? TimeZoneNotFoundException as e ->
        printfn $"{e.GetType().Name} thrown by application"
        printfn $"   Message: {e.Message}" 
        if e.InnerException <> null then
            printfn "   Inner Exception Information:"
            let rec printInner (innerEx: exn) =
                if innerEx <> null then
                    printfn $"      {innerEx.GetType().Name}: {innerEx.Message}"
                    printInner innerEx.InnerException
            printInner e

Private Sub HandleInnerException()
   Dim timeZoneName As String = "Any Standard Time"
   Dim tz As TimeZoneInfo
   Try
      tz = RetrieveTimeZone(timeZoneName)
      Console.WriteLine("The time zone display name is {0}.", tz.DisplayName)
   Catch e As TimeZoneNotFoundException
      Console.WriteLine("{0} thrown by application", e.GetType().Name)
      Console.WriteLine("   Message: {0}", e.Message)
      If e.InnerException IsNot Nothing Then
         Console.WriteLine("   Inner Exception Information:")
         Dim innerEx As Exception = e.InnerException
         Do
            Console.WriteLine("      {0}: {1}", innerEx.GetType().Name, innerEx.Message)
            innerEx = innerEx.InnerException
         Loop While innerEx IsNot Nothing
      End If            
   End Try   
End Sub

Private Function RetrieveTimeZone(tzName As String) As TimeZoneInfo
   Try
      Return TimeZoneInfo.FindSystemTimeZoneById(tzName)
   Catch ex1 As TimeZoneNotFoundException
      Throw New TimeZoneNotFoundException( _
            String.Format("The time zone '{0}' cannot be found.", tzName), _
            ex1) 
   Catch ex2 As InvalidTimeZoneException
      Throw New InvalidTimeZoneException( _
            String.Format("The time zone {0} contains invalid data.", tzName), _
            ex2) 
   End Try      
End Function

Comentários

Normalmente, você usa essa TimeZoneNotFoundException sobrecarga para lidar com uma exceção em um try...catch Bloco. O innerException parâmetro deve ser uma referência ao objeto de exceção manipulado no catch bloco ou pode ser null. Esse valor é atribuído à TimeZoneNotFoundException propriedade do InnerException objeto.

A message cadeia de caracteres é atribuída à Message propriedade . A cadeia de caracteres deve ser localizada para a cultura atual.