XmlMessageFormatter.TargetTypeNames Eigenschaft

  • Referenz

Definition

Namespace:
System.Messaging
Assembly:
System.Messaging.dll

Gibt die Gruppe der möglichen Typen an, die vom Formatierungsprogramm aus der bereitgestellten Meldung deserialisiert werden können.

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

Eigenschaftswert

String[]

Ein Array vom Typ String, das die Objekttypen angibt, die beim Lesen der Meldung aus dem Meldungstext deserialisiert werden sollen.

Attribute
MessagingDescriptionAttribute

Ausnahmen

ArgumentNullException

Die TargetTypeNames-Eigenschaft ist null.

Hinweise

Sowohl die TargetTypeNames Eigenschaften als TargetTypes auch geben dem Formatierer an, welche Schemas beim Deserialisieren einer Nachricht übereinstimmen sollen. Dadurch kann der Formatierer den Nachrichtentext interpretieren.

Die im Nachrichtentext serialisierte instance muss einem der Schemas entsprechen, die im Typarray dargestellt werden. Wenn Sie die Nachricht mit der Receive -Methode lesen, erstellt die -Methode ein Objekt des Typs, der dem identifizierten Schema entspricht, und liest den Nachrichtentext darin ein.

Beim Lesen aus der Warteschlange muss nur eine der beiden Eigenschaften festgelegt werden, aber Sie können beide festlegen. Der Satz von Typen ist die kombinierte Menge aus den beiden Eigenschaften. Die Entscheidung, welche Eigenschaft verwendet werden soll, ist spezifisch für Ihre Anwendung. Wenn der Nachrichtentext einen Typ enthält, dessen Schema keinem der Typen im Array für beide Eigenschaften entspricht, wird beim Lesen der Nachricht eine Ausnahme ausgelöst.

TargetTypeNames erfordert, dass jeder Eintrag voll qualifiziert ist, wobei der Assemblyname angegeben wird. Darüber hinaus muss bei der Arbeit mit mehreren gleichzeitigen Versionen auch die Versionsnummer an den Namen des Zieltyps angefügt werden.

Die Zieltypen sind nur beim Lesen aus der Warteschlange erforderlich. Die TargetTypeNames Eigenschaften und TargetTypes müssen nicht festgelegt werden, um in die Warteschlange zu schreiben.

Gilt für:

Weitere Informationen