IRemoteObjectContract.RemoteCast(String) Methode

Definition

Namespace:

System.AddIn.Contract.Automation

Assembly:

System.AddIn.Contract.dll

Wandelt das vom aktuellen IRemoteObjectContract identifizierte Objekt in einen angegebenen Typ um.

public:
 System::AddIn::Contract::RemoteArgument RemoteCast(System::String ^ canonicalName);

public System.AddIn.Contract.RemoteArgument RemoteCast (string canonicalName);

abstract member RemoteCast : string -> System.AddIn.Contract.RemoteArgument

Public Function RemoteCast (canonicalName As String) As RemoteArgument

Parameter

canonicalName

String

Der kanonische Name des Typs, in den das Objekt umgewandelt werden soll.

Gibt zurück

RemoteArgument

Ein RemoteArgument, das das Ergebnis der Umwandlung darstellt.

Hinweise

Ein kanonischer Name ist ein global eindeutiger Name, z. B. eine GUID. Zeichenfolgen im Format <Assemblyname>, <vollqualifizierter Typname> werden empfohlen. Ein Beispiel für das empfohlene Format eines kanonischen Namens ist "ShapeApp, Microsoft.VisualStudio.Tools.Applications.Samples.ShapeApp.Application".

Der kanonische Name für einen Typ kann sich nicht ändern, nachdem ein Typ in einer Komponente veröffentlicht wurde. Das Ändern des kanonischen Namens eines Typs in einer zukünftigen Version einer Komponente unterbricht die Kompatibilität zwischen der Komponente und Clients, die den Typ bereits verwenden.

Es wird empfohlen, dass RemoteCast Implementierungen eine InvalidCastException auslösen, wenn der Umwandlungsvorgang fehlschlägt.