AddressHeader Classe

Définition

Espace de noms:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Assembly:

System.ServiceModel.dll

Représente un en-tête qui encapsule un élément d'informations d'adresse utilisé pour identifier ou interagir avec un point de terminaison.

public ref class AddressHeader abstract

public abstract class AddressHeader

type AddressHeader = class

Public MustInherit Class AddressHeader

Héritage

Object

AddressHeader

Exemples

L'exemple suivant illustre la création des en-têtes d'adresse, l'accès à leurs propriétés, leur ajout à un point de terminaison de service et l'hébergement du service à l'aide du point de terminaison.

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

Remarques

Un AddressHeader se caractérise par un nom et un espace de noms et a une valeur qui contient des informations facultatives utilisées pour identifier ou interagir avec un point de terminaison. Le nom est accessible via la propriété Name et l'espace de noms via la propriété Namespace.

Constructeurs

AddressHeader()

Initialise une nouvelle instance de la classe AddressHeader.

Propriétés

Name	En cas d'implémentation, obtient le nom de l'en-tête d'adresse.
Namespace	En cas d'implémentation, obtient l'espace de noms de l'en-tête d'adresse.

Méthodes

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é.
Equals(Object)	Détermine si l'élément d'informations d'un objet spécifié est identique à l'objet contenu dans l'en-tête d'adresse actuel.
GetAddressHeaderReader()	Retourne un lecteur XML qui peut sérialiser l'objet d'en-tête d'adresse actuel.
GetHashCode()	Fournit un code de hachage unique pour un en-tête d'adresse.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
GetValue<T>()	Désérialise l'élément d'informations de l'en-tête d'adresse actuel en un objet d'un type spécifié.
GetValue<T>(XmlObjectSerializer)	Désérialise l'élément d'informations de l'en-tête d'adresse actuel en un objet d'un type spécifié qui utilise un formateur spécifié pour sérialiser ces informations.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
OnWriteAddressHeaderContents(XmlDictionaryWriter)	En cas de substitution dans une classe dérivée, est appelée lorsque le contenu d'en-tête d'adresse est écrit dans un flux de données ou un fichier.
OnWriteStartAddressHeader(XmlDictionaryWriter)	En cas de substitution dans une classe dérivée, est appelée lorsque le contenu d'en-tête d'adresse commence à être écrit dans un flux de données ou un fichier.
ToMessageHeader()	Encapsule l'en-tête d'adresse en tant qu'en-tête de message.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)
WriteAddressHeader(XmlDictionaryWriter)	Écrit l'en-tête d'adresse dans un flux de données ou un fichier à l'aide d'un XmlDictionaryWriter spécifié.
WriteAddressHeader(XmlWriter)	Écrit l'en-tête d'adresse dans un flux de données ou un fichier à l'aide d'un XmlWriter spécifié.
WriteAddressHeaderContents(XmlDictionaryWriter)	Écrit le contenu d'en-tête d'adresse dans un flux de données ou un fichier.
WriteStartAddressHeader(XmlDictionaryWriter)	Commence à écrire le contenu d'en-tête d'adresse dans un flux de données ou un fichier.