AddressHeader.CreateAddressHeader Méthode

Définition

Espace de noms:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Paquet:

System.ServiceModel.Primitives v6.2.0

Crée une instance de la classe AddressHeader.

Surcharges

CreateAddressHeader(Object)	Crée une nouvelle instance de la classe AddressHeader avec une valeur spécifiée.
CreateAddressHeader(Object, XmlObjectSerializer)	Crée une instance de la classe AddressHeader à l'aide d'un formateur spécifié pour sérialiser l'élément d'informations à partir d'un objet spécifié.
CreateAddressHeader(String, String, Object)	Crée une instance de la classe AddressHeader avec une valeur, un nom et un espace de noms spécifiés.
CreateAddressHeader(String, String, Object, XmlObjectSerializer)	Crée une instance de la classe AddressHeader avec un nom et un espace de noms spécifiés qui utilise un formateur spécifié pour sérialiser l'élément d'informations à partir d'un objet spécifié.

Remarques

L'objet qui contient l'élément d'informations est sérialisé dans l'en-tête d'adresse par un objet XmlObjectSerializer.

CreateAddressHeader(Object)

Source:

AddressHeader.cs

Crée une nouvelle instance de la classe AddressHeader avec une valeur spécifiée.

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

Paramètres

value

Object

Élément d'information relatif à l'en-tête d'adresse.

Retours

AddressHeader

AddressHeader qui contient l'élément d'informations spécifié par le paramètre value.

Exemples

L'exemple suivant illustre la création d'un en-tête d'adresse à l'aide de la méthode.

// Obsolete

// Obsolete

' Obsolete

' Obsolete

CreateAddressHeader(Object, XmlObjectSerializer)

Source:

AddressHeader.cs

Crée une instance de la classe AddressHeader à l'aide d'un formateur spécifié pour sérialiser l'élément d'informations à partir d'un objet spécifié.

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

Paramètres

value

Object

Élément d'information relatif à l'en-tête d'adresse.

serializer

XmlObjectSerializer

XmlObjectSerializer utilisé pour sérialiser l'objet spécifié dans le paramètre value.

Retours

AddressHeader

AddressHeader qui contient l'élément d'informations spécifié par le paramètre value.

Exceptions

ArgumentNullException

formatter a la valeur null.

Exemples

L'exemple suivant illustre la création d'un en-tête d'adresse à l'aide de la méthode.

// Obsolete

// Obsolete

' Obsolete

' Obsolete

CreateAddressHeader(String, String, Object)

Source:

AddressHeader.cs

Crée une instance de la classe AddressHeader avec une valeur, un nom et un espace de noms spécifiés.

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

Paramètres

name

String

Nom de l'en-tête d'adresse.

ns

String

Espace de noms de l'en-tête d'adresse.

value

Object

Élément d'information relatif à l'en-tête d'adresse.

Retours

AddressHeader

AddressHeader avec un name et un ns spécifiés qui contient l'élément d'informations spécifié par value.

Exceptions

ArgumentNullException

Le name a la valeur null ou name.Length == 0.

Exemples

L'exemple suivant illustre la création d'un en-tête d'adresse à l'aide de la méthode.

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

Source:

AddressHeader.cs

Crée une instance de la classe AddressHeader avec un nom et un espace de noms spécifiés qui utilise un formateur spécifié pour sérialiser l'élément d'informations à partir d'un objet spécifié.

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

Paramètres

name

String

Nom de l'en-tête d'adresse.

ns

String

Espace de noms de l'en-tête d'adresse.

value

Object

Élément d'information relatif à l'en-tête d'adresse.

serializer

XmlObjectSerializer

XmlObjectSerializer utilisé pour sérialiser l'objet spécifié dans le paramètre value.

Retours

AddressHeader

AddressHeader avec un name et un ns spécifiés qui contient l'élément d'informations spécifié par value.

Exceptions

ArgumentNullException

name ou serializer a la valeur null ou name.Length == 0.

Exemples

L'exemple suivant illustre la création d'un en-tête d'adresse à l'aide de la méthode.

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