MessageHeaderException MessageHeaderException MessageHeaderException MessageHeaderException Class

定义

在处理消息时,如果不能满足与 SOAP 消息头有关的期望,则引发该异常。The exception that is thrown when the expectations regarding headers of a SOAP message are not satisfied when the message is processed.

public ref class MessageHeaderException : System::ServiceModel::ProtocolException
[System.Serializable]
public class MessageHeaderException : System.ServiceModel.ProtocolException
type MessageHeaderException = class
    inherit ProtocolException
Public Class MessageHeaderException
Inherits ProtocolException
继承
属性

注解

通常,当消息中存在太多标头或缺少标头时都会引发此异常。This exception is typically thrown when there are too many headers or headers are missing from the message. 这可以包括基础结构标头,如“操作和可靠消息”标头。This can include infrastructure headers such as the Action and Reliable Message headers. 此异常从 ProtocolException 派生,而后者则从 CommunicationException 派生。This exception derives from ProtocolException, which in turn derives from CommunicationException. CommunicationException类表示的可恢复错误的可能终结点与该可靠的 Windows Communication Foundation (WCF) 客户端之间进行通信时引发的类和服务应用程序需要处理。The CommunicationException class represents a class of recoverable errors that may be thrown during communication between endpoints and that robust Windows Communication Foundation (WCF) client and service applications are expected to handle. 若要阻止更为通用的 CommunicationException 处理程序捕捉更为具体的 ProtocolException,请在处理 CommunicationException 之前捕捉此异常。To prevent the more generic CommunicationException handler from catching the more specific ProtocolException, catch this exception prior to handling CommunicationException.

构造函数

MessageHeaderException() MessageHeaderException() MessageHeaderException() MessageHeaderException()

初始化 MessageHeaderException 类的新实例。Initializes a new instance of the MessageHeaderException class.

MessageHeaderException(SerializationInfo, StreamingContext) MessageHeaderException(SerializationInfo, StreamingContext) MessageHeaderException(SerializationInfo, StreamingContext) MessageHeaderException(SerializationInfo, StreamingContext)

初始化用来将数据反序列化到 MessageHeaderException 对象中的 MessageHeaderException 类的新实例。Initializes a new instance of the MessageHeaderException class used to deserialize data into a MessageHeaderException object.

MessageHeaderException(String) MessageHeaderException(String) MessageHeaderException(String) MessageHeaderException(String)

使用指定的消息初始化 MessageHeaderException 类的新实例。Initializes a new instance of the MessageHeaderException class with the specified message.

MessageHeaderException(String, Boolean) MessageHeaderException(String, Boolean) MessageHeaderException(String, Boolean) MessageHeaderException(String, Boolean)

使用指定的消息和指示消息头是重复还是缺少的值初始化 MessageHeaderException 类的新实例。Initializes a new instance of the MessageHeaderException class using the specified message and a value that indicates whether the message header is a duplicate or is missing.

MessageHeaderException(String, Exception) MessageHeaderException(String, Exception) MessageHeaderException(String, Exception) MessageHeaderException(String, Exception)

使用指定的消息和导致异常的内部异常来初始化 MessageHeaderException 类的新实例。Initializes a new instance of the MessageHeaderException class using the specified message and the inner exception that caused the exception.

MessageHeaderException(String, String, String) MessageHeaderException(String, String, String) MessageHeaderException(String, String, String) MessageHeaderException(String, String, String)

使用指定的消息、标头名称和命名空间初始化 MessageHeaderException 类的新实例。Initializes a new instance of the MessageHeaderException class using the specified message, header name and namespace.

MessageHeaderException(String, String, String, Boolean) MessageHeaderException(String, String, String, Boolean) MessageHeaderException(String, String, String, Boolean) MessageHeaderException(String, String, String, Boolean)

