WebExceptionとは？ わかりやすく解説

.NET Framework クラス ライブラリ リファレンス
索引トップ 用語の索引 ランキング
日本マイクロソフト株式会社日本マイクロソフト株式会社

WebException クラス

プラグ可能プロトコルによるネットワークへのアクセスでエラーが発生した場合にスローされる例外。

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

Visual Basic (宣言)
<SerializableAttribute> _
Public Class WebException
    Inherits InvalidOperationException
    Implements ISerializable
Visual Basic (使用法)
Dim instance As WebException
C#
[SerializableAttribute] 
public class WebException : InvalidOperationException,
 ISerializable
C++
[SerializableAttribute] 
public ref class WebException : public
 InvalidOperationException, ISerializable
J#
/** @attribute SerializableAttribute() */ 
public class WebException extends InvalidOperationException
 implements ISerializable
JScript
SerializableAttribute 
public class WebException extends
 InvalidOperationException implements ISerializable
解説解説

WebException クラスは、インターネットにアクセスするためのプラグ可能プロトコルを実装する WebRequest と WebResponse から派生したクラスによってスローされます。

WebException が WebRequest クラスの派生クラスによってスローされた場合、Response プロパティはアプリケーションにインターネットからの応答を提供します。

継承階層継承階層
System.Object
   System.Exception
     System.SystemException
       System.InvalidOperationException
        System.Net.WebException
スレッド セーフスレッド セーフ
この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。
プラットフォームプラットフォーム

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 メンバ
System.Net 名前空間
Exception

WebException コンストラクタ ()

WebException クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)
Public Sub New
Visual Basic (使用法)
Dim instance As New WebException
C#
public WebException ()
C++
public:
WebException ()
J#
public WebException ()
JScript
public function WebException ()
解説解説

既定のコンストラクタは、WebException クラスの新しいインスタンスを初期化します。Message プロパティは、エラーの原因について記述する、システム提供のメッセージに初期化されます。このメッセージは、システムの現在のカルチャを考慮して指定します。InnerException プロパティおよび Response プロパティは null 参照 (Visual Basic では Nothing) に初期化されています。Status プロパティは RequestCanceled に初期化されます。

使用例使用例

既定の WebException をスローする例を次に示します。

Visual Basic
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. 
     ' which leads to the 'SocketException' exception. 
    
    Dim hostEntry As IPHostEntry = Dns.Resolve("http://www.contoso.com")
    
    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
    Dim exp As [String] = e.Message
    ' Throw the WebException with no parameters.
    Throw New WebException()
