InvalidTimeZoneException 建構函式

參考

定義

命名空間:: System

組件:: System.Runtime.dll

組件:: System.Core.dll

組件:: mscorlib.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

初始化 InvalidTimeZoneException 類別的新執行個體。

多載

InvalidTimeZoneException()	使用系統提供的錯誤，初始化 InvalidTimeZoneException 類別的新執行個體。
InvalidTimeZoneException(String)	使用指定的訊息字串，初始化 InvalidTimeZoneException 類別的新執行個體。
InvalidTimeZoneException(SerializationInfo, StreamingContext)	已淘汰. 從序列化資料中，初始化 InvalidTimeZoneException 類別的新執行個體。
InvalidTimeZoneException(String, Exception)	使用指定的錯誤訊息以及造成此例外狀況的內部例外狀況的參考，初始化 InvalidTimeZoneException 類別的新執行個體。

InvalidTimeZoneException()

來源:: InvalidTimeZoneException.cs

來源:: InvalidTimeZoneException.cs

來源:: InvalidTimeZoneException.cs

使用系統提供的錯誤，初始化 InvalidTimeZoneException 類別的新執行個體。

public:
 InvalidTimeZoneException();

public InvalidTimeZoneException ();

Public Sub New ()

備註

這是類別的 InvalidTimeZoneException 無參數建構函式。它會將新實例的屬性初始化 Message 為描述錯誤的系統提供訊息，例如「擲回 'System.InvalidTimeZoneException' 類型的例外狀況」。此訊息已針對目前的系統文化特性進行當地語系化。

適用於

InvalidTimeZoneException(String)

來源:: InvalidTimeZoneException.cs

來源:: InvalidTimeZoneException.cs

來源:: InvalidTimeZoneException.cs

使用指定的訊息字串，初始化 InvalidTimeZoneException 類別的新執行個體。

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

public InvalidTimeZoneException (string message);

public InvalidTimeZoneException (string? message);

new InvalidTimeZoneException : string -> InvalidTimeZoneException

Public Sub New (message As String)

參數

message: String

描述例外狀況的字串。

備註

提供做為參數的 message 字串會指派給 Message 屬性。它應該針對目前的文化特性進行當地語系化。

適用於

InvalidTimeZoneException(SerializationInfo, StreamingContext)

來源:: InvalidTimeZoneException.cs

來源:: InvalidTimeZoneException.cs

來源:: InvalidTimeZoneException.cs

警告

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

從序列化資料中，初始化 InvalidTimeZoneException 類別的新執行個體。

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

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

new InvalidTimeZoneException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> InvalidTimeZoneException

[<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)

參數

info: SerializationInfo

包含已序列化資料的物件。

context: StreamingContext

包含已序列化資料的資料流。

屬性: ObsoleteAttribute

例外狀況

ArgumentNullException

info 參數為 null。

-或-

context 參數為 null。

備註

您的程式碼不會直接呼叫這個建構函式來具現化 InvalidTimeZoneException 物件。相反地，從資料流程還原序列化 InvalidTimeZoneException 物件時，由物件的 Deserialize 方法呼叫 IFormatter 。

適用於

InvalidTimeZoneException(String, Exception)

來源:: InvalidTimeZoneException.cs

來源:: InvalidTimeZoneException.cs

來源:: InvalidTimeZoneException.cs

使用指定的錯誤訊息以及造成此例外狀況的內部例外狀況的參考，初始化 InvalidTimeZoneException 類別的新執行個體。

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

public InvalidTimeZoneException (string message, Exception innerException);

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

new InvalidTimeZoneException : string * Exception -> InvalidTimeZoneException

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

參數

message: String

描述例外狀況的字串。

innerException: Exception

做為目前例外狀況發生原因的例外狀況。

範例

下列程式碼會嘗試擷取 TimeZoneInfo 代表中央標準時區的物件。 InvalidTimeZoneException如果在方法呼叫中 RetrieveTimeZone 發生，例外狀況處理常式會將例外狀況包裝在新的 InvalidTimeZoneException 物件中，而該物件會傳回給呼叫端。呼叫端的例外狀況處理常式接著會顯示外部和內部例外狀況的相關資訊。

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

備註

一般而言，您會使用類別的 InvalidTimeZoneException 這個多載來處理 ... 中的 try 例外狀況catch 塊。參數 innerException 應該是區塊中 catch 處理之例外狀況物件的參考，或者可以是 null 。這個值接著會指派給 InvalidTimeZoneException 物件的 InnerException 屬性。

字串 message 會指派給 Message 屬性。字串應當地語系化為目前文化特性。

適用於