使用指定的消息、标头名称和命名空间以及指示消息头是重复还是缺少的值来初始化 MessageHeaderException 类的新实例。Initializes a new instance of the MessageHeaderException class using the specified message, header name and namespace, and a value that indicates whether the message header is a duplicate or is missing.

MessageHeaderException(String, String, String, Boolean, Exception) MessageHeaderException(String, String, String, Boolean, Exception) MessageHeaderException(String, String, String, Boolean, Exception) MessageHeaderException(String, String, String, Boolean, Exception)

使用指定的消息、标头名称和命名空间、指示消息头是重复还是缺少的值以及导致异常的内部异常来初始化 MessageHeaderException 类的新实例。Initializes a new instance of the MessageHeaderException class using the specified message, header name and namespace, a value that indicates whether the message header is a duplicate or is missing, and the inner exception that caused the exception.

MessageHeaderException(String, String, String, Exception) MessageHeaderException(String, String, String, Exception) MessageHeaderException(String, String, String, Exception) MessageHeaderException(String, String, String, Exception)

使用指定的消息、标头名称和命名空间以及导致异常的内部异常来初始化 MessageHeaderException 类的新实例。Initializes a new instance of the MessageHeaderException class using the specified message, header name and namespace, and the inner exception that caused the exception.

属性

Data Data Data Data

获取提供有关异常的其他用户定义信息的键/值对集合。Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Inherited from Exception)
HeaderName HeaderName HeaderName HeaderName

获取导致异常的 SOAP 标头的名称。Gets the name of the SOAP header that caused the exception.

HeaderNamespace HeaderNamespace HeaderNamespace HeaderNamespace

获取导致异常的 SOAP 标头的命名空间。Gets the namespace of the SOAP header that caused the exception.

HelpLink HelpLink HelpLink HelpLink

获取或设置指向与此异常关联的帮助文件链接。Gets or sets a link to the help file associated with this exception.

(Inherited from Exception)
HResult HResult HResult HResult

获取或设置 HRESULT(一个分配给特定异常的编码数字值)。Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Inherited from Exception)
InnerException InnerException InnerException InnerException

获取导致当前异常的 Exception 实例。Gets the Exception instance that caused the current exception.

(Inherited from Exception)
IsDuplicate IsDuplicate IsDuplicate IsDuplicate

获取一个值,该值指示是存在多个消息头还是没有消息头。Gets a value that indicates whether there are multiple message headers or no message headers.

Message Message Message Message

获取描述当前异常的消息。Gets a message that describes the current exception.

(Inherited from Exception)
Source Source Source Source

获取或设置导致错误的应用程序或对象的名称。Gets or sets the name of the application or the object that causes the error.

(Inherited from Exception)
StackTrace StackTrace StackTrace StackTrace

获取调用堆栈上的即时框架字符串表示形式。Gets a string representation of the immediate frames on the call stack.

(Inherited from Exception)
TargetSite TargetSite TargetSite TargetSite

获取引发当前异常的方法。Gets the method that throws the current exception.

(Inherited from Exception)

方法

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

确定指定的对象是否等于当前对象。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetBaseException() GetBaseException() GetBaseException() GetBaseException()

当在派生类中重写时,返回 Exception,它是一个或多个并发的异常的根源。When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(Inherited from Exception)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

作为默认哈希函数。Serves as the default hash function.

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

当在派生类中重写时,用关于异常的信息设置 SerializationInfoWhen overridden in a derived class, sets the SerializationInfo with information about the exception.

(Inherited from Exception)
GetType() GetType() GetType() GetType()

获取当前实例的运行时类型。Gets the runtime type of the current instance.

(Inherited from Exception)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

创建当前 Object 的浅表副本。Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

创建并返回当前异常的字符串表示形式。Creates and returns a string representation of the current exception.

(Inherited from Exception)

事件

SerializeObjectState SerializeObjectState SerializeObjectState SerializeObjectState

当异常被序列化用来创建包含有关该异常的徐列出数据的异常状态对象时会出现该问题。Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Inherited from Exception)

适用于