IRemoteObjectContract.RemoteCast(String) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Convertit l’objet identifié par le courant IRemoteObjectContract en type spécifié.
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 RemoteArgumentParamètres
- canonicalName
- String
Nom canonique du type vers lequel convertir l’objet.
Retours
Qui RemoteArgument représente le résultat de l’opération de cast.
Remarques
Un nom canonique est un nom global unique, tel qu’un GUID. Les chaînes au format <nom> de l’assembly, <le nom> de type complet est recommandé. Un exemple de format recommandé d’un nom canonique est « ShapeApp, Microsoft. VisualStudio.Tools.Applications.Samples.ShapeApp.Application ».
Le nom canonique d’un type ne peut pas changer une fois qu’un type est publié dans un composant. La modification du nom canonique d’un type dans une version ultérieure d’un composant interrompt la compatibilité entre le composant et les clients qui utilisent déjà le type.
Il est recommandé que RemoteCast les implémentations lèvent une InvalidCastException exception si l’opération de cast échoue.