InvalidTimeZoneException Construtores

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Inicializa uma nova instância da classe InvalidTimeZoneException.

Sobrecargas

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

InvalidTimeZoneException()

Origem:

InvalidTimeZoneException.cs

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

public:
 InvalidTimeZoneException();

public InvalidTimeZoneException ();

Public Sub New ()

Comentários

Esse é o construtor sem parâmetros da InvalidTimeZoneException classe . Ele inicializa a Message propriedade da nova instância para uma mensagem fornecida pelo sistema que descreve o erro, como "Exceção do tipo 'System.InvalidTimeZoneException' foi gerada.". Essa mensagem é localizada para a cultura atual do sistema.

InvalidTimeZoneException(String)

Origem:

InvalidTimeZoneException.cs

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

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

public InvalidTimeZoneException (string? message);

new InvalidTimeZoneException : string -> InvalidTimeZoneException

Public Sub New (message As String)

Parâmetros

message

String

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

Comentários

A cadeia de caracteres fornecida como o message parâmetro é atribuída à Message propriedade . Ele deve ser localizado para a cultura atual.

InvalidTimeZoneException(SerializationInfo, StreamingContext)

Origem:

InvalidTimeZoneException.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 InvalidTimeZoneException com base nos dados serializados.

protected:
 InvalidTimeZoneException(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 InvalidTimeZoneException (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 InvalidTimeZoneException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> InvalidTimeZoneException

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 InvalidTimeZoneException objeto. Em vez disso, ele é chamado pelo IFormatter método do Deserialize objeto ao desserializar o InvalidTimeZoneException objeto de um fluxo.

InvalidTimeZoneException(String, Exception)

Origem:

InvalidTimeZoneException.cs

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

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

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

new InvalidTimeZoneException : string * Exception -> InvalidTimeZoneException

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 código a seguir tenta recuperar um TimeZoneInfo objeto que representa o fuso horário padrão central. Se ocorrer um InvalidTimeZoneException na chamada de RetrieveTimeZone método, o manipulador de exceção encapsulará a exceção em um novo InvalidTimeZoneException objeto, que retornará ao chamador. Em seguida, o manipulador de exceção do chamador exibe informações sobre as exceções externas e internas.

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); 
   }      
}

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 sobrecarga da InvalidTimeZoneException classe 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 à InvalidTimeZoneException propriedade do InnerException objeto.

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