AddressHeader.CreateAddressHeader Método

Definição

Cria uma nova instância da classe AddressHeader.

Sobrecargas

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.

Comentários

O objeto que contém o item de informações é serializado no cabeçalho do endereço por um XmlObjectSerializer objeto .

CreateAddressHeader(Object)

Origem:
AddressHeader.cs
Origem:
AddressHeader.cs
Origem:
AddressHeader.cs

Cria uma nova instância da classe AddressHeader com um valor especificado.

public static System.ServiceModel.Channels.AddressHeader CreateAddressHeader (object value);

Parâmetros

value
Object

O item de informações para o cabeçalho de endereço.

Retornos

O AddressHeader que contém o item de informação especificado pelo parâmetro value.

Exemplos

O exemplo a seguir mostra como criar um cabeçalho de endereço usando esse método.

// Obsolete
// Obsolete

Aplica-se a

CreateAddressHeader(Object, XmlObjectSerializer)

Origem:
AddressHeader.cs
Origem:
AddressHeader.cs
Origem:
AddressHeader.cs

Cria uma nova instância da classe AddressHeader usando um formatador especificado para serializar o item de informação de um objeto especificado.

public static System.ServiceModel.Channels.AddressHeader CreateAddressHeader (object value, System.Runtime.Serialization.XmlObjectSerializer serializer);

Parâmetros

value
Object

O item de informações para o cabeçalho de endereço.

serializer
XmlObjectSerializer

O XmlObjectSerializer usado para serializar o objeto especificado no parâmetro value.

Retornos

O AddressHeader que contém o item de informação especificado pelo parâmetro de valor.

Exceções

O formatter é null.

Exemplos

O exemplo a seguir mostra como criar um cabeçalho de endereço usando esse método.

// Obsolete
// Obsolete

Aplica-se a

CreateAddressHeader(String, String, Object)

Origem:
AddressHeader.cs
Origem:
AddressHeader.cs
Origem:
AddressHeader.cs

Cria uma nova instância da classe AddressHeader com um valor, nome e namespace especificados.

public static System.ServiceModel.Channels.AddressHeader CreateAddressHeader (string name, string ns, object value);

Parâmetros

name
String

O nome do cabeçalho de endereço.

ns
String

O namespace do cabeçalho de endereço.

value
Object

O item de informações para o cabeçalho de endereço.

Retornos

O AddressHeader com o name especificado e ns que contém o item de informações especificado por value.

Exceções

O name é null ou name.Length == 0.

Exemplos

O exemplo a seguir mostra como criar um cabeçalho de endereço usando esse método.

// 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 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);

Aplica-se a

CreateAddressHeader(String, String, Object, XmlObjectSerializer)

Origem:
AddressHeader.cs
Origem:
AddressHeader.cs
Origem:
AddressHeader.cs

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.

public static System.ServiceModel.Channels.AddressHeader CreateAddressHeader (string name, string ns, object value, System.Runtime.Serialization.XmlObjectSerializer serializer);

Parâmetros

name
String

O nome do cabeçalho de endereço.

ns
String

O namespace do cabeçalho de endereço.

value
Object

O item de informações para o cabeçalho de endereço.

serializer
XmlObjectSerializer

O XmlObjectSerializer usado para serializar o objeto especificado no parâmetro value.

Retornos

O AddressHeader com o name especificado e ns que contém o item de informações especificado por value.

Exceções

name ou serializer é null ou name.Length == 0.

Exemplos

O exemplo a seguir mostra como criar um cabeçalho de endereço usando esse método.

//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>();
//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>();

Aplica-se a