AddressHeader Classe

Riferimento

Definizione

Spazio dei nomi:: System.ServiceModel.Channels

Assembly:: System.ServiceModel.Primitives.dll

Assembly:: System.ServiceModel.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Rappresenta un'intestazione che incapsula un elemento informazione dell'indirizzo usato per identificare o interagire con un endpoint.

public ref class AddressHeader abstract

public abstract class AddressHeader

type AddressHeader = class

Public MustInherit Class AddressHeader

Ereditarietà: Object
AddressHeader

Esempio

Nell'esempio seguente viene illustrato come creare intestazioni di indirizzo, accedere alle rispettive proprietà, aggiungerle a un endpoint del servizio e ospitare il servizio utilizzando l'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)()

Commenti

AddressHeader è caratterizzato da un nome e da uno spazio dei nomi e ha un valore che contiene informazioni facoltative utilizzate per identificare o interagire con un endpoint. È possibile accedere al nome tramite la proprietà Name e allo spazio dei nomi tramite la proprietà Namespace.

Costruttori

AddressHeader()

Inizializza una nuova istanza della classe AddressHeader.

Proprietà

Name	In caso di implementazione, Ottiene il nome dell'intestazione dell'indirizzo.
Namespace	In caso di implementazione, Ottiene lo spazio dei nomi dell'intestazione dell'indirizzo.

Metodi

CreateAddressHeader(Object)	Crea una nuova istanza della classe AddressHeader con il valore specificato.
CreateAddressHeader(Object, XmlObjectSerializer)	Crea una nuova istanza della classe AddressHeader utilizzando il formattatore specificato per serializzare l'elemento informazione da un oggetto specificato.
CreateAddressHeader(String, String, Object)	Crea una nuova istanza della classe AddressHeader con il valore, il nome e lo spazio dei nomi specificati.
CreateAddressHeader(String, String, Object, XmlObjectSerializer)	Crea una nuova istanza della classe AddressHeader con un nome e uno spazio dei nomi specificati, che utilizza un formattatore specificato per serializzare l'elemento informazione da un oggetto specificato.
Equals(Object)	Determina se l'elemento informazione contenuto in un oggetto specificato è uguale all'oggetto contenuto nell'intestazione di indirizzo corrente.
GetAddressHeaderReader()	Restituisce un reader XML in grado di serializzare l'oggetto intestazione dell'indirizzo corrente.
GetHashCode()	Fornisce un codice hash univoco per un'intestazione dell'indirizzo.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
GetValue<T>()	Deserializza l'elemento informazione dall'intestazione dell'indirizzo corrente in un oggetto di un tipo specificato.
GetValue<T>(XmlObjectSerializer)	Deserializza l'elemento informazione dall'intestazione dell'indirizzo corrente in un oggetto di un tipo specificato che utilizza un formattatore specificato per serializzare queste informazioni.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
OnWriteAddressHeaderContents(XmlDictionaryWriter)	Quando sottoposto a override in una classe derivata, viene richiamato quando il contenuto dell'intestazione dell'indirizzo viene scritto in un flusso o in un file.
OnWriteStartAddressHeader(XmlDictionaryWriter)	Quando sottoposto a override in una classe derivata, viene richiamato quando il contenuto dell'intestazione dell'indirizzo inizia a essere scritto in un flusso o in un file.
ToMessageHeader()	Esegue il wrapping dell'intestazione dell'indirizzo come intestazione del messaggio.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
WriteAddressHeader(XmlDictionaryWriter)	Scrive l'intestazione dell'indirizzo in un flusso o in un file utilizzando XmlDictionaryWriter specificato.
WriteAddressHeader(XmlWriter)	Scrive l'intestazione dell'indirizzo in un flusso o in un file utilizzando XmlWriter specificato.
WriteAddressHeaderContents(XmlDictionaryWriter)	Scrive il contenuto dell'intestazione dell'indirizzo in un flusso o in un file.
WriteStartAddressHeader(XmlDictionaryWriter)	Inizia a scrivere il contenuto dell'intestazione dell'indirizzo in un flusso o in un file.

Si applica a