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 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.RemoteArgumentPublic Function RemoteCast (canonicalName As String) As RemoteArgumentParameter
- canonicalName
- String
Der kanonische Name des Typs, in den das Objekt umgewandelt werden soll.
Gibt zurück
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.
