MessageProperties MessageProperties MessageProperties MessageProperties Class

Definition

Stellt eine Gruppe von Eigenschaften für eine Nachricht dar.Represents a set of properties for a message. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

public ref class MessageProperties sealed : IDisposable, System::Collections::Generic::ICollection<System::Collections::Generic::KeyValuePair<System::String ^, System::Object ^>>, System::Collections::Generic::IDictionary<System::String ^, System::Object ^>, System::Collections::Generic::IEnumerable<System::Collections::Generic::KeyValuePair<System::String ^, System::Object ^>>
public sealed class MessageProperties : IDisposable, System.Collections.Generic.ICollection<System.Collections.Generic.KeyValuePair<string,object>>, System.Collections.Generic.IDictionary<string,object>, System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<string,object>>
type MessageProperties = class
    interface IDictionary<string, obj>
    interface ICollection<KeyValuePair<string, obj>>
    interface seq<KeyValuePair<string, obj>>
    interface IEnumerable
    interface IDisposable
Public NotInheritable Class MessageProperties
Implements ICollection(Of KeyValuePair(Of String, Object)), IDictionary(Of String, Object), IDisposable, IEnumerable(Of KeyValuePair(Of String, Object))
Vererbung
MessagePropertiesMessagePropertiesMessagePropertiesMessageProperties
Implementiert

Hinweise

Wird eine Nachricht durch die Kanalinfrastruktur gesendet, wird sie durch eine Reihe logischer separater Verarbeitungsentitäten geleitet.As a message passes through the channel infrastructure, it passes through a number of logically separate processing entities. Beispielsweise kann eine Nachricht, die Teil eines zuverlässigen Messaging-Streams ist, potenziell einen MessageEncoder, einen Channelanbieter auf Transportebene, den zuverlässigen Messaging-Channelanbieter, den Streaming-Channelanbieter oder beliebige Channelerweiterungen durchlaufen.For instance, a message that is part of a reliable messaging stream can potentially pass through a MessageEncoder, a transport-level channel provider, the reliable-messaging channel provider, the streaming channel provider or any channel extensions. Manchmal kommentieren diese Vermittler die Nachricht mithilfe der MessageProperties-Klasse mit den Ergebnissen dieser Verarbeitungsvorgänge.Sometimes these intermediaries annotate the message with the results of that processing by using the MessageProperties class. Eine MessageProperties-Instanz ist eine Anmerkung zu einer Nachricht und wird als ein Satz von Name-Objekt-Zuordnungen in der Properties-Eigenschaft einer Message-Instanz gespeichert.A MessageProperties instance is an annotation on a message and is stored as a set of name-to-object mappings in the Properties property of a Message instance.

Hinweis

Die Nachrichten Eigenschaften sollten gelöscht werden, wenn der Benutzer die folgende Fehlermeldung erhält:The message properties should be cleared out when the user gets the following error:

**der Server hat eine Protokoll Verletzung committet. Section = Response Body Detail = Antwort Block Format ist ungültig @ no__t-0The server committed a protocol violation. Section=ResponseBody Detail=Response chunk format is invalid

Konstruktoren

MessageProperties() MessageProperties() MessageProperties() MessageProperties()

Initialisiert eine neue Instanz der MessageProperties-Klasse.Initializes a new instance of the MessageProperties class.

MessageProperties(MessageProperties) MessageProperties(MessageProperties) MessageProperties(MessageProperties) MessageProperties(MessageProperties)

Initialisiert eine neue Instanz der MessageProperties-Klasse mit vorgegebenen Eigenschaften.Initializes a new instance of the MessageProperties class with preset properties.

Eigenschaften

AllowOutputBatching AllowOutputBatching AllowOutputBatching AllowOutputBatching

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob die Nachricht gespeichert werden soll, bevor sie zum Transport weitergeleitet wird.Gets or sets a value that specifies whether to store this message before giving it to the transport.

Count Count Count Count

Ruft die Gesamtanzahl der Eigenschaften in den MessageProperties ab.Gets the total number of properties in the MessageProperties.

Encoder Encoder Encoder Encoder

