Поделиться через


IRemoteObjectContract.RemoteCast(String) Метод

Определение

Приводит объект, определенный текущим IRemoteObjectContract, к указанному типу.

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

Параметры

canonicalName
String

Каноническое имя типа, к которому необходимо привести объект.

Возвращаемое значение

RemoteArgument, представляющий собой результат операции приведения.

Комментарии

Каноническое имя — это глобально уникальное имя, например GUID. Рекомендуется использовать строки в формате < имени >сборки, <полное имя> типа. Пример рекомендуемого формата канонического имени — ShapeApp, Microsoft.VisualStudio.Tools.Applications.Samples.ShapeApp.Application.

Каноническое имя типа не может измениться после публикации типа в компоненте. Изменение канонического имени типа в будущей версии компонента нарушает совместимость между компонентом и клиентами, которые уже используют тип.

Рекомендуется, чтобы RemoteCast реализации вызывают исключение , InvalidCastException если операция приведения завершается сбоем.

Применяется к