IRemoteObjectContract.RemoteCast(String) Metoda

Definice

Obor názvů:

System.AddIn.Contract.Automation

Sestavení:

System.AddIn.Contract.dll

Přetypuje objekt identifikovaný proudem IRemoteObjectContract na zadaný typ.

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

Parametry

canonicalName

String

Kanonický název typu, na který se má objekt přetypovat.

Návraty

RemoteArgument

A RemoteArgument , který představuje výsledek operace přetypování.

Poznámky

Kanonický název je globálně jedinečný název, například IDENTIFIKÁTOR GUID. Doporučují se řetězce ve formátu <názvu> sestavení, <plně kvalifikovaný název> typu. Příkladem doporučeného formátu kanonického názvu je ShapeApp, Microsoft.VisualStudio.Tools.Applications.Samples.ShapeApp.Application.

Kanonický název typu se po publikování typu v komponentě nemůže změnit. Změnou kanonického názvu typu v budoucí verzi součásti dojde k narušení kompatibility mezi komponentou a klienty, kteří tento typ již používají.

Doporučuje se, aby RemoteCast implementace vyvolaly výjimku , InvalidCastException pokud operace přetypování selže.