End Try
C#
 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("http://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)
  {
     String exp = e.Message;    
     // Throw the WebException with no parameters.
     throw new WebException();
  }
C++
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( "http://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 ) 
{
   String^ exp = e->Message;
   // Throw the WebException with no parameters.
   throw gcnew WebException;
}
J#
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("http://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) {
    String exp = e.get_Message();
    // Throw the WebException with no parameters.
    throw new WebException();
}
プラットフォームプラットフォーム

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 名前空間

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

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

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

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

Dim instance As New WebException(message,
 status)
C#
public WebException (
    string message,
    WebExceptionStatus status
)
C++
public:
WebException (
    String^ message, 
    WebExceptionStatus status
)
J#
public WebException (
    String message, 
    WebExceptionStatus status
)
JScript
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 をスローする例を次に示します。

Visual Basic
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
C#
 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("http://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);
  }
C++
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( "http://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 );
}
J#
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("http://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 名前空間

WebException コンストラクタ (SerializationInfo, StreamingContext)

指定した SerializationInfo インスタンスと StreamingContext インスタンスから、WebException クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)
Protected Sub New ( _
    serializationInfo As SerializationInfo, _
    streamingContext As StreamingContext _
)
Visual Basic (使用法)
Dim serializationInfo As SerializationInfo
Dim streamingContext As StreamingContext

Dim instance As New WebException(serializationInfo,
 streamingContext)
C#
protected WebException (
    SerializationInfo serializationInfo,
    StreamingContext streamingContext
)
C++
protected:
WebException (
    SerializationInfo^ serializationInfo, 
    StreamingContext streamingContext
)
J#
protected WebException (
    SerializationInfo serializationInfo, 
    StreamingContext streamingContext
)
JScript
protected function WebException (
    serializationInfo : SerializationInfo, 
    streamingContext : StreamingContext
)

パラメータ

serializationInfo

新しい WebException をシリアル化するために必要な情報を格納する SerializationInfo。

streamingContext

新しい WebException に関連付けられているシリアル化ストリームの転送元を格納している StreamingContext。

解説解説

このコンストラクタは、WebException クラスの ISerializable インターフェイスを実装します。

プラットフォームプラットフォーム

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
参照参照
関連項目
WebException クラス
WebException メンバ
System.Net 名前空間
ISerializable

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

WebException クラスの新しいインスタンスを、指定したエラー メッセージ、入れ子になった例外、ステータス、および応答を使用して初期化します。

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

Visual Basic (宣言)
Public Sub New ( _
    message As String, _
    innerException As Exception, _
    status As WebExceptionStatus, _
    response As WebResponse _
)
Visual Basic (使用法)
Dim message As String
Dim innerException As Exception
Dim status As WebExceptionStatus
Dim response As WebResponse

Dim instance As New WebException(message,
 innerException, status, response)
C#
public WebException (
    string message,
    Exception innerException,
    WebExceptionStatus status,
    WebResponse response
)
C++
public:
WebException (
    String^ message, 
    Exception^ innerException, 
    WebExceptionStatus status, 
    WebResponse^ response
)
J#
public WebException (
    String message, 
    Exception innerException, 
    WebExceptionStatus status, 
    WebResponse response
)
JScript
public function WebException (
    message : String, 
    innerException : Exception, 
    status : WebExceptionStatus, 
    response : WebResponse
)

パラメータ

message

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

innerException

入れ子になった例外。

status

WebExceptionStatus 値の 1 つ。

response

リモート ホストからの応答を格納する WebResponse インスタンス。

解説解説

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

使用例使用例

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

Visual Basic
 
 ' Send the data. 
Dim ASCII As Encoding = Encoding.ASCII
Dim requestPage As String
 = "GET /nhjj.htm HTTP/1.1" + ControlChars.Lf + ControlChars.Cr
 + "Host: " + connectUri + ControlChars.Lf + ControlChars.Cr + "Connection: Close" + ControlChars.Lf
 + ControlChars.Cr + ControlChars.Lf + ControlChars.Cr
Dim byteGet As [Byte]() = ASCII.GetBytes(requestPage)
Dim recvBytes(256) As [Byte]

' Create an 'IPEndPoint' object.
Dim hostEntry As IPHostEntry = Dns.Resolve(connectUri)
Dim serverAddress As IPAddress = hostEntry.AddressList(0)
Dim endPoint As New IPEndPoint(serverAddress,
 80)

' Create a 'Socket' object  for sending data.
Dim connectSocket As New
 Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp)

' Connect to host using 'IPEndPoint' object.
connectSocket.Connect(endPoint)

' Sent the 'requestPage' text to the host.
connectSocket.Send(byteGet, byteGet.Length, 0)

' Receive the information sent by the server.
Dim bytesReceived As Int32 = connectSocket.Receive(recvBytes,
 recvBytes.Length, 0)
Dim headerString As [String] = ASCII.GetString(recvBytes,
 0, bytesReceived)
       
' Check whether 'status 404' is there or not in the information sent
 by server.
If headerString.IndexOf("404")
 <> False Then
    bytesReceived = connectSocket.Receive(recvBytes, recvBytes.Length, 0)
    Dim memoryStream As New
 MemoryStream(recvBytes)
    getStream = CType(memoryStream, Stream)
    
    ' Create a 'WebResponse' object.
    Dim myWebResponse As WebResponse = CType(New
 HttpConnect(getStream), WebResponse)
    Dim myException As New
 Exception("File Not found")
    
    ' Throw the 'WebException' object with a message string, message
 status,InnerException and WebResponse.
    Throw New WebException("The
 Requested page is not found.", myException, WebExceptionStatus.ProtocolError,
 myWebResponse)
End If 

connectSocket.Close()
C#
 // Send the data. 
 Encoding ASCII = Encoding.ASCII;
 string requestPage = "GET /nhjj.htm HTTP/1.1\r\nHost: "
 + connectUri + "\r\nConnection: Close\r\n\r\n";
 Byte[] byteGet = ASCII.GetBytes(requestPage);
 Byte[] recvBytes = new Byte[256];

 // Create an 'IPEndPoint' object.
        
 IPHostEntry hostEntry = Dns.Resolve(connectUri);
 IPAddress serverAddress = hostEntry.AddressList[0];
 IPEndPoint endPoint = new IPEndPoint(serverAddress, 80);
       
 // Create a 'Socket' object  for sending data.
 Socket connectSocket = new Socket(AddressFamily.InterNetwork,
 SocketType.Stream,ProtocolType.Tcp);
        
 // Connect to host using 'IPEndPoint' object.

 connectSocket.Connect(endPoint);
        
 // Sent the 'requestPage' text to the host.
 connectSocket.Send(byteGet, byteGet.Length, 0);
        
 // Receive the information sent by the server.
 Int32 bytesReceived = connectSocket.Receive(recvBytes, recvBytes.Length, 0);
 String headerString = ASCII.GetString(recvBytes, 0, bytesReceived);




// Check whether 'status 404' is there or not in the information sent
 by server.
if(headerString.IndexOf("404")!=-1)
{     
    bytesReceived = connectSocket.Receive(recvBytes, recvBytes.Length, 0);
    MemoryStream memoryStream = new MemoryStream(recvBytes);
    getStream = (Stream) memoryStream;
        
    // Create a 'WebResponse' object
    WebResponse myWebResponse = (WebResponse) new HttpConnect(getStream);
    Exception myException = new Exception("File Not found");

    // Throw the 'WebException' object with a message string, message
 status,InnerException and WebResponse
    throw new WebException("The Requested page is not found."
,myException,WebExceptionStatus.ProtocolError,myWebResponse);
 

}

connectSocket.Close();
C++
// Send the data.
Encoding^ ASCII = Encoding::ASCII;
String^ requestPage = String::Concat( "GET /nhjj.htm HTTP/1.1\r\nHost: ",
 connectUri, "\r\nConnection: Close\r\n\r\n" );
array<Byte>^ byteGet = ASCII->GetBytes( requestPage );
array<Byte>^ recvBytes = gcnew array<Byte>(256);

// Create an 'IPEndPoint' object.

IPHostEntry^ hostEntry = Dns::Resolve( connectUri );
IPAddress^ serverAddress = hostEntry->AddressList[ 0 ];
IPEndPoint^ endPoint = gcnew IPEndPoint( serverAddress,80 );

// Create a 'Socket' object  for sending data.
Socket^ connectSocket = gcnew Socket( AddressFamily::InterNetwork, SocketType::Stream,
 ProtocolType::Tcp );

// Connect to host using 'IPEndPoint' object.

connectSocket->Connect( endPoint );

// Sent the 'requestPage' text to the host.
connectSocket->Send( byteGet, byteGet->Length, (SocketFlags)(0) );

// Receive the information sent by the server.
Int32 bytesReceived = connectSocket->Receive( recvBytes, recvBytes->Length,
 (SocketFlags)(0) );
String^ headerString = ASCII->GetString( recvBytes, 0, bytesReceived );

// Check whether 'status 404' is there or not in the information sent
 by server.
if ( headerString->IndexOf( "404" ) != -1 )
{
   bytesReceived = connectSocket->Receive( recvBytes, recvBytes->Length, (SocketFlags)(0)
 );
   MemoryStream^ memoryStream = gcnew MemoryStream( recvBytes );
   getStream = (System::IO::Stream^)(memoryStream);
   
   // Create a 'WebResponse' object
   WebResponse^ myWebResponse = (WebResponse^)(gcnew HttpConnect( getStream ));
   Exception^ myException = gcnew Exception( "File Not found" );

   // Throw the 'WebException' object with a message string, message
 status, InnerException and WebResponse
   throw gcnew WebException( "The Requested page is not found.",myException,WebExceptionStatus::ProtocolError,myWebResponse
 );
}

connectSocket->Close();
J#
// Send the data. 
Encoding ascii = Encoding.get_ASCII();
String requestPage = "GET /nhjj.htm HTTP/1.1\r\nHost: " 
    + connectUri + "\r\nConnection: Close\r\n\r\n";
ubyte byteGet[] = ascii.GetBytes(requestPage);
ubyte recvBytes[] = new ubyte[256];
// Create an 'IPEndPoint' object.
IPHostEntry hostEntry = Dns.Resolve(connectUri);
IPAddress serverAddress = (IPAddress)hostEntry.get_AddressList().
    get_Item(0);
IPEndPoint endPoint = new IPEndPoint(serverAddress, 80);
// Create a 'Socket' object  for sending data.
Socket connectSocket = new Socket(AddressFamily.InterNetwork,
    SocketType.Stream, ProtocolType.Tcp);
// Connect to host using 'IPEndPoint' object.
connectSocket.Connect(endPoint);
// Sent the 'requestPage' text to the host.
connectSocket.Send(byteGet, byteGet.get_Length(), (SocketFlags)0);
// Receive the information sent by the server.
int bytesReceived = connectSocket.Receive(recvBytes,
    recvBytes.get_Length(), (SocketFlags)0);
String headerString = ascii.GetString(recvBytes, 0, bytesReceived);
// Check whether 'status 404' is there or not in the information
// sent by server.
if (headerString.IndexOf("404") != -1) {
    bytesReceived = connectSocket.Receive(recvBytes, recvBytes.
        get_Length(), (SocketFlags)0);
    MemoryStream memoryStream = new MemoryStream(recvBytes);
    getStream = (Stream)memoryStream;
    // Create a 'WebResponse' object
    WebResponse myWebResponse = (WebResponse)new HttpConnect(getStream);
    Exception myException = new Exception("File Not found");
    // Throw the 'WebException' object with a message string,
    // message status, InnerException and WebResponse
    throw new WebException("The Requested page is not found.",
 
        myException, WebExceptionStatus.ProtocolError, myWebResponse);
}
connectSocket.Close();
プラットフォームプラットフォーム

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 名前空間

WebException コンストラクタ

WebException クラスの新しいインスタンスを初期化します。
オーバーロードの一覧オーバーロードの一覧

名前 説明
WebException () WebException クラスの新しいインスタンスを初期化します。

.NET Compact Framework によってサポートされています。

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

.NET Compact Framework によってサポートされています。

WebException (SerializationInfo, StreamingContext) 指定した SerializationInfo インスタンスと StreamingContext インスタンスから、WebException クラスの新しいインスタンスを初期化します。
WebException (String, Exception) WebException クラスの新しいインスタンスを、指定したエラー メッセージと入れ子になった例外を使用して初期化します。

.NET Compact Framework によってサポートされています。

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

.NET Compact Framework によってサポートされています。

WebException (String, Exception, WebExceptionStatus, WebResponse) WebException クラスの新しいインスタンスを、指定したエラー メッセージ、入れ子になった例外、ステータス、および応答を使用して初期化します。

.NET Compact Framework によってサポートされています。

参照参照

関連項目

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

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

WebException クラスの新しいインスタンスを、指定したエラー メッセージと入れ子になった例外を使用して初期化します。

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

Visual Basic (宣言)
Public Sub New ( _
    message As String, _
    innerException As Exception _
)
Visual Basic (使用法)
Dim message As String
Dim innerException As Exception

Dim instance As New WebException(message,
 innerException)
C#
public WebException (
    string message,
    Exception innerException
)
C++
public:
WebException (
    String^ message, 
    Exception^ innerException
)
J#
public WebException (
    String message, 
    Exception innerException
)
JScript
public function WebException (
    message : String, 
    innerException : Exception
)

パラメータ

message

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

innerException

入れ子になった例外。

解説解説

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

使用例使用例

エラー メッセージおよび入れ子になった例外を指定して、WebException をスローする例を次に示します。

Visual Basic
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. 
     ' and the 'InnerException' which actually lead to this exception.
    Throw New WebException("Unable to
 locate the Server with 'www.contoso.com' Uri.",
 e)
End Try
C#
 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; 
        //  and the 'InnerException' which actually lead to this exception.
        throw new WebException("Unable to locate the Server
 with 'www.contoso.com' Uri.",e);
  }
C++
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;
   //  and the 'InnerException' that actually led to this exception.
   throw gcnew WebException( "Unable to locate the Server with 'www.contoso.com'
 Uri.", e );
}
J#
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; 
    // and the 'InnerException' which actually lead to this exception.
    throw new WebException("Unable to locate the Server with
 "
        + "'www.contoso.com' Uri.", e);
}
プラットフォームプラットフォーム

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 名前空間
Exception

