IRemoteObjectContract.RemoteCast(String) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 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.