IRemoteObjectContract.RemoteCast(String) Yöntem

Tanım

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

Şunlara uygulanır