TimeZoneNotFoundException Constructors

Definition

Namespace:

System

Assemblies:

netstandard.dll, System.Runtime.dll

Initializes a new instance of the TimeZoneNotFoundException class.

Overloads

TimeZoneNotFoundException()	Initializes a new instance of the TimeZoneNotFoundException class with a system-supplied message.
TimeZoneNotFoundException(String)	Initializes a new instance of the TimeZoneNotFoundException class with the specified message string.
TimeZoneNotFoundException(SerializationInfo, StreamingContext)	Obsolete. Initializes a new instance of the TimeZoneNotFoundException class from serialized data.
TimeZoneNotFoundException(String, Exception)	Initializes a new instance of the TimeZoneNotFoundException class with a specified error message and a reference to the inner exception that is the cause of this exception.

TimeZoneNotFoundException()

Source:

TimeZoneNotFoundException.cs

Initializes a new instance of the TimeZoneNotFoundException class with a system-supplied message.

C#

public TimeZoneNotFoundException();

Remarks

This is the parameterless constructor of the TimeZoneNotFoundException class. This constructor initializes the Message property of the new instance to a system-supplied message that describes the error, such as "The time zone 'timeZoneName' was not found on the local computer." This message is localized for the current system culture.

TimeZoneNotFoundException(String)

Source:

TimeZoneNotFoundException.cs

Initializes a new instance of the TimeZoneNotFoundException class with the specified message string.

C#

public TimeZoneNotFoundException(string? message);

Parameters

message

String

A string that describes the exception.

Remarks

The message string is assigned to the Message property. The string should be localized for the current culture.

TimeZoneNotFoundException(SerializationInfo, StreamingContext)

Source:

TimeZoneNotFoundException.cs

Caution

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

Initializes a new instance of the TimeZoneNotFoundException class from serialized data.

C#

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

Parameters

info

SerializationInfo

The object that contains the serialized data.

context

StreamingContext

The stream that contains the serialized data.

Attributes

ObsoleteAttribute

Exceptions

ArgumentNullException

The info parameter is null.

-or-

The context parameter is null.

Remarks

This constructor is not called directly by your code to instantiate the TimeZoneNotFoundException object. Instead, it is called by the IFormatter object's Deserialize method when deserializing the TimeZoneNotFoundException object from a stream.

TimeZoneNotFoundException(String, Exception)

Source:

TimeZoneNotFoundException.cs

Initializes a new instance of the TimeZoneNotFoundException class with a specified error message and a reference to the inner exception that is the cause of this exception.

C#

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

Parameters

message

String

A string that describes the exception.

innerException

Exception

The exception that is the cause of the current exception.

Examples

The following example tries to retrieve a nonexistent time zone, which throws a TimeZoneNotFoundException. The exception handler wraps the exception in a new TimeZoneNotFoundException object, which the exception handler returns to the caller. The caller's exception handler then displays information about both the outer and inner exception.

C#

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

Remarks

Typically, you use this TimeZoneNotFoundException overload to handle an exception in a try…catch block. The innerException parameter should be a reference to the exception object handled in the catch block, or it can be null. This value is then assigned to the TimeZoneNotFoundException object's InnerException property.

The message string is assigned to the Message property. The string should be localized for the current culture.