AddressHeader.CreateAddressHeader Método

Definição

Namespace:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Pacote:

System.ServiceModel.Primitives v6.2.0

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

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

public:
 static System::ServiceModel::Channels::AddressHeader ^ CreateAddressHeader(System::Object ^ value);

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

static member CreateAddressHeader : obj -> System.ServiceModel.Channels.AddressHeader

Public Shared Function CreateAddressHeader (value As Object) As AddressHeader

Parâmetros

value

Object

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

Retornos

AddressHeader

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

' Obsolete

' Obsolete

CreateAddressHeader(Object, XmlObjectSerializer)

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(System::Object ^ value, System::Runtime::Serialization::XmlObjectSerializer ^ serializer);

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

static member CreateAddressHeader : obj * System.Runtime.Serialization.XmlObjectSerializer -> System.ServiceModel.Channels.AddressHeader

Public Shared Function CreateAddressHeader (value As Object, serializer As XmlObjectSerializer) As AddressHeader

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

AddressHeader

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

Exceções

ArgumentNullException

O formatter é null.

Exemplos

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

// Obsolete

// Obsolete

' Obsolete

' Obsolete

CreateAddressHeader(String, String, Object)

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(System::String ^ name, System::String ^ ns, System::Object ^ value);

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

static member CreateAddressHeader : string * string * obj -> System.ServiceModel.Channels.AddressHeader

Public Shared Function CreateAddressHeader (name As String, ns As String, value As Object) As AddressHeader

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

AddressHeader

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

Exceções

ArgumentNullException

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

' 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 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)

CreateAddressHeader(String, String, Object, XmlObjectSerializer)

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(System::String ^ name, System::String ^ ns, System::Object ^ value, System::Runtime::Serialization::XmlObjectSerializer ^ serializer);

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

static member CreateAddressHeader : string * string * obj * System.Runtime.Serialization.XmlObjectSerializer -> System.ServiceModel.Channels.AddressHeader

Public Shared Function CreateAddressHeader (name As String, ns As String, value As Object, serializer As XmlObjectSerializer) As AddressHeader

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

AddressHeader

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

Exceções

ArgumentNullException

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

'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)()

'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)()