IRemoteObjectContract.RemoteCast(String) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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.RemoteArgumentPublic Function RemoteCast (canonicalName As String) As RemoteArgumentParametry
- 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 .
