WebException Costruttori

Definizione

Spazio dei nomi:

System.Net

Assembly:

netstandard.dll, System.Net.Requests.dll

Inizializza una nuova istanza della classe WebException.

Overload

Nome	Descrizione
WebException()	Inizializza una nuova istanza della classe WebException.
WebException(String)	Inizializza una nuova istanza della WebException classe con il messaggio di errore specificato.
WebException(SerializationInfo, StreamingContext)	Obsoleti. Inizializza una nuova istanza della WebException classe dalle istanze e StreamingContext specificateSerializationInfo.
WebException(String, WebExceptionStatus)	Inizializza una nuova istanza della WebException classe con il messaggio di errore e lo stato specificati.
WebException(String, Exception)	Inizializza una nuova istanza della WebException classe con il messaggio di errore e l'eccezione nidificata specificati.
WebException(String, Exception, WebExceptionStatus, WebResponse)	Inizializza una nuova istanza della WebException classe con il messaggio di errore, l'eccezione annidata, lo stato e la risposta specificati.

WebException()

Origine:

WebException.cs

Inizializza una nuova istanza della classe WebException.

public:
 WebException();

public WebException();

Public Sub New ()

Esempio

Nell'esempio seguente viene generata un'eccezione predefinita WebException.

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

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

Commenti

Il costruttore senza parametri inizializza una nuova istanza della WebException classe . La Message proprietà viene inizializzata in un messaggio fornito dal sistema che descrive l'errore. Questo messaggio tiene conto delle impostazioni cultura correnti del sistema. Le InnerException proprietà e Response vengono inizializzate in null. La proprietà Status viene inizializzata su RequestCanceled.

WebException(String)

Origine:

WebException.cs

Inizializza una nuova istanza della WebException classe con il messaggio di errore specificato.

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

public WebException(string? message);

new System.Net.WebException : string -> System.Net.WebException

Public Sub New (message As String)

Parametri

message

String

Testo del messaggio di errore.

Esempio

Nell'esempio seguente viene generata un'eccezione WebException specificando un messaggio di errore.

 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.
    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

Commenti

L'istanza WebException viene inizializzata con la Message proprietà impostata sul valore di message. Se message è null, la Message proprietà viene inizializzata in un messaggio fornito dal sistema. Le InnerException proprietà e Response vengono inizializzate in null. La proprietà Status viene inizializzata su RequestCanceled.

Vedi anche

• Exception

WebException(SerializationInfo, StreamingContext)

Origine:

WebException.cs

Attenzione

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

Inizializza una nuova istanza della WebException classe dalle istanze e StreamingContext specificateSerializationInfo.

protected:
 WebException(System::Runtime::Serialization::SerializationInfo ^ serializationInfo, System::Runtime::Serialization::StreamingContext streamingContext);

[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 WebException(System.Runtime.Serialization.SerializationInfo serializationInfo, System.Runtime.Serialization.StreamingContext streamingContext);

[<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 System.Net.WebException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Net.WebException

Protected Sub New (serializationInfo As SerializationInfo, streamingContext As StreamingContext)

Parametri

serializationInfo

SerializationInfo

Oggetto SerializationInfo contenente le informazioni necessarie per serializzare il nuovo WebExceptionoggetto .

streamingContext

StreamingContext

Oggetto StreamingContext contenente l'origine del flusso serializzato associato al nuovo WebExceptionoggetto .

Attributi

ObsoleteAttribute

Commenti

Questo costruttore implementa l'interfaccia ISerializable per la WebException classe .

Vedi anche

• ISerializable

WebException(String, WebExceptionStatus)

Origine:

WebException.cs

Inizializza una nuova istanza della WebException classe con il messaggio di errore e lo stato specificati.

public:
 WebException(System::String ^ message, System::Net::WebExceptionStatus status);

public WebException(string? message, System.Net.WebExceptionStatus status);

new System.Net.WebException : string * System.Net.WebExceptionStatus -> System.Net.WebException

Public Sub New (message As String, status As WebExceptionStatus)

Parametri

message

String

Testo del messaggio di errore.

status

WebExceptionStatus

Uno dei WebExceptionStatus valori.

Esempio

Nell'esempio seguente viene generata un'eccezione WebException specificando un messaggio di errore e un oggetto WebExceptionStatus.

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

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

Commenti

L'istanza WebException viene inizializzata con la Message proprietà impostata sul valore di message e la Status proprietà impostata sul valore di status. Se message è null, la Message proprietà viene inizializzata in un messaggio fornito dal sistema. Le InnerException proprietà e Response vengono inizializzate in null.

WebException(String, Exception)

Origine:

WebException.cs

Inizializza una nuova istanza della WebException classe con il messaggio di errore e l'eccezione nidificata specificati.

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

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

new System.Net.WebException : string * Exception -> System.Net.WebException

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

Parametri

message

String

Testo del messaggio di errore.

innerException

Exception

Eccezione annidata.

Esempio

Nell'esempio seguente viene generata un'eccezione WebException specificando un messaggio di errore e un'eccezione annidata.

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

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

Commenti

L'istanza WebException viene inizializzata con la Message proprietà impostata sul valore di message e la InnerException proprietà impostata sul valore di innerException. Se message è null, la Message proprietà viene inizializzata in un messaggio fornito dal sistema. Le InnerException proprietà e Response vengono inizializzate in null. La proprietà Status viene inizializzata su RequestCanceled.

Vedi anche

• Exception

WebException(String, Exception, WebExceptionStatus, WebResponse)

Origine:

WebException.cs

Inizializza una nuova istanza della WebException classe con il messaggio di errore, l'eccezione annidata, lo stato e la risposta specificati.

public:
 WebException(System::String ^ message, Exception ^ innerException, System::Net::WebExceptionStatus status, System::Net::WebResponse ^ response);

public WebException(string? message, Exception? innerException, System.Net.WebExceptionStatus status, System.Net.WebResponse? response);

new System.Net.WebException : string * Exception * System.Net.WebExceptionStatus * System.Net.WebResponse -> System.Net.WebException

Public Sub New (message As String, innerException As Exception, status As WebExceptionStatus, response As WebResponse)

Parametri

message

String

Testo del messaggio di errore.

innerException

Exception

Eccezione annidata.

status

WebExceptionStatus

Uno dei WebExceptionStatus valori.

response

WebResponse

WebResponse Istanza che contiene la risposta dall'host remoto.

Esempio

Nell'esempio seguente viene generata un'eccezione WebException specificando un messaggio di errore e un oggetto WebExceptionStatus.

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

     ' 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()

Commenti

L'istanza WebException viene inizializzata con la Message proprietà impostata sul valore di message, la InnerException proprietà impostata sul valore di innerException, la Status proprietà impostata sul valore di statuse la Response proprietà impostata sul valore di response. Se message è null, la Message proprietà viene inizializzata in un messaggio fornito dal sistema.