MessageProperties MessageProperties MessageProperties MessageProperties Class

Определение

Представляет набор свойств сообщения.Represents a set of properties for a message. Этот класс не наследуется.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))
Наследование
MessagePropertiesMessagePropertiesMessagePropertiesMessageProperties
Реализации

Комментарии

Сообщение, передаваемое через инфраструктуру канала, проходит через ряд логически обособленных обрабатывающих сущностей.As a message passes through the channel infrastructure, it passes through a number of logically separate processing entities. Например, сообщение, будучи частью потока надежных сообщений, может проходить через объект MessageEncoder, поставщик канала транспортного уровня, поставщик канала надежных сообщений, потоковый поставщик канала или через какие-либо другие сущности.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. Иногда эти посредники добавляют к сообщению результаты обработки при помощи класса MessageProperties.Sometimes these intermediaries annotate the message with the results of that processing by using the MessageProperties class. Экземпляр MessageProperties является заметкой, добавленной к сообщению, и хранится как набор сопоставлений имя-объект в свойстве Properties экземпляра Message.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.

Примечание

Свойства сообщения должны быть удалены, когда пользователь возвращает следующую ошибку:The message properties should be cleared out when the user gets the following error:

Сервер нарушил протокол. Раздел = Подробности ResponseBody = ответ имеет недопустимый формат блокаThe server committed a protocol violation. Section=ResponseBody Detail=Response chunk format is invalid

Конструкторы

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

Инициализирует новый экземпляр класса MessageProperties.Initializes a new instance of the MessageProperties class.

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

Инициализирует новый экземпляр класса MessageProperties с предварительно заданными свойствами.Initializes a new instance of the MessageProperties class with preset properties.

Свойства

AllowOutputBatching AllowOutputBatching AllowOutputBatching AllowOutputBatching

Возвращает или задает значение, определяющее, сохраняется ли сообщение перед передачей транспорту.Gets or sets a value that specifies whether to store this message before giving it to the transport.

Count Count Count Count

Возвращает общее количество свойств в объекте MessageProperties.Gets the total number of properties in the MessageProperties.

Encoder Encoder Encoder Encoder

Возвращает кодировщик, который используется для записи сообщений в поток и для чтения сообщений из потока.Gets the encoder that is used to write messages to a stream and to read messages from a stream.

IsFixedSize IsFixedSize IsFixedSize IsFixedSize

Возвращает значение, показывающее, имеет ли объект MessageProperties фиксированный размер.Gets a value that indicates whether the MessageProperties has a fixed size.

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

Возвращает значение, определяющее, является ли данный набор свойств доступным только для чтения.Gets a value that indicates whether this set of properties is read-only.

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

Извлекает свойство с указанным именем, идентификатором или значением ключа.Retrieves a property with the specified name, identifier, or key value.

Keys Keys Keys Keys

Возвращает коллекцию ICollection, которая содержит ключи из MessageProperties.Gets an ICollection that contains the keys in the MessageProperties.

Security Security Security Security

Получает или задает свойство сообщения, связанное с безопасностью.Gets or sets the security-related property of a message.

Values Values Values Values

Возвращает коллекцию ICollection, которая содержит значения в MessageProperties.Gets an ICollection that contains the values in the MessageProperties.

Via Via Via Via

Возвращает или задает адрес транспорта, который используется для отправки сообщений.Gets or sets the transport address that is used to send messages.

Методы

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

Добавляет элемент с указанными именем и свойством в коллекцию MessageProperties.Adds an element with the specified name and property into the MessageProperties collection.

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

Удаляет все элементы из коллекции MessageProperties.Removes all elements from the MessageProperties collection.

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

Определяет, содержит ли MessageProperties указанные имя, ключ или идентификатор.Determines whether the MessageProperties contains a specific name, key, or identifier.

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

Копирует содержимое указанного элемента MessageProperties в данный экземпляр.Copies the content of the specified MessageProperties to this instance.

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

Освобождает все ресурсы, используемые классом MessageProperties.Releases all resources used by the MessageProperties class.

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

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

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

Служит хэш-функцией по умолчанию.Serves as the default hash function.

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

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

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

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

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

Удаляет элемент с указанным именем из объекта MessageProperties.Removes the element with the specified name from the MessageProperties.

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

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

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

Определяет, содержит ли объект MessageProperties указанное имя, и извлекает его значение.Determines whether the MessageProperties contains a specific name, and retrieves its value.

Явные реализации интерфейса

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

Добавляет элемент с указанными именем и свойством в объект MessageProperties.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>)

Определяет, содержит ли объект MessageProperties указанное имя.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)

Копирует содержимое заданного объекта MessageProperties в массив, начиная с указанного индекса.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>)

Удаляет элемент с указанным именем из объекта MessageProperties.Removes the element with the specified name from the MessageProperties.

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

Возвращает перечислитель, который может выполнять итерацию по коллекции.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()

Возвращает перечислитель, который может выполнять итерацию по коллекции.Returns an enumerator that can iterate through a collection.

Методы расширения

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

Возвращает объект DataTable, содержащий копии объектов DataRow при заданном входном объекте IEnumerable<T> и универсальном параметре T, равном DataRow.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)

Копирует объекты DataRow в указанный объект DataTable с заданным входным объектом IEnumerable<T>, где универсальный параметр T имеет значение DataRow.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)

Копирует объекты DataRow в указанный объект DataTable с заданным входным объектом IEnumerable<T>, где универсальный параметр T имеет значение DataRow.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)

Приводит элементы объекта IEnumerable к заданному типу.Casts the elements of an IEnumerable to the specified type.

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

Выполняет фильтрацию элементов объекта IEnumerable по заданному типу.Filters the elements of an IEnumerable based on a specified type.

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

Позволяет осуществлять параллельный запрос.Enables parallelization of a query.

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

Преобразует IEnumerable для IQueryable.Converts an IEnumerable to an IQueryable.

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

Возвращает коллекцию элементов, содержащую предков каждого узла в исходной коллекции.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)

Возвращает отфильтрованную коллекцию элементов, содержащую предков каждого узла в исходной коллекции.Returns a filtered collection of elements that contains the ancestors of every node in the source collection. В коллекцию включаются только элементы, соответствующие XName.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>)

Возвращает коллекцию подчиненных узлов каждого документа и элемента в исходной коллекции.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>)

Возвращает коллекцию элементов, содержащую подчиненные элементы каждого элемента и документа в исходной коллекции.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)

Возвращает отфильтрованную коллекцию элементов, содержащую подчиненные элементы каждого элемента и документа в исходной коллекции.Returns a filtered collection of elements that contains the descendant elements of every element and document in the source collection. В коллекцию включаются только элементы, соответствующие XName.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>)

Возвращает коллекцию дочерних элементов каждого элемента и документа в исходной коллекции.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)

Возвращает отфильтрованную коллекцию дочерних элементов каждого элемента и документа в исходной коллекции.Returns a filtered collection of the child elements of every element and document in the source collection. В коллекцию включаются только элементы, соответствующие XName.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>)

Возвращает коллекцию узлов, содержащую все узлы в исходной коллекции, отсортированные в порядке следования документов.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>)

Возвращает коллекцию дочерних узлов каждого документа и элемента в исходной коллекции.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>)

Удаление каждого узла в исходной коллекции из родительского узла.Removes every node in the source collection from its parent node.

Применяется к