WebException コンストラクタ (String)

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

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

Visual Basic (宣言)
Public Sub New ( _
    message As String _
)
Visual Basic (使用法)
Dim message As String

Dim instance As New WebException(message)
C#
public WebException (
    string message
)
C++
public:
WebException (
    String^ message
)
J#
public WebException (
    String message
)
JScript
public function WebException (
    message : String
)

パラメータ

message

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

解説解説

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

使用例使用例

エラー メッセージを指定することによって WebException をスローする例を次に示します。

Visual Basic
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
C#
 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.");
  }
C++
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." );
}
J#
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

WebException プロパティ


パブリック プロパティパブリック プロパティ

( プロテクト プロパティ も参照)
  名前 説明
パブリック プロパティ Data  例外に関する追加のユーザー定義情報を提供するキー/値ペアのコレクションを取得します。 ( Exception から継承されます。)
パブリック プロパティ HelpLink  例外に関連付けられているヘルプ ファイルへのリンクを取得または設定します。 ( Exception から継承されます。)
パブリック プロパティ InnerException  現在の例外を発生させた Exception インスタンスを取得します。 ( Exception から継承されます。)
パブリック プロパティ Message  現在の例外を説明するメッセージを取得します。 ( Exception から継承されます。)
パブリック プロパティ .NET Compact Framework によるサポート Source  エラーの原因となったアプリケーションまたはオブジェクトの名前を取得または設定します。 ( Exception から継承されます。)
パブリック プロパティ StackTrace  現在の例外がスローされたときにコール スタックにあったフレームの文字列形式を取得します。 ( Exception から継承されます。)
パブリック プロパティ .NET Compact Framework によるサポート TargetSite  現在の例外をスローするメソッドを取得します。 ( Exception から継承されます。)
プロテクト プロパティプロテクト プロパティ
  名前 説明
