MessageHeader Class
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Represents the content of a SOAP header.
System.ServiceModel.Channels::MessageHeaderInfo
System.ServiceModel.Channels::MessageHeader
Assembly: System.ServiceModel (in System.ServiceModel.dll)
The MessageHeader type exposes the following members.
| Name | Description | |
|---|---|---|
 | Actor | Gets or sets the targeted recipient of the message header. (Overrides MessageHeaderInfo::Actor.) |
| IsReferenceParameter | Gets a value that specifies whether this message header contains reference parameters of an endpoint reference. (Overrides MessageHeaderInfo::IsReferenceParameter.) |
| MustUnderstand | Gets or sets a value that indicates whether the header must be understood, according to SOAP 1.1 or 1.2 specification. (Overrides MessageHeaderInfo::MustUnderstand.) |
| Name | Gets the name of the message header. (Inherited from MessageHeaderInfo.) |
| Namespace | Gets the namespace of the message header. (Inherited from MessageHeaderInfo.) |
| Relay | Gets a value that indicates whether the header should be relayed. (Overrides MessageHeaderInfo::Relay.) |
| Name | Description | |
|---|---|---|
  | CreateHeader(String, String, Object) | Creates a new message header with the specified data. |
| CreateHeader(String, String, Object, Boolean) | Creates a new message header with the specified data. |
| CreateHeader(String, String, Object, XmlObjectSerializer) | Creates a header from an object to be serialized using the XmlFormatter. |
| CreateHeader(String, String, Object, Boolean, String) | Creates a new message header with the specified data. |
| CreateHeader(String, String, Object, XmlObjectSerializer, Boolean) | Creates a new message header with the specified data. |
| CreateHeader(String, String, Object, Boolean, String, Boolean) | Creates a new message header with the specified data. |
| CreateHeader(String, String, Object, XmlObjectSerializer, Boolean, String) | Creates a new message header with the specified data. |
| CreateHeader(String, String, Object, XmlObjectSerializer, Boolean, String, Boolean) | Creates a new message header with the specified data. |
| Equals(Object) | Determines whether the specified Object is equal to the current Object. (Inherited from Object.) |
 | Finalize | Allows an object to try to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.) |
| GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
| GetType | Gets the Type of the current instance. (Inherited from Object.) |
| IsMessageVersionSupported | Verifies whether the specified message version is supported. |
| MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
| OnWriteHeaderContents | Called when the header content is serialized using the specified XML writer. |
| OnWriteStartHeader | Called when the start header is serialized using the specified XML writer. |
| ToString | Converts this message header to a string. (Overrides Object::ToString().) |
| WriteHeader(XmlDictionaryWriter, MessageVersion) | Serializes the header using the specified XML writer. |
| WriteHeader(XmlWriter, MessageVersion) | Serializes the header using the specified XML writer. |
| WriteHeaderAttributes | Serializes the header contents using the specified XML writer. |
| WriteHeaderContents | Serializes the header contents using the specified XML writer. |
| WriteStartHeader | Serializes the start header using the specified XML writer. |
A message header contains optional metadata that describe a message encapsulated by the Message class.
A Message can have zero or more headers that are used as an extension mechanism to pass information in messages that are application specific. You can use Headers to add message headers to a message by calling the Add method.
Windows Phone provides a number of predefined message headers, as shown in the following table.
Header Name | Description |
|---|---|
To | Contains the role that the message is targeting. |
Action | Provides a description of how the message should be processed. |
FaultTo | Contains the address of the node to which faults should be sent. |
From | Contains the address of the node that sent the message. |
Request | Indicates whether the message is a request. |
MessageID | Contains the unique ID of the message. |
RelatesTo | Contains the IDs of messages that are related to this message. |
ReplyTo | Contains the address of the node to which a reply should be sent for a request. |