Ruft den Encoder ab, der zum Schreiben von Nachrichten in einen Stream und Lesen von Nachrichten aus einem Stream dient.Gets the encoder that is used to write messages to a stream and to read messages from a stream.

IsFixedSize IsFixedSize IsFixedSize IsFixedSize

Ruft einen Wert ab, der angibt, ob die MessageProperties eine feste Größe hat.Gets a value that indicates whether the MessageProperties has a fixed size.

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

Ruft einen Wert ab, der angibt, ob dieser Satz Eigenschaften schreibgeschützt ist.Gets a value that indicates whether this set of properties is read-only.

Item[String] Item[String] Item[String] Item[String]

Ruft eine Eigenschaft mit dem angegebenen Namen, Bezeichner oder Schlüsselwert ab.Retrieves a property with the specified name, identifier, or key value.

Keys Keys Keys Keys

Ruft eine ICollection ab, die die Schlüssel im MessageProperties enthält.Gets an ICollection that contains the keys in the MessageProperties.

Security Security Security Security

Übernimmt oder bestimmt die sicherheitsbezogene Eigenschaft einer Nachricht.Gets or sets the security-related property of a message.

Values Values Values Values

Ruft ein ICollection ab, das die Werte im MessageProperties enthält.Gets an ICollection that contains the values in the MessageProperties.

Via Via Via Via

Ruft die Transportadresse ab, die verwendet wird, um Nachrichten zu senden, oder legt diese fest.Gets or sets the transport address that is used to send messages.

Methoden

Add(String, Object) Add(String, Object) Add(String, Object) Add(String, Object)

Fügt der MessageProperties-Auflistung ein Element mit dem angegebenen Namen und der Eigenschaft hinzu.Adds an element with the specified name and property into the MessageProperties collection.

Clear() Clear() Clear() Clear()

Entfernt alle Elemente aus der MessageProperties-Auflistung.Removes all elements from the MessageProperties collection.

ContainsKey(String) ContainsKey(String) ContainsKey(String) ContainsKey(String)

Bestimmt, ob MessageProperties einen bestimmten Namen, einen Schlüssel oder einen Bezeichner enthält.Determines whether the MessageProperties contains a specific name, key, or identifier.

CopyProperties(MessageProperties) CopyProperties(MessageProperties) CopyProperties(MessageProperties) CopyProperties(MessageProperties)

Kopiert den Inhalt des angegebenen MessageProperties in diese Instanz.Copies the content of the specified MessageProperties to this instance.

Dispose() Dispose() Dispose() Dispose()

Gibt alle von der MessageProperties-Klasse verwendeten Ressourcen frei.Releases all resources used by the MessageProperties class.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
Remove(String) Remove(String) Remove(String) Remove(String)

Entfernt das Element mit dem angegebenen Namen aus den MessageProperties.Removes the element with the specified name from the MessageProperties.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)
TryGetValue(String, Object) TryGetValue(String, Object) TryGetValue(String, Object) TryGetValue(String, Object)

Bestimmt, ob die MessageProperties einen bestimmten Namen enthalten, und ruft den Wert ab.Determines whether the MessageProperties contains a specific name, and retrieves its value.

Explizite Schnittstellenimplementierungen

ICollection<KeyValuePair<String,Object>>.Add(KeyValuePair<String,Object>) ICollection<KeyValuePair<String,Object>>.Add(KeyValuePair<String,Object>) ICollection<KeyValuePair<String,Object>>.Add(KeyValuePair<String,Object>) ICollection<KeyValuePair<String,Object>>.Add(KeyValuePair<String,Object>)

Fügt den MessageProperties ein Element mit dem angegebenen Namen und der Eigenschaft hinzu.Adds an element with the specified name and property into the MessageProperties.

ICollection<KeyValuePair<String,Object>>.Contains(KeyValuePair<String,Object>) ICollection<KeyValuePair<String,Object>>.Contains(KeyValuePair<String,Object>) ICollection<KeyValuePair<String,Object>>.Contains(KeyValuePair<String,Object>) ICollection<KeyValuePair<String,Object>>.Contains(KeyValuePair<String,Object>)