プロテクト プロパティ HResult  特定の例外に割り当てられているコード化数値である HRESULT を取得または設定します。 ( Exception から継承されます。)
参照参照

関連項目

WebException クラス
System.Net 名前空間
Exception

WebException メソッド


パブリック メソッドパブリック メソッド

( プロテクト メソッド も参照)
  名前 説明
パブリック メソッド Equals  オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
パブリック メソッド GetBaseException  派生クラスでオーバーライドされた場合、それ以後に発生する 1 つ以上の例外の主要な原因である Exception を返します。 ( Exception から継承されます。)
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
パブリック メソッド GetObjectData オーバーライドされます。 SerializationInfo インスタンスに、WebException をシリアル化するために必要なデータを設定します。
パブリック メソッド GetType  現在のインスタンスのランタイム型を取得します。 ( Exception から継承されます。)
パブリック メソッド ReferenceEquals  指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
パブリック メソッド ToString  現在の例外の文字列形式を作成して返します。 ( Exception から継承されます。)
プロテクト メソッドプロテクト メソッド
  名前 説明
プロテクト メソッド Finalize  Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
プロテクト メソッド MemberwiseClone  現在の Object の簡易コピーを作成します。 ( Object から継承されます。)
明示的インターフェイスの実装明示的インターフェイスの実装
  名前 説明
