IRemoteObjectContract.RemoteCast(String) Método

Definição

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.

Aplica-se a