Compartilhar via


IRemoteObjectContract.RemoteCast(String) Método

Definição

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

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.

Aplica-se a