XmlMessageFormatter.TargetTypeNames Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Задает набор возможных типов, десериализация которых будет выполняться модулем форматирования из тела предоставляемого сообщения.
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, setPublic Property TargetTypeNames As String()Значение свойства
Массив типа String, задающий типы объектов, десериализуемых из тела сообщения при чтении данного сообщения.
- Атрибуты
Исключения
Значение свойства TargetTypeNames — null.
Комментарии
TargetTypeNames Свойства и TargetTypes сообщают форматировщику, какие схемы следует пытаться сопоставить при десериализации сообщения. Это позволяет форматировщику интерпретировать текст сообщения.
Экземпляр, сериализованный в тексте сообщения, должен соответствовать одной из схем, представленных в массиве типов. При чтении сообщения с помощью Receive метода метод создает объект типа, соответствующий определенной схеме, и считывает в него текст сообщения.
При чтении из очереди необходимо задать только одно из двух свойств, но можно задать оба свойства. Набор типов — это объединенный набор из двух свойств. Решение о том, какое свойство следует использовать, зависит от вашего приложения. Если текст сообщения содержит тип, схема которого не соответствует ни одному из типов в массиве для любого из свойств, при чтении сообщения будет возникать исключение.
TargetTypeNames требует, чтобы каждая запись была полной, указывая имя сборки. Кроме того, при работе с несколькими параллельными версиями к имени целевого типа также необходимо добавить номер версии.
Целевые типы требуются только при чтении из очереди. Свойства TargetTypeNames и TargetTypes не нужно задавать для записи в очередь.
