IRemoteObjectContract.RemoteCast(String) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt het object dat door de huidige IRemoteObjectContract is geïdentificeerd, omgezet in een opgegeven type.
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 RemoteArgumentParameters
- canonicalName
- String
De canonieke naam van het type waarnaar het object moet worden gegoten.
Retouren
Een RemoteArgument die het resultaat van de cast-bewerking aangeeft.
Opmerkingen
Een canonieke naam is een wereldwijd unieke naam, zoals een GUID. Tekenreeksen in de indelingsassemblynaam><, <volledig gekwalificeerde typenaam> worden aanbevolen. Een voorbeeld van de aanbevolen indeling van een canonieke naam is ShapeApp, Microsoft. VisualStudio.Tools.Applications.Samples.ShapeApp.Application..
De canonieke naam voor een type kan niet worden gewijzigd nadat een type in een onderdeel is gepubliceerd. Als u de canonieke naam van een type wijzigt in een toekomstige versie van een onderdeel, wordt de compatibiliteit tussen het onderdeel en clients die al gebruikmaken van het type verbroken.
Het wordt aanbevolen dat RemoteCast implementaties een InvalidCastException werpen als de cast-bewerking mislukt.