MessageHeader 类

定义

命名空间:

System.ServiceModel.Channels

程序集:

System.ServiceModel.Primitives.dll

包:

System.ServiceModel.Primitives v8.0.0

Source:

MessageHeader.cs

表示 SOAP 标头的内容。

public ref class MessageHeader abstract : System::ServiceModel::Channels::MessageHeaderInfo

public abstract class MessageHeader : System.ServiceModel.Channels.MessageHeaderInfo

type MessageHeader = class
    inherit MessageHeaderInfo

Public MustInherit Class MessageHeader
Inherits MessageHeaderInfo

继承

Object

MessageHeaderInfo

MessageHeader

注解

消息头包含用于描述消息（由 Message 类包装）的可选元数据。

Message 可以没有标头或有一个或多个标头，这些标头作为一种扩展机制用来在特定于应用程序的消息中传递信息。 通过调用 Headers 方法，可使用 Add 将消息头添加到消息中。

Windows Communication Foundation (WCF) 提供了许多预定义的消息标头，如下表所示。

标头名称	说明
功能	包含作为消息投递目标的角色。
操作	提供应如何处理消息的说明。
FaultTo	包含错误应发送到的节点的地址。
从	包含发送消息的节点的地址。
请求	指示消息是否为请求。
消息 ID	包含消息的唯一 ID。
RelatesTo	包含与此消息相关的消息的 ID。
ReplyTo	包含对请求的答复应发送到的节点的地址。

构造函数

MessageHeader()

初始化 MessageHeader 类的新实例。

属性

Actor	获取或设置消息头的目标接收方。
IsReferenceParameter	获取一个值，该值指定此消息头是否包含终结点引用的引用参数。
MustUnderstand	获取或设置一个值，该值指示是否必须按照 SOAP 1.1/1.2 规范解释标头。
Name	获取消息头的名称。 (继承自 MessageHeaderInfo)
Namespace	获取消息头的命名空间。 (继承自 MessageHeaderInfo)
Relay	获取一个值，该值指示是否应该中继标头。

方法

CreateHeader(String, String, Object)	创建具有指定数据的新消息头。
CreateHeader(String, String, Object, Boolean)	创建具有指定数据的新消息头。
CreateHeader(String, String, Object, Boolean, String)	创建具有指定数据的新消息头。
CreateHeader(String, String, Object, Boolean, String, Boolean)	创建具有指定数据的新消息头。
CreateHeader(String, String, Object, XmlObjectSerializer)	使用 XmlFormatter 从要序列化的对象创建标头。
CreateHeader(String, String, Object, XmlObjectSerializer, Boolean)	创建具有指定数据的新消息头。
CreateHeader(String, String, Object, XmlObjectSerializer, Boolean, String)	创建具有指定数据的新消息头。
CreateHeader(String, String, Object, XmlObjectSerializer, Boolean, String, Boolean)	创建具有指定数据的新消息头。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
IsMessageVersionSupported(MessageVersion)	验证是否支持指定的消息版本。
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
OnWriteHeaderContents(XmlDictionaryWriter, MessageVersion)	在使用指定的 XML 编写器序列化标头内容时调用。
OnWriteStartHeader(XmlDictionaryWriter, MessageVersion)	在使用指定的 XML 编写器序列化开始标头时调用。
ToString()	返回该消息标头的字符串表示。
WriteHeader(XmlDictionaryWriter, MessageVersion)	使用指定的 XML 编写器序列化标头。
WriteHeader(XmlWriter, MessageVersion)	使用指定的 XML 编写器序列化标头。
WriteHeaderAttributes(XmlDictionaryWriter, MessageVersion)	使用指定的 XML 编写器序列化标头特性。
WriteHeaderContents(XmlDictionaryWriter, MessageVersion)	使用指定的 XML 编写器序列化标头内容。
WriteStartHeader(XmlDictionaryWriter, MessageVersion)	使用指定的 XML 编写器序列化开始标头。