IRemoteObjectContract.RemoteCast(String) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Lança o objeto identificado pela corrente IRemoteObjectContract para um tipo especificado.
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
Parâmetros
- canonicalName
- String
O nome canónico do tipo para lançar o objeto.
Devoluções
A que representa o resultado da operação de RemoteArgument lançamento.
Observações
Um nome canónico é um nome globalmente único, como um GUID. Recomendam-se strings no formato <assembly name> e < nome >do tipo totalmente qualificado. Um exemplo do formato recomendado para um nome canónico é "ShapeApp, Microsoft. VisualStudio.Tools.Applications.Samples.ShapeApp.Application".
O nome canónico de um tipo não pode mudar depois de um tipo ser publicado num componente. Alterar o nome canónico de um tipo numa versão futura de um componente quebra a compatibilidade entre o componente e os clientes que já usam o tipo.
Recomenda-se que RemoteCast as implementações lancem um InvalidCastException caso a operação de cast falhe.