Поделиться через

XmlMessageFormatter.TargetTypeNames Свойство

  • Ссылка

Определение

Пространство имен:
System.Messaging
Сборка:
System.Messaging.dll

Задает набор возможных типов, десериализация которых будет выполняться модулем форматирования из тела предоставляемого сообщения.

public:
 property cli::array <System::String ^> ^ TargetTypeNames { cli::array <System::String ^> ^ get(); void set(cli::array <System::String ^> ^ value); };
[System.Messaging.MessagingDescription("XmlMsgTargetTypeNames")]
public string[] TargetTypeNames { get; set; }
[<System.Messaging.MessagingDescription("XmlMsgTargetTypeNames")>]
member this.TargetTypeNames : string[] with get, set
Public Property TargetTypeNames As String()

Значение свойства

String[]

Массив типа String, задающий типы объектов, десериализуемых из тела сообщения при чтении данного сообщения.

Атрибуты
MessagingDescriptionAttribute

Исключения

ArgumentNullException

Значение свойства TargetTypeNames — null.

Комментарии

TargetTypeNames Свойства и TargetTypes сообщают форматировщику, какие схемы следует пытаться сопоставить при десериализации сообщения. Это позволяет форматировщику интерпретировать текст сообщения.

Экземпляр, сериализованный в тексте сообщения, должен соответствовать одной из схем, представленных в массиве типов. При чтении сообщения с помощью Receive метода метод создает объект типа, соответствующий определенной схеме, и считывает в него текст сообщения.

При чтении из очереди необходимо задать только одно из двух свойств, но можно задать оба свойства. Набор типов — это объединенный набор из двух свойств. Решение о том, какое свойство следует использовать, зависит от вашего приложения. Если текст сообщения содержит тип, схема которого не соответствует ни одному из типов в массиве для любого из свойств, при чтении сообщения будет возникать исключение.

TargetTypeNames требует, чтобы каждая запись была полной, указывая имя сборки. Кроме того, при работе с несколькими параллельными версиями к имени целевого типа также необходимо добавить номер версии.

Целевые типы требуются только при чтении из очереди. Свойства TargetTypeNames и TargetTypes не нужно задавать для записи в очередь.

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

См. также раздел