VariantWrapper Třída

Definice

Obor názvů:

System.Runtime.InteropServices

Sestavení:

System.Runtime.InteropServices.dll

Zdroj:

VariantWrapper.cs

Zařadí data typu VT_VARIANT | VT_BYREF ze spravovaného na nespravovaný kód. Tato třída se nemůže dědit.

public ref class VariantWrapper sealed

public sealed class VariantWrapper

type VariantWrapper = class

Public NotInheritable Class VariantWrapper

Dědičnost

Object

VariantWrapper

Příklady

Následující příklad kódu ukazuje, jak použít VariantWrapper třídu k zabalení Object , který interop marshaler předá jako 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)

Poznámky

Účelem VariantWrapper příkazu je přidat jednu úroveň nepřímého přístupu při zařazování spravovaného typu do odpovídajícího VARIANT typu.

Tuto třídu můžete použít k zabalení Object , který zařazovač zprostředkovatele komunikace předá jako VT_VARIANT | VT_BYREF. Ve verzích 1.0 a 1.1 rozhraní .NET Framework nebylo možné zařadovat data variant typu VT_VARIANT | VT_BYREF do nespravovaného kódu. Zařazovač komunikace předal variantu spravovaného typu (například VT_BSTR | VT_BYREF pro String, nebo VT_I4 | VT_BYREF pro Int32), ale nikoli VT_VARIANT | VT_BYREF.

Jednou z výhod použití VT_VARIANT | VT_BYREF variantních typů je, že typ dat lze změnit během volání metody. Můžete například předat VT_VARIANT | VT_BYREF typ varianty, který obsahuje VT_BSTR a získat vrácenou variantu, která po volání metody obsahuje VT_I4 . Protože zařazovač zprostředkovatele komunikace COM nemůže zjistit, kdy předat VT_BSTR | VT_BYREF a kdy předat VT_VARIANT | VT_BYREF, který odkazuje na variantu obsahující BSTR parametr pro parametry deklarované jako VARIANT *, můžete instruovat zařazovač pomocí VariantWrapper.

Mějte na paměti, že časná vazba není podporována. můžete použít VariantWrapper pouze při volání InvokeMember nebo s rozhraním Dispatch-only volaným v rané vazbě. V jazyce C# je také nutné použít ref klíčové slovo k určení ByRef sémantiky pro libovolný parametr typu VariantWrapper. V jazyce Visual Basic jsou ByRef sémantiky přidány automaticky pro každé implicitní volání pozdní vazby. Všimněte si také, že vnořování VariantWrapper objektů a polí VariantWrapper objektů není podporováno.

Konstruktory

VariantWrapper(Object)

Inicializuje novou instanci VariantWrapper třídy pro zadaný Object parametr.

Vlastnosti

WrappedObject

Získá objekt zabalený objektem VariantWrapper .

Metody

Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)