VariantWrapper Třída

Definice

Obor názvů:

System.Runtime.InteropServices

Sestavení:

System.Runtime.InteropServices.dll

Sestavení:

mscorlib.dll

Sestavení:

netstandard.dll

Upozornění

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

Zařazuje data typu VT_VARIANT | VT_BYREF ze spravovaného do nespravovaného kódu. Tuto třídu nelze dědit.

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

Dědičnost

Object

VariantWrapper

Atributy

ObsoleteAttribute SerializableAttribute

Příklady

Následující příklad kódu ukazuje, jak pomocí VariantWrapper třídy zabalit Object , že interop marshaler předává 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 je přidat jednu úroveň nepřímosti při zařazování spravovaného typu do odpovídajícího VARIANT typu.

Pomocí této třídy můžete zabalit, Object že interop marshaler předává jako VT_VARIANT | VT_BYREF. Ve verzích 1.0 a 1.1 .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 typů variant je, že typ dat lze během volání metody změnit. Můžete například předat VT_VARIANT | VT_BYREF typ varianty, který obsahuje VT_BSTR a získat variantu vrácenou VT_I4 , která obsahuje po volání metody. Vzhledem k tomu, že interop com interop marshaler nemá žádný způsob, jak zjistit, kdy předat VT_BSTR | VT_BYREF a kdy předat VT_VARIANT | VT_BYREF, který odkazuje na variantu obsahující BSTR parametry deklarované jako VARIANT *, můžete instrukovat zařazování 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 odeslání volaným v raném vázaném směru. V jazyce C# musíte také použít ref klíčové slovo k určení ByRef sémantiky pro libovolný parametr typu VariantWrapper. V Visual Basic ByRef se sémantika automaticky přidá pro každé implicitní pozdní volání vazby. Všimněte si také, že vnoření 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í funkce hash. (Zděděno od Object)
GetType()	Type Získá aktuální instanci. (Zděděno od Object)
MemberwiseClone()	Vytvoří použádnou kopii aktuálního souboru Object. (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)