VariantWrapper Kelas

Definisi

Ruang nama:

System.Runtime.InteropServices

Rakitan:

System.Runtime.InteropServices.dll

Sumber:

VariantWrapper.cs

Marshals data jenis VT_VARIANT | VT_BYREF dari dikelola ke kode tidak terkelola. Kelas ini tidak dapat diwariskan.

public ref class VariantWrapper sealed

public sealed class VariantWrapper

type VariantWrapper = class

Public NotInheritable Class VariantWrapper

Warisan

Object

VariantWrapper

Contoh

Contoh kode berikut menunjukkan cara menggunakan VariantWrapper kelas untuk membungkus Object yang diteruskan oleh interop marshaler sebagai 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)

Keterangan

Tujuannya VariantWrapper adalah untuk menambahkan satu tingkat tidak langsung saat marshaling jenis terkelola ke jenis yang VARIANT sesuai.

Anda dapat menggunakan kelas ini untuk membungkus Object yang diteruskan oleh interop marshaler sebagai VT_VARIANT | VT_BYREF. Dalam versi 1.0 dan 1.1 dari .NET Framework, tidak mungkin untuk marshal data varian jenis VT_VARIANT | VT_BYREF ke kode yang tidak dikelola. Interop marshaler melewati varian jenis terkelola (misalnya, VT_BSTR | VT_BYREF untuk String, atau VT_I4 | VT_BYREF untuk Int32), tetapi tidak VT_VARIANT | VT_BYREF.

Salah satu keuntungan menggunakan VT_VARIANT | VT_BYREF jenis varian adalah bahwa jenis data dapat diubah selama panggilan metode. Misalnya, Anda dapat meneruskan VT_VARIANT | VT_BYREF jenis varian yang berisi VT_BSTR dan mendapatkan varian yang dikembalikan yang berisi VT_I4 setelah panggilan metode. Karena COM interop marshaler tidak memiliki cara untuk mengetahui kapan harus melewati VT_BSTR | VT_BYREF dan kapan harus melewati VT_VARIANT | VT_BYREF, yang menunjuk ke varian yang berisi BSTR untuk parameter yang dinyatakan sebagai VARIANT *, Anda dapat menginstruksikan marshaler dengan menggunakan VariantWrapper.

Perhatikan bahwa pengikatan awal tidak didukung; Anda hanya dapat menggunakan VariantWrapper saat memanggil InvokeMember atau dengan antarmuka khusus Dispatch yang disebut dengan cara terikat awal. Di C#, Anda juga harus menggunakan ref kata kunci untuk menentukan ByRef semantik untuk parameter jenis VariantWrapperapa pun . Di Visual Basic, ByRef semantik ditambahkan secara otomatis untuk setiap panggilan pengikatan akhir implisit. Perhatikan juga bahwa objek berlapis VariantWrapper dan array VariantWrapper objek tidak didukung.

Konstruktor

VariantWrapper(Object)

Menginisialisasi instans VariantWrapper baru kelas untuk parameter yang ditentukan Object .

Properti

WrappedObject

Mendapatkan objek yang dibungkus oleh VariantWrapper objek .

Metode

Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)