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 если операция приведения завершается сбоем.