インターフェイスの明示的な実装 System.Runtime.Serialization.ISerializable.GetObjectData このインスタンスを、指定した SerializationInfo オブジェクトにシリアル化します。
参照参照

関連項目

WebException クラス
System.Net 名前空間
Exception

WebException メンバ

プラグ可能プロトコルによるネットワークへのアクセスでエラーが発生した場合にスローされる例外。

WebException データ型で公開されるメンバを以下の表に示します。


パブリック コンストラクタパブリック コンストラクタ
( プロテクト コンストラクタ も参照)
  名前 説明
パブリック メソッド WebException オーバーロードされます。 WebException クラスの新しいインスタンスを初期化します。
プロテクト コンストラクタプロテクト コンストラクタ
  名前 説明
プロテクト メソッド WebException オーバーロードされます。 WebException クラスの新しいインスタンスを初期化します。
パブリック プロパティパブリック プロパティ
( プロテクト プロパティ も参照)
  名前 説明
パブリック プロパティ Data  例外に関する追加のユーザー定義情報を提供するキー/値ペアのコレクションを取得します。(Exception から継承されます。)
パブリック プロパティ HelpLink  例外に関連付けられているヘルプ ファイルへのリンクを取得または設定します。(Exception から継承されます。)
パブリック プロパティ InnerException  現在の例外を発生させた Exception インスタンスを取得します。(Exception から継承されます。)
パブリック プロパティ Message  現在の例外を説明するメッセージを取得します。(Exception から継承されます。)
パブリック プロパティ .NET Compact Framework によるサポート Source  エラーの原因となったアプリケーションまたはオブジェクトの名前を取得または設定します。(Exception から継承されます。)
パブリック プロパティ StackTrace  現在の例外がスローされたときにコール スタックにあったフレームの文字列形式を取得します。(Exception から継承されます。)
パブリック プロパティ .NET Compact Framework によるサポート TargetSite  現在の例外をスローするメソッドを取得します。(Exception から継承されます。)
プロテクト プロパティプロテクト プロパティ
  名前 説明
