AddressHeader Classe

Referência

Definição

Namespace:: System.ServiceModel.Channels

Assembly:: System.ServiceModel.Primitives.dll

Assembly:: System.ServiceModel.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Representa um cabeçalho que encapsula um item de informação de endereço usado para identificar ou interagir com um ponto de extremidade.

public ref class AddressHeader abstract

public abstract class AddressHeader

type AddressHeader = class

Public MustInherit Class AddressHeader

Herança: Object
AddressHeader

Exemplos

O exemplo a seguir mostra como criar cabeçalhos de endereço, acessar suas propriedades, adicioná-los a um ponto de extremidade de serviço e hospedar o serviço usando o ponto de extremidade.


// Name property
AddressHeader addressHeaderWithName = AddressHeader.CreateAddressHeader("MyServiceName", "http://localhost:8000/service",1);
string addressHeaderName = addressHeaderWithName.Name;

//Put snippet here.
// Namespace property
AddressHeader addressHeaderWithNS = AddressHeader.CreateAddressHeader("MyServiceName", "http://localhost:8000/service",1);
string addressHeaderNS = addressHeaderWithNS.Namespace;

// Obsolete

// Obsolete

// Create address headers for special services and add them to an array
AddressHeader addressHeader1 = AddressHeader.CreateAddressHeader("specialservice1", "http://localhost:8000/service", 1);
AddressHeader addressHeader2 = AddressHeader.CreateAddressHeader("specialservice2", "http://localhost:8000/service", 2);
AddressHeader[] addressHeaders = new AddressHeader[2] { addressHeader1, addressHeader2 };

// Endpoint address constructor with URI and address headers
EndpointAddress endpointAddressWithHeaders = new EndpointAddress(
    new Uri("http://localhost/silverlightsamples/service1"), addressHeaders
    );

// Confirm adddressHeader1 is in endpointAddressWithHeaders - boolHeaders returns True.
AddressHeaderCollection addressHeaderCollection = endpointAddressWithHeaders.Headers;
bool boolHeaders = addressHeaderCollection.Contains(addressHeader1);

//Create address headers with XmlObjectSerializer specified
XmlObjectSerializer serializer = new DataContractSerializer(typeof(int));
AddressHeader addressHeaderWithObjSer = AddressHeader.CreateAddressHeader("MyServiceName", "http://localhost:8000/service", 1, serializer);
int value = addressHeaderWithObjSer.GetValue<int>();


// Name property
AddressHeader addressHeaderWithName = AddressHeader.CreateAddressHeader("MyServiceName", "http://localhost:8000/service",1);
string addressHeaderName = addressHeaderWithName.Name;

//Put snippet here.
// Namespace property
AddressHeader addressHeaderWithNS = AddressHeader.CreateAddressHeader("MyServiceName", "http://localhost:8000/service",1);
string addressHeaderNS = addressHeaderWithNS.Namespace;

// Obsolete

// Obsolete

// Create address headers for special services and add them to an array
AddressHeader addressHeader1 = AddressHeader.CreateAddressHeader("specialservice1", "http://localhost:8000/service", 1);
AddressHeader addressHeader2 = AddressHeader.CreateAddressHeader("specialservice2", "http://localhost:8000/service", 2);
AddressHeader[] addressHeaders = new AddressHeader[2] { addressHeader1, addressHeader2 };

// Endpoint address constructor with URI and address headers
EndpointAddress endpointAddressWithHeaders = new EndpointAddress(
    new Uri("http://localhost/silverlightsamples/service1"), addressHeaders
    );

// Confirm adddressHeader1 is in endpointAddressWithHeaders - boolHeaders returns True.
AddressHeaderCollection addressHeaderCollection = endpointAddressWithHeaders.Headers;
bool boolHeaders = addressHeaderCollection.Contains(addressHeader1);

//Create address headers with XmlObjectSerializer specified
XmlObjectSerializer serializer = new DataContractSerializer(typeof(int));
AddressHeader addressHeaderWithObjSer = AddressHeader.CreateAddressHeader("MyServiceName", "http://localhost:8000/service", 1, serializer);
int value = addressHeaderWithObjSer.GetValue<int>();


' Name property
Dim addressHeaderWithName As AddressHeader = AddressHeader.CreateAddressHeader("MyServiceName", "http://localhost:8000/service",1)
Dim addressHeaderName As String = addressHeaderWithName.Name

'Put snippet here.
' Namespace property
Dim addressHeaderWithNS As AddressHeader = AddressHeader.CreateAddressHeader("MyServiceName", "http://localhost:8000/service",1)
Dim addressHeaderNS As String = addressHeaderWithNS.Namespace

' Obsolete

' Obsolete

' Create address headers for special services and add them to an array
Dim addressHeader1 As AddressHeader = AddressHeader.CreateAddressHeader("specialservice1", "http://localhost:8000/service", 1)
Dim addressHeader2 As AddressHeader = AddressHeader.CreateAddressHeader("specialservice2", "http://localhost:8000/service", 2)
Dim addressHeaders() As AddressHeader = { addressHeader1, addressHeader2 }

' Endpoint address constructor with URI and address headers
Dim endpointAddressWithHeaders As New EndpointAddress(New Uri("http://localhost/silverlightsamples/service1"), addressHeaders)

