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


VariantWrapper Класс

Определение

Внимание!

VariantWrapper and support for marshalling to the VARIANT type may be unavailable in future releases.

Маршалирует данные типа VT_VARIANT | VT_BYREF из управляемого кода в неуправляемый. Этот класс не наследуется.

public ref class VariantWrapper sealed
[System.Obsolete("VariantWrapper and support for marshalling to the VARIANT type may be unavailable in future releases.")]
public sealed class VariantWrapper
public sealed class VariantWrapper
[System.Serializable]
public sealed class VariantWrapper
[<System.Obsolete("VariantWrapper and support for marshalling to the VARIANT type may be unavailable in future releases.")>]
type VariantWrapper = class
type VariantWrapper = class
[<System.Serializable>]
type VariantWrapper = class
Public NotInheritable Class VariantWrapper
Наследование
VariantWrapper
Атрибуты

Примеры

В следующем примере кода показано, как использовать VariantWrapper класс для упаковки, Object который маршалер взаимодействия передает как VT_VARIANT | VT_BYREF.

// Create an instance of an unmanged COM object.
UnmanagedComClass UnmanagedComClassInstance = new UnmanagedComClass();

// Create a string to pass to the COM object.
string helloString = "Hello World!";

// Wrap the string with the VariantWrapper class.
object var = new System.Runtime.InteropServices.VariantWrapper(helloString);

// Pass the wrapped object.
UnmanagedComClassInstance.MethodWithStringRefParam(ref var);
' Create an instance of an unmanged COM object.
Dim UnmanagedComClassInstance As New UnmanagedComClass()

' Create a string to pass to the COM object.
Dim helloString As String = "Hello World!"

' Wrap the string with the VariantWrapper class.
Dim var As Object = New System.Runtime.InteropServices.VariantWrapper(helloString)

' Pass the wrapped object.
UnmanagedComClassInstance.MethodWithStringRefParam(var)

Комментарии

Цель VariantWrapper — добавить один уровень косвенного обращения при маршалинге управляемого типа к соответствующему VARIANT типу.

Этот класс можно использовать для оболочки Object , которую маршалер взаимодействия передает как VT_VARIANT | VT_BYREF. В версиях 1.0 и 1.1 платформы .NET Framework невозможно было маршалировать данные типа в неуправляемый VT_VARIANT | VT_BYREF код. Маршалер взаимодействия передал вариант управляемого типа (например, VT_BSTR | VT_BYREF для Stringили VT_I4 | VT_BYREF для Int32), но не VT_VARIANT | VT_BYREF.

Одним из преимуществ использования VT_VARIANT | VT_BYREF вариантных типов является то, что тип данных можно изменить во время вызова метода. Например, можно передать VT_VARIANT | VT_BYREF тип variant, содержащий VT_BSTR , и получить возвращаемый вариант, содержащий VT_I4 , после вызова метода. Так как маршалер COM-взаимодействия не может знать, когда передавать VT_BSTR | VT_BYREF , а когда передавать VT_VARIANT | VT_BYREF, что указывает на вариант, содержащий BSTR для параметров, объявленных как VARIANT *, можно указать маршалеру с помощью VariantWrapper.

Обратите внимание, что ранняя привязка не поддерживается; вы можете использовать VariantWrapper только при вызове InvokeMember или с интерфейсом dispatch-only, вызываемом ранним способом. В C# необходимо также использовать ключевое ref слово , чтобы указать ByRef семантику для любого параметра типа VariantWrapper. В Visual Basic ByRef семантика добавляется автоматически для каждого неявного позднего вызова привязки. Также обратите внимание, что вложенные VariantWrapper объекты и массивы VariantWrapper объектов не поддерживаются.

Конструкторы

VariantWrapper(Object)
Устаревшие..

Инициализирует новый экземпляр класса VariantWrapper для заданного параметра Object.

Свойства

WrappedObject
Устаревшие..

Возвращает объект, инкапсулированный с помощью объекта VariantWrapper.

Методы

Equals(Object)
Устаревшие..

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

(Унаследовано от Object)
GetHashCode()
Устаревшие..

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetType()
Устаревшие..

Возвращает объект Type для текущего экземпляра.

(Унаследовано от Object)
MemberwiseClone()
Устаревшие..

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
ToString()
Устаревшие..

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)

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