Bestimmt, ob die MessageProperties einen bestimmten Namen enthalten.Determines whether the MessageProperties contains a specific name.

ICollection<KeyValuePair<String,Object>>.CopyTo(KeyValuePair<String,Object>[], Int32) ICollection<KeyValuePair<String,Object>>.CopyTo(KeyValuePair<String,Object>[], Int32) ICollection<KeyValuePair<String,Object>>.CopyTo(KeyValuePair<String,Object>[], Int32) ICollection<KeyValuePair<String,Object>>.CopyTo(KeyValuePair<String,Object>[], Int32)

Kopiert die Elemente der angegebenen MessageProperties in ein Array, beginnend am angegebenen Index.Copies the content of the specified MessageProperties to an array, starting at the specified index.

ICollection<KeyValuePair<String,Object>>.IsReadOnly ICollection<KeyValuePair<String,Object>>.IsReadOnly ICollection<KeyValuePair<String,Object>>.IsReadOnly ICollection<KeyValuePair<String,Object>>.IsReadOnly
ICollection<KeyValuePair<String,Object>>.Remove(KeyValuePair<String,Object>) ICollection<KeyValuePair<String,Object>>.Remove(KeyValuePair<String,Object>) ICollection<KeyValuePair<String,Object>>.Remove(KeyValuePair<String,Object>) ICollection<KeyValuePair<String,Object>>.Remove(KeyValuePair<String,Object>)

Entfernt das Element mit dem angegebenen Namen aus den MessageProperties.Removes the element with the specified name from the MessageProperties.

IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator()

Gibt einen Enumerator zurück, der eine Auflistung durchlaufen kann.Returns an enumerator that can iterate through a collection.

IEnumerable<KeyValuePair<String,Object>>.GetEnumerator() IEnumerable<KeyValuePair<String,Object>>.GetEnumerator() IEnumerable<KeyValuePair<String,Object>>.GetEnumerator() IEnumerable<KeyValuePair<String,Object>>.GetEnumerator()

Gibt einen Enumerator zurück, der eine Auflistung durchlaufen kann.Returns an enumerator that can iterate through a collection.

Erweiterungsmethoden

CopyToDataTable<T>(IEnumerable<T>) CopyToDataTable<T>(IEnumerable<T>) CopyToDataTable<T>(IEnumerable<T>) CopyToDataTable<T>(IEnumerable<T>)

Gibt eine DataTable zurück, die Kopien der DataRow-Objekte enthält, wenn ein IEnumerable<T>-Eingabeobjekt vorhanden ist, bei dem der generische Parameter T den Wert DataRow hat.Returns a DataTable that contains copies of the DataRow objects, given an input IEnumerable<T> object where the generic parameter T is DataRow.

CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption) CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption) CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption) CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption)

Kopiert DataRow-Objekte in die angegebene DataTable, bei einem IEnumerable<T>-Eingabeobjekt, bei dem der generische Parameter T den Wert DataRow aufweist.Copies DataRow objects to the specified DataTable, given an input IEnumerable<T> object where the generic parameter T is DataRow.

CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption, FillErrorEventHandler) CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption, FillErrorEventHandler) CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption, FillErrorEventHandler) CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption, FillErrorEventHandler)

Kopiert DataRow-Objekte in die angegebene DataTable, bei einem IEnumerable<T>-Eingabeobjekt, bei dem der generische Parameter T den Wert DataRow aufweist.Copies DataRow objects to the specified DataTable, given an input IEnumerable<T> object where the generic parameter T is DataRow.

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Wandelt die Elemente eines IEnumerable in den angegebenen Typ umCasts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Filtert die Elemente eines IEnumerable anhand eines angegebenen TypsFilters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Ermöglicht die Parallelisierung einer Abfrage.Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Konvertiert einen IEnumerable in einen IQueryable.Converts an IEnumerable to an IQueryable.

Ancestors<T>(IEnumerable<T>) Ancestors<T>(IEnumerable<T>) Ancestors<T>(IEnumerable<T>) Ancestors<T>(IEnumerable<T>)

Gibt eine Auflistung von Elementen zurück, die die übergeordneten Elemente der einzelnen Knoten in der Quellauflistung enthält.Returns a collection of elements that contains the ancestors of every node in the source collection.

