AddressHeader Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Representa um cabeçalho que encapsula um item de informação de endereço usado para identificar ou interagir com um endpoint.
public ref class AddressHeader abstract
public abstract class AddressHeader
type AddressHeader = class
Public MustInherit Class AddressHeader
- Herança
-
AddressHeader
Exemplos
O exemplo seguinte mostra como criar cabeçalhos de endereço, aceder às suas propriedades, adicioná-los a um endpoint de serviço e alojar o serviço usando esse endpoint.
// 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)()
Observações
Um AddressHeader é caracterizado por um nome e espaço de nomes e tem um valor que contém informação opcional usada para identificar ou interagir com um endpoint. O nome pode ser acedido pela Name propriedade e o namespace pela propriedade Namespace .
Construtores
| Name | Description |
|---|---|
| AddressHeader() |
Inicializa uma nova instância da AddressHeader classe. |
Propriedades
| Name | Description |
|---|---|
| Name |
Quando implementado, recebe o nome do cabeçalho do endereço. |
| Namespace |
Quando implementado, obtém o namespace do cabeçalho do endereço. |
Métodos
| Name | Description |
|---|---|
| CreateAddressHeader(Object, XmlObjectSerializer) |
Cria uma nova instância da AddressHeader classe usando um formatador especificado para serializar o item de informação a partir de um objeto especificado. |
| CreateAddressHeader(Object) |
Cria uma nova instância da AddressHeader classe com um valor especificado. |
| CreateAddressHeader(String, String, Object, XmlObjectSerializer) |
Cria uma nova instância da AddressHeader classe com um nome e namespace especificados que utiliza um formateador especificado para serializar o item de informação a partir de um objeto especificado. |
| CreateAddressHeader(String, String, Object) |
Cria uma nova instância da AddressHeader classe com um valor, nome e espaço de nomes especificados. |
| Equals(Object) |
Determina se o item de informação num objeto especificado é igual ao objeto contido no cabeçalho de endereço atual. |
| GetAddressHeaderReader() |
Devolve um leitor XML que pode serializar o objeto cabeçalho de endereço atual. |
| GetHashCode() |
Fornece um código hash único 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ção do cabeçalho de endereço atual para um objeto de um tipo especificado. |
| GetValue<T>(XmlObjectSerializer) |
Desserializa o item de informação do cabeçalho de endereço atual para um objeto de um tipo especificado que utiliza um formateador especificado para serializar essa informação. |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| OnWriteAddressHeaderContents(XmlDictionaryWriter) |
Quando sobreposto numa classe derivada, é invocado quando o conteúdo do cabeçalho do endereço é escrito num fluxo ou ficheiro. |
| OnWriteStartAddressHeader(XmlDictionaryWriter) |
Quando sobrescrito numa classe derivada, é invocado quando o conteúdo do cabeçalho de endereço começa a ser escrito num fluxo ou ficheiro. |
| ToMessageHeader() |
Envolve o cabeçalho do endereço como cabeçalho de mensagem. |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
| WriteAddressHeader(XmlDictionaryWriter) |
Escreve o cabeçalho do endereço num fluxo ou ficheiro usando um ficheiro especificado XmlDictionaryWriter. |
| WriteAddressHeader(XmlWriter) |
Escreve o cabeçalho do endereço num fluxo ou ficheiro usando um ficheiro especificado XmlWriter. |
| WriteAddressHeaderContents(XmlDictionaryWriter) |
Grava o conteúdo do cabeçalho do endereço num fluxo ou ficheiro. |
| WriteStartAddressHeader(XmlDictionaryWriter) |
Começa a escrever o conteúdo do cabeçalho do endereço num fluxo ou ficheiro. |