VariantWrapper Класс

Определение

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

Наследование

Object

VariantWrapper

Атрибуты

ObsoleteAttribute SerializableAttribute

Примеры

В следующем примере кода показано, как использовать 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 объектов не поддерживаются.

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

Свойства

Методы

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