IRemoteObjectContract.RemoteCast(String) Método

Definição

Namespace:

System.AddIn.Contract.Automation

Assembly:

System.AddIn.Contract.dll

Converte o objeto identificado pelo IRemoteObjectContract atual em 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 no qual converter o objeto.

Retornos

RemoteArgument

Um RemoteArgument que representa o resultado da operação de conversão.

Comentários

Um nome canônico é um nome globalmente exclusivo, como um GUID. As cadeias de caracteres no nome> do assembly de formato<, < nome >de tipo totalmente qualificado são recomendadas. Um exemplo do formato recomendado de um nome canônico é "ShapeApp, Microsoft.VisualStudio.Tools.Applications.Samples.ShapeApp.Application".

O nome canônico de um tipo não pode ser alterado depois que um tipo é publicado em um componente. Alterar o nome canônico de um tipo em uma versão futura de um componente interrompe a compatibilidade entre o componente e os clientes que já estão usando o tipo.

É recomendável que RemoteCast as implementações gerem um se a operação de conversão InvalidCastException falhar.