IRemoteObjectContract.RemoteCast(String) Metoda

Reference

Definice

Obor názvů:: System.AddIn.Contract.Automation

Sestavení:: System.AddIn.Contract.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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.

Platí pro