IRemoteObjectContract.RemoteCast(String) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Omvandlar objektet som identifieras av strömmen IRemoteObjectContract till en angiven 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.RemoteArgumentPublic Function RemoteCast (canonicalName As String) As RemoteArgumentParametrar
- canonicalName
- String
Det kanoniska namnet på den typ som objektet ska omvandlas till.
Returer
En RemoteArgument som representerar resultatet av gjutningsåtgärden.
Kommentarer
Ett kanoniskt namn är ett globalt unikt namn, till exempel ett GUID. Strängar i formatet <sammansättningsnamn>, <fullständigt kvalificerat typnamn> rekommenderas. Ett exempel på det rekommenderade formatet för ett kanoniskt namn är "ShapeApp, Microsoft. VisualStudio.Tools.Applications.Samples.ShapeApp.Application".
Det kanoniska namnet för en typ kan inte ändras när en typ har publicerats i en komponent. Om du ändrar det kanoniska namnet på en typ i en framtida version av en komponent bryts kompatibiliteten mellan komponenten och klienterna som redan använder typen.
Vi rekommenderar att RemoteCast implementeringar utlöser en InvalidCastException om gjutningsåtgärden misslyckas.