VariantWrapper Classe

Définition

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

Héritage

Object

VariantWrapper

Attributs

ObsoleteAttribute SerializableAttribute

Exemples

L’exemple de code suivant montre comment utiliser la VariantWrapper classe pour encapsuler un Object marshaleur d’interopérabilité transmis en tant que 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)

Remarques

L’objectif est VariantWrapper d’ajouter un niveau d’indirection lors du marshaling d’un type managé au type correspondant VARIANT .

Vous pouvez utiliser cette classe pour encapsuler un Object marshaleur d’interopérabilité transmis en tant que VT_VARIANT | VT_BYREF. Dans les versions 1.0 et 1.1 de l’infrastructure .NET, il n’était pas possible de marshaler les données variant de type VT_VARIANT | VT_BYREF au code non managé. Le marshaleur d’interopérabilité a passé une variante du type managé (par exemple, VT_BSTR | VT_BYREF pour String, ou VT_I4 | VT_BYREF pour Int32), mais pas VT_VARIANT | VT_BYREF.

L’un des avantages de l’utilisation VT_VARIANT | VT_BYREF de types variant est que le type de données peut être modifié pendant un appel de méthode. Par exemple, vous pouvez passer un VT_VARIANT | VT_BYREF type de variante qui contient une VT_BSTR variante retournée VT_I4 après un appel de méthode. Étant donné que le marshaleur COM Interop n’a aucun moyen de savoir quand passer et quand passer VT_VARIANT | VT_BYREFVT_BSTR | VT_BYREF , qui pointe vers une variante qui contient un BSTR pour les paramètres déclarés comme VARIANT *, vous pouvez demander au marshaleur à l’aide VariantWrapper.

Notez que la liaison anticipée n’est pas prise en charge ; vous ne pouvez utiliser VariantWrapper que lorsque vous appelez InvokeMember ou avec une interface Dispatch uniquement appelée de manière anticipée. En C#, vous devez également utiliser le ref mot clé pour spécifier ByRef la sémantique pour n’importe quel paramètre de type VariantWrapper. Dans Visual Basic, ByRef sémantiques sont ajoutées automatiquement pour chaque appel de liaison tardive implicite. Notez également que l’imbrication d’objets VariantWrapper et de tableaux d’objets VariantWrapper n’est pas prise en charge.