HttpListenerException Class

Definition

The exception that is thrown when an error occurs processing an HTTP request.

public ref class HttpListenerException : System::ComponentModel::Win32Exception
public class HttpListenerException : System.ComponentModel.Win32Exception
[System.Serializable]
public class HttpListenerException : System.ComponentModel.Win32Exception
type HttpListenerException = class
    inherit Win32Exception
[<System.Serializable>]
type HttpListenerException = class
    inherit Win32Exception
Public Class HttpListenerException
Inherits Win32Exception
Inheritance
HttpListenerException
Inheritance
Attributes

Remarks

This exception is thrown by the HttpListener class and its associated classes when an error occurs during initialization of the HttpListener or while creating or sending a response to an HTTP request. For example, this exception is thrown if the HttpListener attempts to register a Uniform Resource Identifier (URI) prefix that is already registered.

Associated Tips

Make sure you are not attempting to register a URI prefix that is already registered.
If the URI prefix is already registered, this exception will occur.

Make sure your HTTP request is valid.
This exception is thrown by the HttpListener class and its associated classes when an error occurs during the initialization of the HttpListener or while creating or sending a response to an HTTP request.

If you are using the HttpListenerPrefixCollection.Add method, make sure the uriPrefix has not been already added.
This exception will be thrown if another HttpListener has already added the prefix uriPrefix.

Constructors

HttpListenerException()

Initializes a new instance of the HttpListenerException class.

HttpListenerException(Int32)

Initializes a new instance of the HttpListenerException class using the specified error code.

HttpListenerException(Int32, String)

Initializes a new instance of the HttpListenerException class using the specified error code and message.

HttpListenerException(SerializationInfo, StreamingContext)
Obsolete.

Initializes a new instance of the HttpListenerException class from the specified instances of the SerializationInfo and StreamingContext classes.

Properties

Data

Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Inherited from Exception)
ErrorCode

Gets a value that identifies the error that occurred.

HelpLink

Gets or sets a link to the help file associated with this exception.

(Inherited from Exception)
HResult

Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Inherited from Exception)
InnerException

Gets the Exception instance that caused the current exception.

(Inherited from Exception)
Message

Gets a message that describes the current exception.

(Inherited from Exception)
NativeErrorCode

Gets the Win32 error code associated with this exception.

(Inherited from Win32Exception)
Source

Gets or sets the name of the application or the object that causes the error.

(Inherited from Exception)
StackTrace

Gets a string representation of the immediate frames on the call stack.

(Inherited from Exception)
TargetSite

Gets the method that throws the current exception.

(Inherited from Exception)

Methods

Equals(Object)

Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetBaseException()

When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(Inherited from Exception)
GetHashCode()

Serves as the default hash function.

(Inherited from Object)
GetObjectData(SerializationInfo, StreamingContext)
Obsolete.

Sets the SerializationInfo object with the file name and line number at which this Win32Exception occurred.

(Inherited from Win32Exception)
GetType()

Gets the runtime type of the current instance.

(Inherited from Exception)
MemberwiseClone()

Creates a shallow copy of the current Object.

(Inherited from Object)
ToString()

Returns a string that contains the NativeErrorCode, or HResult, or both.

(Inherited from Win32Exception)

Events

SerializeObjectState
Obsolete.

Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Inherited from Exception)

Applies to

See also