IRemoteObjectContract.RemoteCast(String) メソッド

定義

名前空間:
System.AddIn.Contract.Automation
アセンブリ:
System.AddIn.Contract.dll

現在の IRemoteObjectContract で識別されるオブジェクトを、指定した型にキャストします。

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

パラメーター

canonicalName
String

オブジェクトをキャストする型の正規名。

返品

RemoteArgument

キャスト操作の結果を表す RemoteArgument 。

注釈

正規名は、GUID などのグローバルに一意の名前です。 形式 <アセンブリ名>、 <完全に修飾された型名> の文字列をお勧めします。 正規名の推奨形式の例として、"ShapeApp, Microsoft。VisualStudio.Tools.Applications.Samples.ShapeApp.Application"。

型の正規名は、型がコンポーネントに発行された後は変更できません。 将来のバージョンのコンポーネントで型の正規名を変更すると、その型を既に使用しているコンポーネントとクライアントの間の互換性が解除されます。

RemoteCast実装では、キャスト操作が失敗した場合にInvalidCastExceptionをスローすることをお勧めします。

適用対象