ProtocolException Constructors

Definition

Namespace:

System.ServiceModel

Assembly:

System.ServiceModel.Primitives.dll

Package:

System.ServiceModel.Primitives v8.0.0

Initializes a new instance of the ProtocolException class.

Overloads

ProtocolException(String)	Initializes a new instance of the ProtocolException class with a specified error message.
ProtocolException(SerializationInfo, StreamingContext)	Initializes a new instance of the ProtocolException class with serialization information and streaming context specified.
ProtocolException(String, Exception)	Initializes a new instance of the ProtocolException class with a specified error message and a reference to the inner exception that is the cause of the exception.

Remarks

If you want to pass an error message to the user, use the ProtocolException(String) constructor.

If you want to pass an error message and a reference to the inner exception that is the cause of the exception to the user, use the ProtocolException(String, Exception) constructor.

If you want to pass serialization information and streaming context, use the ProtocolException(SerializationInfo, StreamingContext) constructor.

ProtocolException(String)

Initializes a new instance of the ProtocolException class with a specified error message.

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

public ProtocolException (string message);

new System.ServiceModel.ProtocolException : string -> System.ServiceModel.ProtocolException

Public Sub New (message As String)

Parameters

message

String

The error message that explains the reason for the exception.

Remarks

Use this constructor when you want to pass an error message to the user. The content of the message parameter should be understandable to the user. The caller of this constructor is required to ensure that this string has been localized for the current system culture.

If you also want to pass a reference to the inner exception that is the cause of the exception as well as a specified error message to the user, use the ProtocolException(String, Exception) constructor.

ProtocolException(SerializationInfo, StreamingContext)

Initializes a new instance of the ProtocolException class with serialization information and streaming context specified.

protected:
 ProtocolException(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);

protected ProtocolException (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

new System.ServiceModel.ProtocolException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.ServiceModel.ProtocolException

Protected Sub New (info As SerializationInfo, context As StreamingContext)

Parameters

info

SerializationInfo

The SerializationInfo that contains all the data required to serialize the exception.

context

StreamingContext

The StreamingContext that specifies the source and destination of the stream.

Remarks

This constructor is called during deserialization to reconstruct the exception object transmitted over a stream.

ProtocolException(String, Exception)

Initializes a new instance of the ProtocolException class with a specified error message and a reference to the inner exception that is the cause of the exception.

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

public ProtocolException (string message, Exception innerException);

new System.ServiceModel.ProtocolException : string * Exception -> System.ServiceModel.ProtocolException

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

Parameters

message

String

The error message that explains the reason for the exception.

innerException

Exception

The Exception that caused the current exception to be thrown.

Remarks

Use this constructor when you want to pass an error message and information about an inner exception up to the user. The content of the message parameter should be understandable to the intended users.

An exception that is thrown as a direct result of a previous exception can include a reference to the previous exception in the InnerException property. The InnerException property returns the same value that is passed into the constructor, or a null reference (Nothing in Visual Basic) if the InnerException property does not supply the inner exception value to the constructor.