プロテクト プロパティ HResult  特定の例外に割り当てられているコード化数値である HRESULT を取得または設定します。(Exception から継承されます。)
パブリック メソッドパブリック メソッド
( プロテクト メソッド も参照)
  名前 説明
パブリック メソッド Equals  オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
パブリック メソッド GetBaseException  派生クラスでオーバーライドされた場合、それ以後に発生する 1 つ以上の例外の主要な原因である Exception を返します。 (Exception から継承されます。)
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
パブリック メソッド GetObjectData オーバーライドされます。 SerializationInfo インスタンスに、WebException をシリアル化するために必要なデータを設定します。
パブリック メソッド GetType  現在のインスタンスのランタイム型を取得します。 (Exception から継承されます。)
パブリック メソッド ReferenceEquals  指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
パブリック メソッド ToString  現在の例外の文字列形式を作成して返します。 (Exception から継承されます。)
プロテクト メソッドプロテクト メソッド
  名前 説明
プロテクト メソッド Finalize  Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
プロテクト メソッド MemberwiseClone  現在の Object の簡易コピーを作成します。 (Object から継承されます。)
明示的インターフェイスの実装明示的インターフェイスの実装
  名前 説明
インターフェイスの明示的な実装 System.Runtime.Serialization.ISerializable.GetObjectData このインスタンスを、指定した SerializationInfo オブジェクトにシリアル化します。
参照参照

関連項目

WebException クラス
System.Net 名前空間
Exception

急上昇のことば

ニヒル
活動終了
ホッジ予想
携わる
直川貴博
英和和英テキスト翻訳>> Weblio翻訳
英語⇒日本語日本語⇒英語
  

辞書ショートカット

カテゴリ一覧

全て

＋ ビジネス

＋ 業界用語

＋ コンピュータ

＋ 電車

＋ 自動車・バイク

＋ 船

＋ 工学

＋ 建築・不動産

＋ 学問

＋ 文化

＋ 生活

＋ ヘルスケア

＋ 趣味

＋ スポーツ

＋ 生物

＋ 食品

＋ 人名

＋ 方言

＋ 辞書・百科事典

すべての辞書の索引

あいうえお
かきくけこ
さしすせそ
たちつてと
なにぬねの
はひふへほ
まみむめも
やゆよ
らりるれろ
わをん
がぎぐげご
ざじずぜぞ
だぢづでど
ばびぶべぼ
ぱぴぷぺぽ
ＡＢＣＤＥ
ＦＧＨＩＪ
ＫＬＭＮＯ
ＰＱＲＳＴ
ＵＶＷＸＹ
Ｚ
１２３４５
６７８９０
記号

Weblioのサービス

「WebException」の関連用語

1
WebException クラス
.NET Framework クラス ライブラリ リファレンス
72% |||||

2
WebException コンストラクタ ()
.NET Framework クラス ライブラリ リファレンス
72% |||||

3
WebException.Response プロパティ
.NET Framework クラス ライブラリ リファレンス
54% |||||

4
WebException.Status プロパティ
.NET Framework クラス ライブラリ リファレンス
54% |||||

5
WebException.GetObjectData メソッド
.NET Framework クラス ライブラリ リファレンス
50% |||||

6
WebException.System.Runtime.Serialization.ISerializable.GetObjectData メソッド
.NET Framework クラス ライブラリ リファレンス
50% |||||

7
FileWebRequest.GetResponse メソッド
.NET Framework クラス ライブラリ リファレンス
38% |||||

8
WebException メンバ
.NET Framework クラス ライブラリ リファレンス
36% |||||

9
WebRequest.BeginGetResponse メソッド
.NET Framework クラス ライブラリ リファレンス
34% |||||

10
WebRequest.EndGetResponse メソッド
.NET Framework クラス ライブラリ リファレンス
34% |||||

WebExceptionのお隣キーワード

WebEventProvider プロパティ

WebEventProvider メソッド

WebEventProvider メンバ

WebEventProvider.Flush メソッド

WebEventProvider.ProcessEvent メソッド

WebEventProvider.Shutdown メソッド

WebException

WebException クラス

WebException コンストラクタ

WebException プロパティ

WebException メソッド

WebException メンバ

WebException.GetObjectData メソッド

検索ランキング

   

 英語⇒日本語
日本語⇒英語		    


WebExceptionのページの著作権
Weblio 辞書 情報提供元は 参加元一覧 にて確認できます。

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2025 Microsoft.All rights reserved.

©2025 GRAS Group, Inc.RSS