IRemoteObjectContract.RemoteCast(String) Metodo

Definizione

Spazio dei nomi:

System.AddIn.Contract.Automation

Assembly:

System.AddIn.Contract.dll

Esegue il cast dell'oggetto identificato dall'oggetto IRemoteObjectContract corrente a un tipo specificato.

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

Parametri

canonicalName

String

Nome canonico del tipo a cui eseguire il cast dell'oggetto.

Restituisce

RemoteArgument

Oggetto RemoteArgument che rappresenta il risultato dell'operazione di cast.

Commenti

Un nome canonico è un nome univoco globale, ad esempio un GUID. Le stringhe nel nome >dell'assembly di formato < sono <consigliate per il nome> completo del tipo. Un esempio del formato consigliato di un nome canonico è "ShapeApp, Microsoft.VisualStudio.Tools.Applications.Samples.ShapeApp.Application".

Il nome canonico di un tipo non può cambiare dopo la pubblicazione di un tipo in un componente. La modifica del nome canonico di un tipo in una versione futura di un componente interrompe la compatibilità tra il componente e i client che già usano il tipo .

È consigliabile che RemoteCast le implementazioni generino un'eccezione InvalidCastException se l'operazione di cast ha esito negativo.