AddressHeader Klasse

Definition

Namespace:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Paket:

System.ServiceModel.Primitives v6.2.0

Quelle:

AddressHeader.cs

Stellt einen Header dar, der ein Adressinformationselement einkapselt, das verwendet wird, um einen Endpunkt zu identifizieren oder mit diesem zu interagieren.

public ref class AddressHeader abstract

public abstract class AddressHeader

type AddressHeader = class

Public MustInherit Class AddressHeader

Vererbung

Object

AddressHeader

Beispiele

Das folgende Beispiel veranschaulicht das Erstellen von Adressheadern, den Zugriff auf ihre Eigenschaften, das Hinzufügen zu einem Dienstendpunkt und das Hosten des Diensts mithilfe des Endpunkts.

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

Hinweise

Ein AddressHeader ist durch einen Namen und einen Namespace gekennzeichnet und verfügt über einen Wert, der optionale Informationen enthält, die verwendet werden, um einen Endpunkt zu identifizieren oder mit diesem zu interagieren. Der Zugriff auf den Namen erfolgt über die Name-Eigenschaft und der Zugriff auf den Namespace über die Namespace-Eigenschaft.

Konstruktoren

AddressHeader()

Initialisiert eine neue Instanz der AddressHeader-Klasse.

Eigenschaften

Name	Ruft den Namen des Adressheaders ab (wenn implementiert).
Namespace	Ruft den Namespace des Adressheaders ab (wenn implementiert).

Methoden

CreateAddressHeader(Object)	Erstellt eine neue Instanz der AddressHeader-Klasse mit einem festgelegten Wert.
CreateAddressHeader(Object, XmlObjectSerializer)	Erstellt eine neue Instanz der AddressHeader-Klasse mithilfe eines festgelegten Formatierers für die Serialisierung des Informationselements aus einem festgelegten Objekt.
CreateAddressHeader(String, String, Object)	Erstellt eine neue Instanz der AddressHeader-Klasse mit einem festgelegten Wert, dem Namen und Namespace.
CreateAddressHeader(String, String, Object, XmlObjectSerializer)	Erstellt eine neue Instanz der AddressHeader-Klasse mit festgelegtem Namen und Namespace, die einen festgelegten Formatierer für die Serialisierung des Informationselements aus einem festgelegten Objekt verwendet.
Equals(Object)	Bestimmt, ob das Informationselement in einem festgelegten Objekt mit dem im aktuellen Adressheader enthaltenen Objekt übereinstimmt.
GetAddressHeaderReader()	Gibt einen XML-Reader zurück, der das aktuelle Adressheaderobjekt serialisieren kann.
GetHashCode()	Stellt einen eindeutigen Hashcode für einen Adressheader bereit.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
GetValue<T>()	Deserialisiert das Informationselement vom aktuellen Adressheader zu einem Objekt eines angegebenen Typs.
GetValue<T>(XmlObjectSerializer)	Deserialisiert das Informationselement vom aktuellen Adressheader zu einem Objekt eines angegebenen Typs, das einen angegebenen Formatierer zur Serialisierung dieser Informationen nutzt.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnWriteAddressHeaderContents(XmlDictionaryWriter)	Wird beim Überschreiben in einer abgeleiteten Klasse aufgerufen, wenn die Inhalte des Adressheaders in einen Stream oder eine Datei geschrieben werden.
OnWriteStartAddressHeader(XmlDictionaryWriter)	Wird beim Überschreiben in einer abgeleiteten Klasse aufgerufen, wenn begonnen wird, die Inhalte des Adressheaders in einen Stream oder eine Datei zu schreiben.
ToMessageHeader()	Bindet den Adressheader als Nachrichtenheader ein.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
WriteAddressHeader(XmlDictionaryWriter)	Schreibt den Adressheader in einen Stream oder eine Datei mit einem angegebenen XmlDictionaryWriter.
WriteAddressHeader(XmlWriter)	Schreibt den Adressheader in einen Stream oder eine Datei mit einem angegebenen XmlWriter.
WriteAddressHeaderContents(XmlDictionaryWriter)	Schreibt den Adressheaderinhalt in einen Stream oder eine Datei.
WriteStartAddressHeader(XmlDictionaryWriter)	Beginnt mit dem Schreiben der Inhalte des Adressheaders in einen Stream oder eine Datei.