IRemoteObjectContract.RemoteCast(String) Metoda

Definicja

Rzutuje obiekt zidentyfikowany przez bieżący IRemoteObjectContract do określonego typu.

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

Nazwa kanoniczna typu do rzutowania obiektu na.

Zwraca

Element RemoteArgument reprezentujący wynik operacji rzutowania.

Uwagi

Nazwa kanoniczna jest globalnie unikatową nazwą, taką jak identyfikator GUID. Zalecane są ciągi w nazwie> zestawu formatu<, < w pełni kwalifikowana nazwa> typu. Przykładem zalecanego formatu nazwy kanonicznej jest "ShapeApp, Microsoft.VisualStudio.Tools.Applications.Samples.ShapeApp.Application".

Nazwa kanoniczna typu nie może ulec zmianie po opublikowaniu typu w składniku. Zmiana nazwy kanonicznej typu w przyszłej wersji składnika przerywa zgodność między składnikiem a klientami, którzy już używają typu.

Zaleca się, aby RemoteCast implementacje zgłaszały błąd, jeśli operacja rzutowania zakończy się niepowodzeniem InvalidCastException .

Dotyczy