IRemoteObjectContract.RemoteCast(String) Yöntem

Tanım

Ad Alanı:

System.AddIn.Contract.Automation

Bütünleştirilmiş Kod:

System.AddIn.Contract.dll

Geçerli IRemoteObjectContract tarafından tanımlanan nesneyi belirtilen bir türe dönüştürür.

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

Parametreler

canonicalName

String

Nesnenin ataması için türün kurallı adı.

Döndürülenler

RemoteArgument

RemoteArgument Atama işleminin sonucunu temsil eden bir.

Açıklamalar

Kurallı ad, GUID gibi genel olarak benzersiz bir addır. Derleme adı> biçimindeki < dizeler, <tam tür adı> önerilir. Kurallı bir adın önerilen biçimine örnek olarak "ShapeApp, Microsoft.VisualStudio.Tools.Applications.Samples.ShapeApp.Application"dır.

Bir tür bir bileşende yayımlandıktan sonra türün kurallı adı değiştirilemez. Bir bileşenin gelecekteki bir sürümünde türün kurallı adını değiştirmek, bileşenle türü zaten kullanan istemciler arasındaki uyumluluğu bozar.

Atama işlemi başarısız olursa uygulamaların bir InvalidCastException oluşturması önerilirRemoteCast.