WebException コンストラクタ (String)

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

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

構文

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

Dim instance As New WebException(message)

public WebException (
    string message
)

public:
WebException (
    String^ message
)

public WebException (
    String message
)

public function WebException (
    message : String
)

パラメータ

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

解説

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

使用例

エラー メッセージを指定することによって 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 specific to the situation.
    Throw New WebException("Unable to locate the Server with 'www.contoso.com' Uri.")
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(connectUri);

     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 specific to the situation.
     throw new WebException("Unable to locate the Server with 'www.contoso.com' Uri.");
  }

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

   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 specific to the situation.
   throw gcnew WebException( "Unable to locate the Server with 'www.contoso.com' Uri." );
}

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(connectUri);
    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 
    // specific to the situation.
    throw new WebException("Unable to locate the Server with" 
        + " 'www.contoso.com' Uri.");
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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 名前空間
Exception