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 je VariantWrapper 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 objektu, který interop marshaler 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. Interop marshaler předal variantu spravovaného typu (například VT_BSTR | VT_BYREF pro String, nebo VT_I4 | VT_BYREF pro Int32), ale ne VT_VARIANT | VT_BYREF.

Jednou z výhod použití VT_VARIANT | VT_BYREF variantních typů je, že typ dat je možné 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 variantu vrácenou, která obsahuje VT_I4 po volání metody. Vzhledem k tomu, že zařazování komunikace COM nemá žádný způsob, jak zjistit, kdy předat VT_BSTR | VT_BYREF a kdy předat VT_VARIANT | VT_BYREF, což odkazuje na variantu, která obsahuje BSTR parametry pro deklarované jako VARIANT *, můžete instruovat za marshaler 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 jen pro odesílání volaným v raném čase. V jazyce C# musíte také použít ref klíčové slovo k určení ByRef sémantiky pro libovolný parametr typu VariantWrapper. V jazyce Visual Basic se ByRef sémantika přidává automaticky pro každé implicitní pozdní volání 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 zalomený 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()	Získá aktuální Type instanci. (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)