IRemoteObjectContract.RemoteCast(String) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.RemoteArgumentPublic Function RemoteCast (canonicalName As String) As RemoteArgumentParâ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.
