WebException Construtores
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Inicializa uma nova instância da WebException classe.
Sobrecargas
| Name | Description |
|---|---|
| WebException() |
Inicializa uma nova instância da WebException classe. |
| WebException(String) |
Inicializa uma nova instância da WebException classe com a mensagem de erro especificada. |
| WebException(SerializationInfo, StreamingContext) |
Obsoleto.
Inicializa uma nova instância da WebException classe a partir das instâncias e SerializationInfo especificadasStreamingContext. |
| WebException(String, WebExceptionStatus) |
Inicializa uma nova instância da WebException classe com a mensagem de erro e o estado especificados. |
| WebException(String, Exception) |
Inicializa uma nova instância da WebException classe com a mensagem de erro especificada e a exceção aninhada. |
| WebException(String, Exception, WebExceptionStatus, WebResponse) |
Inicializa uma nova instância da WebException classe com a mensagem de erro especificada, exceção aninhada, estado e resposta. |
WebException()
- Origem:
- WebException.cs
- Origem:
- WebException.cs
- Origem:
- WebException.cs
- Origem:
- WebException.cs
- Origem:
- WebException.cs
Inicializa uma nova instância da WebException classe.
public:
WebException();
public WebException();
Public Sub New ()
Exemplos
O exemplo seguinte apresenta um padrão 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
Observações
O construtor sem parâmetros inicializa uma nova instância da WebException classe. A Message propriedade é inicializada numa mensagem fornecida pelo sistema que descreve o erro. Esta mensagem tem em conta a cultura atual do sistema. As InnerException propriedades e Response são inicializadas em null. A Status propriedade é inicializada em RequestCanceled.
Aplica-se a
WebException(String)
- Origem:
- WebException.cs
- Origem:
- WebException.cs
- Origem:
- WebException.cs
- Origem:
- WebException.cs
- Origem:
- WebException.cs
Inicializa uma nova instância da WebException classe com a mensagem de erro especificada.
public:
WebException(System::String ^ message);
public WebException(string message);
public WebException(string? message);
new System.Net.WebException : string -> System.Net.WebException
Public Sub New (message As String)
Parâmetros
- message
- String
O texto da mensagem de erro.
Exemplos
O exemplo seguinte lança uma WebException ao especificar uma mensagem de erro.
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
Observações
A WebException instância é inicializada com a Message propriedade definida para o valor de message. Se message for null, a Message propriedade é inicializada numa mensagem fornecida pelo sistema. As InnerException propriedades e Response são inicializadas em null. A Status propriedade é inicializada em RequestCanceled.
Ver também
Aplica-se a
WebException(SerializationInfo, StreamingContext)
- Origem:
- WebException.cs
- Origem:
- WebException.cs
- Origem:
- WebException.cs
- Origem:
- WebException.cs
- Origem:
- WebException.cs
Atenção
This API supports obsolete formatter-based serialization. It should not be called or extended by application code.
Inicializa uma nova instância da WebException classe a partir das instâncias e SerializationInfo especificadasStreamingContext.
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);
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
new System.Net.WebException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Net.WebException
Protected Sub New (serializationInfo As SerializationInfo, streamingContext As StreamingContext)
Parâmetros
- serializationInfo
- SerializationInfo
A SerializationInfo que contém a informação necessária para serializar o novo WebException.
- streamingContext
- StreamingContext
A StreamingContext que contém a fonte do fluxo serializado associado ao novo WebException.
- Atributos
Observações
Este construtor implementa a ISerializable interface para a WebException classe.
Ver também
Aplica-se a
WebException(String, WebExceptionStatus)
- Origem:
- WebException.cs
- Origem:
- WebException.cs
- Origem:
- WebException.cs
- Origem:
- WebException.cs
- Origem:
- WebException.cs
Inicializa uma nova instância da WebException classe com a mensagem de erro e o estado especificados.
public:
WebException(System::String ^ message, System::Net::WebExceptionStatus status);
public WebException(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)
Parâmetros
- message
- String
O texto da mensagem de erro.
- status
- WebExceptionStatus
Um dos WebExceptionStatus valores.
Exemplos
O exemplo seguinte lança um WebException especificando uma mensagem de erro e um 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
Observações
A WebException instância é inicializada com a Message propriedade definida para o valor de message e a Status propriedade definida para o valor de status. Se message for null, a Message propriedade é inicializada numa mensagem fornecida pelo sistema. As InnerException propriedades e Response são inicializadas em null.
Aplica-se a
WebException(String, Exception)
- Origem:
- WebException.cs
- Origem:
- WebException.cs
- Origem:
- WebException.cs
- Origem:
- WebException.cs
- Origem:
- WebException.cs
Inicializa uma nova instância da WebException classe com a mensagem de erro especificada e a exceção aninhada.
public:
WebException(System::String ^ message, Exception ^ inner);
public:
WebException(System::String ^ message, Exception ^ innerException);
public WebException(string message, Exception inner);
public WebException(string? message, Exception? innerException);
public WebException(string message, Exception innerException);
new System.Net.WebException : string * Exception -> System.Net.WebException
new System.Net.WebException : string * Exception -> System.Net.WebException
Public Sub New (message As String, inner As Exception)
Public Sub New (message As String, innerException As Exception)
Parâmetros
- message
- String
O texto da mensagem de erro.
- innerinnerException
- Exception
Uma exceção aninhada.
Exemplos
O exemplo seguinte lança um WebException ao especificar uma mensagem de erro e uma exceção aninhada.
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
Observações
A WebException instância é inicializada com a Message propriedade definida para o valor de message e a InnerException propriedade definida para o valor de innerException. Se message for null, a Message propriedade é inicializada numa mensagem fornecida pelo sistema. As InnerException propriedades e Response são inicializadas em null. A Status propriedade é inicializada em RequestCanceled.
Ver também
Aplica-se a
WebException(String, Exception, WebExceptionStatus, WebResponse)
- Origem:
- WebException.cs
- Origem:
- WebException.cs
- Origem:
- WebException.cs
- Origem:
- WebException.cs
- Origem:
- WebException.cs
Inicializa uma nova instância da WebException classe com a mensagem de erro especificada, exceção aninhada, estado e resposta.
public:
WebException(System::String ^ message, Exception ^ inner, System::Net::WebExceptionStatus status, System::Net::WebResponse ^ response);
public:
WebException(System::String ^ message, Exception ^ innerException, System::Net::WebExceptionStatus status, System::Net::WebResponse ^ response);
public WebException(string message, Exception inner, System.Net.WebExceptionStatus status, System.Net.WebResponse response);
public WebException(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
new System.Net.WebException : string * Exception * System.Net.WebExceptionStatus * System.Net.WebResponse -> System.Net.WebException
Public Sub New (message As String, inner As Exception, status As WebExceptionStatus, response As WebResponse)
Public Sub New (message As String, innerException As Exception, status As WebExceptionStatus, response As WebResponse)
Parâmetros
- message
- String
O texto da mensagem de erro.
- innerinnerException
- Exception
Uma exceção aninhada.
- status
- WebExceptionStatus
Um dos WebExceptionStatus valores.
- response
- WebResponse
Uma WebResponse instância que contém a resposta do host remoto.
Exemplos
O exemplo seguinte lança um WebException especificando uma mensagem de erro e um 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()
Observações
A WebException instância é inicializada com a Message propriedade definida para o valor de message, a InnerException propriedade definida para o valor de innerException, a Status propriedade definida para o valor de status, e a Response propriedade definida para o valor de response. Se message for null, a Message propriedade é inicializada numa mensagem fornecida pelo sistema.