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 。