XmlMessageFormatter.TargetTypeNames Свойство

Определение

Задает набор возможных типов, десериализация которых будет выполняться модулем форматирования из тела предоставляемого сообщения.Specifies the set of possible types that will be deserialized by the formatter from the message provided.

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; }
member this.TargetTypeNames : string[] with get, set
Public Property TargetTypeNames As String()

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

String[]

Массив типа String, задающий типы объектов, десериализуемых из тела сообщения при чтении данного сообщения.An array of type String that specifies the types of objects to deserialize from the message body when reading the message.

Атрибуты

Исключения

Значение свойства TargetTypeNamesnull.The TargetTypeNames property is null.

Комментарии

И свойства, TargetTypes и указывают модулю форматирования, какие схемы следует пытаться сопоставить при десериализации сообщения. TargetTypeNamesBoth the TargetTypeNames and TargetTypes properties tell the formatter what schemas to attempt to match when deserializing a message. Это позволяет модулю форматирования интерпретировать текст сообщения.This allows the formatter to interpret the message body.

Экземпляр, сериализованный в тексте сообщения, должен соответствовать одной из схем, представленных в массиве типов.The instance serialized in the message body must comply with one of the schemas represented in the type array. При чтении сообщения с помощью Receive метода метод создает объект типа, соответствующий указанной схеме, и считывает в него текст сообщения.When you read the message using the Receive method, the method creates an object of the type that corresponds to the schema identified and reads the message body into it.

При чтении из очереди необходимо задать только одно из двух свойств, но можно задать и то, и другое.Only one of the two properties needs to be set when reading from the queue, but you can set both. Набор типов — это объединенный набор из двух свойств.The set of types is the combined set from the two properties. Решение о том, какое свойство следует использовать, зависит от вашего приложения.The decision of which property to use is specific to your application. Если текст сообщения содержит тип, схема которого не совпадает ни с одним из типов в массиве для любого из свойств, при считывании сообщения будет создано исключение.If the message body contains a type whose schema does not match any of the types in the array for either property, an exception will be thrown when the message is read.

TargetTypeNamesтребует, чтобы каждая запись была полностью квалифицирована, указывая ее имя сборки.TargetTypeNames requires every entry to be fully qualified, specifying its assembly name. Кроме того, при работе с несколькими параллельными версиями номер версии также должен быть добавлен к имени целевого типа.Further, when working with multiple concurrent versions, the version number must also be appended to the target type name as well.

Типы целевых объектов требуются только при чтении из очереди.The target types are only required when reading from the queue. Свойства TargetTypeNames иTargetTypes не нужно задавать для записи в очередь.The TargetTypeNames and TargetTypes properties do not need to be set to write to the queue.

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

Дополнительно