HttpListenerException Class

Reference

Definition

Namespace:: System.Net

Assembly:: System.Net.HttpListener.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Source:: HttpListenerException.cs

Source:: HttpListenerException.cs

Source:: HttpListenerException.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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: Object

Exception

SystemException

ExternalException

Win32Exception
HttpListenerException

Attributes: SerializableAttribute

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, String)	Initializes a new instance of the HttpListenerException class using the specified error code and message.
HttpListenerException(Int32)	Initializes a new instance of the HttpListenerException class using the specified error code.
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

Jaa