' Confirm adddressHeader1 is in endpointAddressWithHeaders - boolHeaders returns True.
Dim addressHeaderCollection As AddressHeaderCollection = endpointAddressWithHeaders.Headers
Dim boolHeaders As Boolean = addressHeaderCollection.Contains(addressHeader1)

'Create address headers with XmlObjectSerializer specified
Dim serializer As XmlObjectSerializer = New DataContractSerializer(GetType(Integer))
Dim addressHeaderWithObjSer As AddressHeader = AddressHeader.CreateAddressHeader("MyServiceName", "http://localhost:8000/service", 1, serializer)
Dim value As Integer = addressHeaderWithObjSer.GetValue(Of Integer)()


' Name property
Dim addressHeaderWithName As AddressHeader = AddressHeader.CreateAddressHeader("MyServiceName", "http://localhost:8000/service",1)
Dim addressHeaderName As String = addressHeaderWithName.Name

'Put snippet here.
' Namespace property
Dim addressHeaderWithNS As AddressHeader = AddressHeader.CreateAddressHeader("MyServiceName", "http://localhost:8000/service",1)
Dim addressHeaderNS As String = addressHeaderWithNS.Namespace

' Obsolete

' Obsolete

' Create address headers for special services and add them to an array
Dim addressHeader1 As AddressHeader = AddressHeader.CreateAddressHeader("specialservice1", "http://localhost:8000/service", 1)
Dim addressHeader2 As AddressHeader = AddressHeader.CreateAddressHeader("specialservice2", "http://localhost:8000/service", 2)
Dim addressHeaders() As AddressHeader = { addressHeader1, addressHeader2 }

' Endpoint address constructor with URI and address headers
Dim endpointAddressWithHeaders As New EndpointAddress(New Uri("http://localhost/silverlightsamples/service1"), addressHeaders)

' Confirm adddressHeader1 is in endpointAddressWithHeaders - boolHeaders returns True.
Dim addressHeaderCollection As AddressHeaderCollection = endpointAddressWithHeaders.Headers
Dim boolHeaders As Boolean = addressHeaderCollection.Contains(addressHeader1)

'Create address headers with XmlObjectSerializer specified
Dim serializer As XmlObjectSerializer = New DataContractSerializer(GetType(Integer))
Dim addressHeaderWithObjSer As AddressHeader = AddressHeader.CreateAddressHeader("MyServiceName", "http://localhost:8000/service", 1, serializer)
Dim value As Integer = addressHeaderWithObjSer.GetValue(Of Integer)()

Comentários

Um AddressHeader é caracterizado por um nome e namespace e tem um valor que contém informações opcionais usadas para identificar ou interagir com um ponto de extremidade. O nome pode ser acessado pela Name propriedade e pelo namespace pela Namespace propriedade.

Construtores

AddressHeader()

Inicializa uma nova instância da classe AddressHeader.

Propriedades

Name	Quando implementada, obtém o nome do cabeçalho de endereço.
Namespace	Quando implementada, obtém o namespace do cabeçalho de endereço.

Métodos

CreateAddressHeader(Object)	Cria uma nova instância da classe AddressHeader com um valor especificado.
CreateAddressHeader(Object, XmlObjectSerializer)	Cria uma nova instância da classe AddressHeader usando um formatador especificado para serializar o item de informação de um objeto especificado.
CreateAddressHeader(String, String, Object)	Cria uma nova instância da classe AddressHeader com um valor, nome e namespace especificados.
CreateAddressHeader(String, String, Object, XmlObjectSerializer)	Cria uma nova instância da classe AddressHeader com um nome e namespace especificados que usam um formatador especificado para serializar o item de informações de um objeto especificado.
Equals(Object)	Determina se o item de informações em um objeto especificado é igual ao objeto contido no cabeçalho de endereço atual.
GetAddressHeaderReader()	Retorna um leitor de XML que pode serializar o objeto de cabeçalho de endereço atual.
GetHashCode()	Fornece um código hash exclusivo para um cabeçalho de endereço.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetValue<T>()	Desserializa o item de informações do cabeçalho de endereço atual para um objeto de um tipo especificado.
GetValue<T>(XmlObjectSerializer)	Desserializa o item de informações do cabeçalho de endereço atual para um objeto de um tipo especificado que usa um formatador especificado para serializar essas informações.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnWriteAddressHeaderContents(XmlDictionaryWriter)	Quando substituído em uma classe derivada, é invocado quando o conteúdo do cabeçalho de endereço é gravado em um arquivo ou fluxo.
OnWriteStartAddressHeader(XmlDictionaryWriter)	Quando substituído em uma classe derivada, é invocado quando o conteúdo do cabeçalho de endereço começa a ser gravado em um arquivo ou fluxo.
ToMessageHeader()	Encapsula o cabeçalho de endereço como um cabeçalho de mensagem.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
WriteAddressHeader(XmlDictionaryWriter)	Grava o cabeçalho de endereço em um arquivo ou fluxo usando um XmlDictionaryWriter especificado.
WriteAddressHeader(XmlWriter)	Grava o cabeçalho de endereço em um arquivo ou fluxo usando um XmlWriter especificado.
WriteAddressHeaderContents(XmlDictionaryWriter)	Grava o conteúdo do cabeçalho de endereço em um fluxo ou arquivo.
WriteStartAddressHeader(XmlDictionaryWriter)	Começa a gravar o conteúdo do cabeçalho de endereço em um fluxo ou arquivo.

Aplica-se a