WebException コンストラクタ (String, WebExceptionStatus)

WebException クラスの新しいインスタンスを、指定したエラー メッセージとステータスを使用して初期化します。

名前空間: System.Net
アセンブリ: System (system.dll 内)

構文

'宣言
Public Sub New ( _
    message As String, _
    status As WebExceptionStatus _
)
'使用
Dim message As String
Dim status As WebExceptionStatus

Dim instance As New WebException(message, status)

public WebException (
    string message,
    WebExceptionStatus status
)

public:
WebException (
    String^ message, 
    WebExceptionStatus status
)

public WebException (
    String message, 
    WebExceptionStatus status
)

public function WebException (
    message : String, 
    status : WebExceptionStatus
)

パラメータ

• message
  エラー メッセージのテキスト。

• status
  WebExceptionStatus 値の 1 つ。

解説

WebException インスタンスは、Message プロパティを message の値に設定し、Status プロパティを status の値に設定して初期化されます。message が null 参照 (Visual Basic では Nothing) の場合、Message プロパティはシステム提供のメッセージに初期化されます。InnerException プロパティおよび Response プロパティは null 参照 (Visual Basic では Nothing) に初期化されています。

使用例

エラー メッセージおよび WebExceptionStatus を指定して、WebException をスローする例を次に示します。

Try
    ' A 'Socket' object has been created.
    Dim httpSocket As New Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp)
    
    ' The IPaddress of the unknown uri is resolved using the 'Dns.Resolve' method. 
     
    Dim hostEntry As IPHostEntry = Dns.Resolve(connectUri)
    
    Dim serverAddress As IPAddress = hostEntry.AddressList(0)
    Dim endPoint As New IPEndPoint(serverAddress, 80)
    httpSocket.Connect(endPoint)
    Console.WriteLine("Connection created successfully")
    httpSocket.Close()
Catch e As SocketException
    Console.WriteLine((ControlChars.Cr + "Exception thrown." + ControlChars.Cr + "The Original Message is: " + e.Message))
    ' Throw the 'WebException' object with a message string and message status specific to the situation.
    Throw New WebException("Unable to locate the Server with 'www.contoso.com' Uri.", WebExceptionStatus.NameResolutionFailure)
End Try

 try
{
       // A 'Socket' object has been created.
       Socket httpSocket = new Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp);

      // The IPaddress of the unknown uri is resolved using the 'Dns.Resolve' method. 
  
      IPHostEntry hostEntry = Dns.Resolve("https://www.contoso.com");

      IPAddress serverAddress = hostEntry.AddressList[0];
      IPEndPoint endPoint = new IPEndPoint(serverAddress, 80);
       httpSocket.Connect(endPoint);
      Console.WriteLine("Connection created successfully");
      httpSocket.Close();

   }
catch(SocketException e)
  {
      Console.WriteLine("\nException thrown.\nThe Original Message is: "+e.Message);
      // Throw the 'WebException' object with a message string and message status specific to the situation.
      throw new WebException("Unable to locate the Server with 'www.contoso.com' Uri.",WebExceptionStatus.NameResolutionFailure);
  }

try
{
   // A 'Socket' object has been created.
   Socket^ httpSocket = gcnew Socket( AddressFamily::InterNetwork, SocketType::Stream, ProtocolType::Tcp );
   
   // The IPaddress of the unknown uri is resolved using the 'Dns::Resolve' method.

   IPHostEntry^ hostEntry = Dns::Resolve( "https://www.contoso.com" );

   IPAddress^ serverAddress = hostEntry->AddressList[ 0 ];
   IPEndPoint^ endPoint = gcnew IPEndPoint( serverAddress, 80 );
   httpSocket->Connect( endPoint );
   Console::WriteLine( "Connection created successfully" );
   httpSocket->Close();
}
catch ( SocketException^ e ) 
{
   Console::WriteLine( "\nException thrown.\nThe Original Message is: {0}", e->Message );
   // Throw the 'WebException' object with a message string and message status specific to the situation.
   throw gcnew WebException( "Unable to locate the Server with 'www.contoso.com' Uri.", WebExceptionStatus::NameResolutionFailure );
}

try {
    // A 'Socket' object has been created.
    Socket httpSocket = new Socket(AddressFamily.InterNetwork,
        SocketType.Stream, ProtocolType.Tcp);
    // The IPaddress of the unknown uri is resolved using the
    // 'Dns.Resolve' method. 
    IPHostEntry hostEntry = Dns.Resolve("https://www.contoso.com");

    IPAddress serverAddress = (IPAddress)hostEntry.get_AddressList().
        get_Item(0);
    IPEndPoint endPoint = new IPEndPoint(serverAddress, 80);
    httpSocket.Connect(endPoint);
    Console.WriteLine("Connection created successfully");
    httpSocket.Close();
}
catch (SocketException e) {
    Console.WriteLine("\nException thrown.\nThe Original Message is: " 
        + e.get_Message());
    // Throw the 'WebException' object with a message string and message
    // status specific to the situation.
    throw new WebException("Unable to locate the Server with" 
        + " 'www.contoso.com' Uri.", WebExceptionStatus.
        NameResolutionFailure);
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework

サポート対象 : 2.0、1.1、1.0

.NET Compact Framework

サポート対象 : 2.0、1.0

参照

関連項目

WebException クラス
WebException メンバ
System.Net 名前空間