Bagikan melalui


IRemoteObjectContract.RemoteCast(String) Metode

Definisi

Mentransmisikan objek yang diidentifikasi oleh saat ini IRemoteObjectContract ke jenis yang ditentukan.

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

Parameter

canonicalName
String

Nama kanonis jenis untuk melemparkan objek.

Mengembalikan

RemoteArgument yang mewakili hasil operasi transmisi.

Keterangan

Nama kanonis adalah nama yang unik secara global, seperti GUID. String dalam nama >rakitan format<, < nama >jenis yang sepenuhnya memenuhi syarat direkomendasikan. Contoh format nama kanonis yang direkomendasikan adalah "ShapeApp, Microsoft.VisualStudio.Tools.Applications.Samples.ShapeApp.Application".

Nama kanonis untuk jenis tidak dapat berubah setelah jenis diterbitkan dalam komponen. Mengubah nama kanonis jenis dalam versi komponen yang akan datang akan merusak kompatibilitas antara komponen dan klien yang sudah menggunakan jenis tersebut.

Disarankan agar RemoteCast implementasi melempar jika InvalidCastException operasi transmisi gagal.

Berlaku untuk