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 требует, чтобы каждая запись была полной, указывая ее имя сборки. Кроме того, при работе с несколькими параллельными версиями номер версии также должен быть добавлен к имени целевого типа.
Целевые типы необходимы только при чтении из очереди. TargetTypes Свойства TargetTypeNames не должны быть заданы для записи в очередь.
