IRemoteObjectContract.RemoteCast(String) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Wandelt das durch den 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.RemoteArgumentPublic Function RemoteCast (canonicalName As String) As RemoteArgumentParameter
- canonicalName
- String
Der kanonische Name des Typs, in den das Objekt umgegossen werden soll.
Gibt zurück
Ein RemoteArgument Wert, der das Ergebnis des Umwandlungsvorgangs darstellt.
Hinweise
Ein kanonischer Name ist ein global eindeutiger Name, z. B. eine GUID. Zeichenfolgen im Formatassemblynamen><, <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 eines Typs kann nicht geändert werden, nachdem ein Typ in einer Komponente veröffentlicht wurde. Wenn Sie den kanonischen Namen eines Typs in einer zukünftigen Version einer Komponente ändern, wird die Kompatibilität zwischen der Komponente und den Clients unterbrochen, die den Typ bereits verwenden.
Es wird empfohlen, dass RemoteCast Implementierungen einen InvalidCastException Fehler auslösen, wenn der Umwandlungsvorgang fehlschlägt.