• Article

WebException Constructor (String, Exception)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Initializes a new instance of the WebException class with the specified error message and nested exception.

Namespace:  System.Net
Assembly:  System.Net (in System.Net.dll)

Syntax

'Declaration
Public Sub New ( _
    message As String, _
    innerException As Exception _
)

public WebException(
    string message,
    Exception innerException
)

Parameters

Remarks

The WebException instance is initialized with the Message property set to the value of message and the InnerException property set to the value of innerException. If message is nulla null reference (Nothing in Visual Basic), the Message property is initialized to a system-supplied message. The InnerException and Response properties are initialized to nulla null reference (Nothing in Visual Basic). The Status property is initialized to RequestCanceled.

Examples

The following example throws a WebException by specifying an error message and nested exception.

  public class Example
  {
    static ManualResetEvent clientDone = new ManualResetEvent(false);

    public static void Demo(System.Windows.Controls.TextBlock outputBlock)
    {
        SocketAsyncEventArgs socketEventArg = new SocketAsyncEventArgs();
            DnsEndPoint hostEntry = new DnsEndPoint("https://www.contoso.com", 80);

        // Create a socket and connect to the server
        Socket sock = new Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp);

        socketEventArg.Completed += new EventHandler<SocketAsyncEventArgs>(SocketEventArg_Completed);

        socketEventArg.RemoteEndPoint = hostEntry;
        socketEventArg.UserToken = sock;
        sock.ConnectAsync(socketEventArg);
        clientDone.WaitOne();
    }

    static void SocketEventArg_Completed(object sender, SocketAsyncEventArgs e)
    {
         if (e.LastOperation == SocketAsyncOperation.Connect) {
           if (e.SocketError == SocketError.Success)
            {
                // Successfully connected to the server

            }
            else
            {
                  // Throw the WebException with a string
                    throw new WebException("Unable to connect to 'www.contoso.com' Uri.",new SocketException());
                }
             } 
             // socket operation not a connect!  
         else
            throw new Exception("Invalid operation completed");
    }
  }

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.