IRemoteObjectContract.RemoteCast(String) Método

Definición

Espacio de nombres:

System.AddIn.Contract.Automation

Ensamblado:

System.AddIn.Contract.dll

Convierte el objeto identificado por la interfaz IRemoteObjectContract actual a un 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

Nombre canónico del tipo al que se va a convertir el objeto.

Devoluciones

RemoteArgument

RemoteArgument que representa el resultado de la operación de conversión.

Comentarios

Un nombre canónico es un nombre único global, como un GUID. Se recomiendan cadenas con el formato <nombre> del ensamblado, < nombre >de tipo completo. Un ejemplo del formato recomendado de un nombre canónico es "ShapeApp, Microsoft.VisualStudio.Tools.Applications.Samples.ShapeApp.Application".

El nombre canónico de un tipo no puede cambiar después de publicar un tipo en un componente. Cambiar el nombre canónico de un tipo en una versión futura de un componente interrumpe la compatibilidad entre el componente y los clientes que ya usan el tipo .

Se recomienda que RemoteCast las implementaciones produzcan un error si se produce un InvalidCastException error en la operación de conversión.