MessageHeader Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt den Inhalt eines SOAP-Headers dar.
public ref class MessageHeader abstract : System::ServiceModel::Channels::MessageHeaderInfopublic abstract class MessageHeader : System.ServiceModel.Channels.MessageHeaderInfotype MessageHeader = class
inherit MessageHeaderInfoPublic MustInherit Class MessageHeader
Inherits MessageHeaderInfo- Vererbung
Hinweise
Ein Nachrichtenheader enthält optionale Metadaten, die eine von der Message-Klasse gekapselte Nachricht beschreiben.
Message kann über 0 (null) oder mehr Header verfügen, die als Erweiterungsmechanismus zur Weitergabe von Informationen an die anwendungsspezifischen Nachrichten verwendet werden. Sie können Headers verwenden, um einer Nachricht Nachrichtenheader hinzuzufügen, indem Sie die Add-Methode aufrufen.
Windows Communication Foundation (WCF) stellt eine Reihe vordefinierter Nachrichtenheader bereit, wie in der folgenden Tabelle gezeigt.
| Headername | BESCHREIBUNG |
|---|---|
| An | Enthält die Rolle, auf die die Nachricht abzielt. |
| Aktion | Beschreibt, wie die Nachricht verarbeitet werden sollte. |
| FaultTo | Enthält die Adresse des Knotens, an den Fehler gesendet werden sollten. |
| From | Enthält die Adresse des Knotens, der die Nachricht gesendet hat. |
| Anforderung | Gibt an, ob die Nachricht eine Anforderung ist. |
| Meldungs-ID | Enthält die eindeutige ID der Nachricht. |
| RelatesTo | Enthält die IDs der Nachrichten, die zu dieser Nachricht gehören. |
| ReplyTo | Enthält die Adresse des Knotens, an den für eine Anforderung eine Antwort gesendet werden soll. |
Konstruktoren
| MessageHeader() |
Initialisiert eine neue Instanz der MessageHeader-Klasse. |
Eigenschaften
| Actor |
Ruft den Empfänger des Nachrichtenheaders ab oder legt diesen fest. |
| IsReferenceParameter |
Ruft einen Wert ab, der angibt, ob dieser Nachrichtenheader Verweisparameter eines Endpunktverweises enthält. |
| MustUnderstand |
Ruft einen Wert ab, der angibt, ob der Header der SOAP-1.1/1.2-Spezifikation entsprechen muss, oder legt diesen fest. |
| Name |
Ruft den Namen des Nachrichtenheaders ab. (Geerbt von MessageHeaderInfo) |
| Namespace |
Ruft den Namespace des Nachrichtenheaders ab. (Geerbt von MessageHeaderInfo) |
| Relay |
Ruft einen Wert ab, der angibt, ob der Header weitergeleitet werden soll. |
Methoden
| CreateHeader(String, String, Object) |
Erstellt einen neuen Nachrichtenheader mit den angegebenen Daten. |
| CreateHeader(String, String, Object, Boolean) |
Erstellt einen neuen Nachrichtenheader mit den angegebenen Daten. |
| CreateHeader(String, String, Object, Boolean, String) |
Erstellt einen neuen Nachrichtenheader mit den angegebenen Daten. |
| CreateHeader(String, String, Object, Boolean, String, Boolean) |
Erstellt einen neuen Nachrichtenheader mit den angegebenen Daten. |
| CreateHeader(String, String, Object, XmlObjectSerializer) |
Erstellt einen Header aus einem Objekt, das mit dem XmlFormatter serialisiert werden soll. |
| CreateHeader(String, String, Object, XmlObjectSerializer, Boolean) |
Erstellt einen neuen Nachrichtenheader mit den angegebenen Daten. |
| CreateHeader(String, String, Object, XmlObjectSerializer, Boolean, String) |
Erstellt einen neuen Nachrichtenheader mit den angegebenen Daten. |
| CreateHeader(String, String, Object, XmlObjectSerializer, Boolean, String, Boolean) |
Erstellt einen neuen Nachrichtenheader mit den angegebenen Daten. |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
| GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
| IsMessageVersionSupported(MessageVersion) |
Überprüft, ob die angegebene Nachrichtenversion unterstützt wird. |
| MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
| OnWriteHeaderContents(XmlDictionaryWriter, MessageVersion) |
Wird aufgerufen, wenn der Headerinhalt mit dem angegebenen XML-Writer serialisiert wird. |
| OnWriteStartHeader(XmlDictionaryWriter, MessageVersion) |
Wird aufgerufen, wenn der Startheader mit dem angegebenen XML-Writer serialisiert wird. |
| ToString() |
Gibt eine Zeichenfolgendarstellung dieses Meldungsheaders zurück. |
| WriteHeader(XmlDictionaryWriter, MessageVersion) |
Serialisiert den Header mit dem angegebenen XML-Writer. |
| WriteHeader(XmlWriter, MessageVersion) |
Serialisiert den Header mit dem angegebenen XML-Writer. |
| WriteHeaderAttributes(XmlDictionaryWriter, MessageVersion) |
Serialisiert das Headerattribut mit dem angegebenen XML-Writer. |
| WriteHeaderContents(XmlDictionaryWriter, MessageVersion) |
Serialisiert den Headerinhalt mit dem angegebenen XML-Writer. |
| WriteStartHeader(XmlDictionaryWriter, MessageVersion) |
Serialisiert den Startheader mit dem angegebenen XML-Writer. |