Ancestors<T>(IEnumerable<T>, XName) Ancestors<T>(IEnumerable<T>, XName) Ancestors<T>(IEnumerable<T>, XName) Ancestors<T>(IEnumerable<T>, XName)

Gibt eine gefilterte Auflistung von Elementen zurück, die die übergeordneten Elemente der einzelnen Knoten in der Quellauflistung enthält.Returns a filtered collection of elements that contains the ancestors of every node in the source collection. Nur Elemente, die über einen übereinstimmenden XName verfügen, sind in der Auflistung enthalten.Only elements that have a matching XName are included in the collection.

DescendantNodes<T>(IEnumerable<T>) DescendantNodes<T>(IEnumerable<T>) DescendantNodes<T>(IEnumerable<T>) DescendantNodes<T>(IEnumerable<T>)

Gibt eine Auflistung der Nachfolgerknoten jedes Dokuments und Elements in der Quellauflistung zurück.Returns a collection of the descendant nodes of every document and element in the source collection.

Descendants<T>(IEnumerable<T>) Descendants<T>(IEnumerable<T>) Descendants<T>(IEnumerable<T>) Descendants<T>(IEnumerable<T>)

Gibt eine Auflistung von Elementen zurück, die die Nachfolgerelemente jedes Elements und Dokuments in der Quellauflistung enthält.Returns a collection of elements that contains the descendant elements of every element and document in the source collection.

Descendants<T>(IEnumerable<T>, XName) Descendants<T>(IEnumerable<T>, XName) Descendants<T>(IEnumerable<T>, XName) Descendants<T>(IEnumerable<T>, XName)

Gibt eine gefilterte Auflistung von Elementen zurück, die die Nachfolgerelemente jedes Elements und Dokuments in der Quellauflistung enthält.Returns a filtered collection of elements that contains the descendant elements of every element and document in the source collection. Nur Elemente, die über einen übereinstimmenden XName verfügen, sind in der Auflistung enthalten.Only elements that have a matching XName are included in the collection.

Elements<T>(IEnumerable<T>) Elements<T>(IEnumerable<T>) Elements<T>(IEnumerable<T>) Elements<T>(IEnumerable<T>)

Gibt eine Auflistung der untergeordneten Elemente jedes Elements und Dokuments in der Quellauflistung zurück.Returns a collection of the child elements of every element and document in the source collection.

Elements<T>(IEnumerable<T>, XName) Elements<T>(IEnumerable<T>, XName) Elements<T>(IEnumerable<T>, XName) Elements<T>(IEnumerable<T>, XName)

Gibt eine gefilterte Auflistung der untergeordneten Elemente jedes Elements und Dokuments in der Quellauflistung zurück.Returns a filtered collection of the child elements of every element and document in the source collection. Nur Elemente, die über einen übereinstimmenden XName verfügen, sind in der Auflistung enthalten.Only elements that have a matching XName are included in the collection.

InDocumentOrder<T>(IEnumerable<T>) InDocumentOrder<T>(IEnumerable<T>) InDocumentOrder<T>(IEnumerable<T>) InDocumentOrder<T>(IEnumerable<T>)

Gibt eine in Dokumentreihenfolge sortierte Auflistung von Knoten zurück, die alle Knoten in der Quellauflistung enthält.Returns a collection of nodes that contains all nodes in the source collection, sorted in document order.

Nodes<T>(IEnumerable<T>) Nodes<T>(IEnumerable<T>) Nodes<T>(IEnumerable<T>) Nodes<T>(IEnumerable<T>)

Gibt eine Auflistung der untergeordneten Knoten jedes Dokuments und Elements in der Quellauflistung zurück.Returns a collection of the child nodes of every document and element in the source collection.

Remove<T>(IEnumerable<T>) Remove<T>(IEnumerable<T>) Remove<T>(IEnumerable<T>) Remove<T>(IEnumerable<T>)

Entfernt jeden Knoten in der Quellauflistung aus seinem übergeordneten Knoten.Removes every node in the source collection from its parent node.

Gilt für: