MessageHeader Classe
Definição
Representa o conteúdo de um cabeçalho SOAP.Represents the content of a SOAP header.
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
- Herança
Comentários
Um cabeçalho de mensagem contém metadados opcionais que descrevem uma mensagem encapsulada pela Message classe.A message header contains optional metadata that describe a message encapsulated by the Message class.
Um Message pode ter zero ou mais cabeçalhos que são usados como um mecanismo de extensão para passar informações em mensagens que são específicas do aplicativo.A Message can have zero or more headers that are used as an extension mechanism to pass information in messages that are application-specific. Você pode usar Headers o para adicionar cabeçalhos de mensagem a uma mensagem chamando o Add método.You can use Headers to add message headers to a message by calling the Add method.
O Windows Communication Foundation (WCF) fornece vários cabeçalhos de mensagens predefinidos, conforme mostrado na tabela a seguir.Windows Communication Foundation (WCF) provides a number of predefined message headers, as shown in the following table.
| Nome do cabeçalhoHeader Name | DescriçãoDescription |
|---|---|
| ParaTo | Contém a função para a qual a mensagem está direcionando.Contains the role that the message is targeting. |
| AçãoAction | Fornece uma descrição de como a mensagem deve ser processada.Provides a description of how the message should be processed. |
| FaultToFaultTo | Contém o endereço do nó para o qual as falhas devem ser enviadas.Contains the address of the node to which faults should be sent. |
| DeFrom | Contém o endereço do nó que enviou a mensagem.Contains the address of the node that sent the message. |
| SolicitaçãoRequest | Indica se a mensagem é uma solicitação.Indicates whether the message is a request. |
| MessageIDMessageID | Contém a ID exclusiva da mensagem.Contains the unique ID of the message. |
| RelatesToRelatesTo | Contém as IDs de mensagens relacionadas a esta mensagem.Contains the IDs of messages that are related to this message. |
| ReplyToReplyTo | Contém o endereço do nó para o qual uma resposta deve ser enviada para uma solicitação.Contains the address of the node to which a reply should be sent for a request. |
Construtores
| MessageHeader() |
Inicializa uma nova instância da classe MessageHeader.Initializes a new instance of the MessageHeader class. |
Propriedades
| Actor |
Obtém ou define o destinatário almejado do cabeçalho da mensagem.Gets or sets the targeted recipient of the message header. |
| IsReferenceParameter |
Obtém um valor que especifica se esse cabeçalho de mensagem contém parâmetros de referência de uma referência de ponto de extremidade.Gets a value that specifies whether this message header contains reference parameters of an endpoint reference. |
| MustUnderstand |
Obtém ou define um valor que indica se o cabeçalho deve ser compreendido, de acordo com a especificação de SOAP 1.1/1.2.Gets or sets a value that indicates whether the header must be understood, according to SOAP 1.1/1.2 specification. |
| Name |
Obtém o nome do cabeçalho da mensagem.Gets the name of the message header. (Herdado de MessageHeaderInfo) |
| Namespace |
Obtém o namespace do cabeçalho da mensagem.Gets the namespace of the message header. (Herdado de MessageHeaderInfo) |
| Relay |
Obtém um valor que indica se o cabeçalho deve ser retransmitido.Gets a value that indicates whether the header should be relayed. |
Métodos
| CreateHeader(String, String, Object) |
Cria um novo cabeçalho de mensagem com os dados especificados.Creates a new message header with the specified data. |
| CreateHeader(String, String, Object, Boolean) |
Cria um novo cabeçalho de mensagem com os dados especificados.Creates a new message header with the specified data. |
| CreateHeader(String, String, Object, Boolean, String) |
Cria um novo cabeçalho de mensagem com os dados especificados.Creates a new message header with the specified data. |
| CreateHeader(String, String, Object, Boolean, String, Boolean) |
Cria um novo cabeçalho de mensagem com os dados especificados.Creates a new message header with the specified data. |
| CreateHeader(String, String, Object, XmlObjectSerializer) |
Cria um cabeçalho de um objeto a ser serializado usando o XmlFormatter.Creates a header from an object to be serialized using the XmlFormatter. |
| CreateHeader(String, String, Object, XmlObjectSerializer, Boolean) |
Cria um novo cabeçalho de mensagem com os dados especificados.Creates a new message header with the specified data. |
| CreateHeader(String, String, Object, XmlObjectSerializer, Boolean, String) |
Cria um novo cabeçalho de mensagem com os dados especificados.Creates a new message header with the specified data. |
| CreateHeader(String, String, Object, XmlObjectSerializer, Boolean, String, Boolean) |
Cria um novo cabeçalho de mensagem com os dados especificados.Creates a new message header with the specified data. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object. (Herdado de Object) |
| GetHashCode() |
Serve como a função de hash padrão.Serves as the default hash function. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual.Gets the Type of the current instance. (Herdado de Object) |
| IsMessageVersionSupported(MessageVersion) |
Verifica se a versão da mensagem especificada é compatível.Verifies whether the specified message version is supported. |
| MemberwiseClone() |
Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object. (Herdado de Object) |
| OnWriteHeaderContents(XmlDictionaryWriter, MessageVersion) |
Chamado quando o conteúdo do cabeçalho for serializado usando o gravador XML especificado.Called when the header content is serialized using the specified XML writer. |
| OnWriteStartHeader(XmlDictionaryWriter, MessageVersion) |
Chamado quando o cabeçalho inicial é serializado usando o gravador XML especificado.Called when the start header is serialized using the specified XML writer. |
| ToString() |
Retorna a representação de cadeia de caracteres do cabeçalho desta mensagem.Returns the string representation of this message header. |
| WriteHeader(XmlDictionaryWriter, MessageVersion) |
Serializa o cabeçalho usando o gravador XML especificado.Serializes the header using the specified XML writer. |
| WriteHeader(XmlWriter, MessageVersion) |
Serializa o cabeçalho usando o gravador XML especificado.Serializes the header using the specified XML writer. |
| WriteHeaderAttributes(XmlDictionaryWriter, MessageVersion) |
Serializa os atributos de cabeçalho usando o gravador XML especificado.Serializes the header attributes using the specified XML writer. |
| WriteHeaderContents(XmlDictionaryWriter, MessageVersion) |
Serializa o conteúdo do cabeçalho usando o gravador XML especificado.Serializes the header contents using the specified XML writer. |
| WriteStartHeader(XmlDictionaryWriter, MessageVersion) |
Serializa o cabeçalho inicial usando o gravador XML especificado.Serializes the start header using the specified XML writer. |