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.
Effectue un transtypage de l'objet identifié par le IRemoteObjectContract actif en un 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 complet du type en lequel effectuer un transtypage de l'objet.
Retours
RemoteArgument qui représente le résultat de l'opération de transtypage.
Remarques
Un nom canonique est un nom global unique, tel qu’un GUID. Les chaînes au format <nom> de l’assembly et < nom > de type complet sont recommandées. 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 après la publication d’un type 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 un InvalidCastException si l’opération de cast échoue.
