IRemoteObjectContract.RemoteCast(String) Méthode

Référence

Définition

Espace de noms:: System.AddIn.Contract.Automation

Assembly:: System.AddIn.Contract.dll

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.RemoteArgument

Public Function RemoteCast (canonicalName As String) As RemoteArgument

Paramètres

canonicalName: String

Nom complet du type en lequel effectuer un transtypage de l'objet.

Retours

RemoteArgument

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.

S’applique à

Partager via