“联合”示例

项目
02/19/2014

该示例说明如何将两种结构作为参数传递给需要联合的非托管函数，一种结构是只包含值类型的结构，一种结构是同时包含值类型和字符串的结构。联合表示一个可以由两个或多个变量共享的内存位置。

Unions 示例使用以下非托管函数（这里同时显示其原始函数声明）：

从 PinvokeLib.dll 导出的 TestUnion。
```
void TestUnion(MYUNION u, int type);
```

PinvokeLib.dll 是一个自定义非托管库，它包含前面列出的函数的实现和以下两个联合：MYUNION 和 MYUNION2。这两个联合包含以下元素：

union MYUNION
{
    int number;
    double d;
}

union MYUNION2
{
    int i;
    char str[128];
};

在托管代码中，将联合定义为结构。 MyUnion 结构包含两个值类型作为其成员：一个整型和一个双精度型。设置 StructLayoutAttribute 特性以控制每个数据成员的精确位置。 FieldOffsetAttribute 特性提供字段在联合的非托管表示形式中的物理位置。请注意，这两个成员具有相同的偏移量值，因此这两个成员可以定义相同的内存块。

MyUnion2_1 和 MyUnion2_2 分别包含一个值类型（整型）和一个字符串。在托管代码中，值类型和引用类型不允许重叠。该示例使用方法重载以使调用方能够在调用同一非托管函数时同时使用这两种类型。 MyUnion2_1 的布局是显式的，并具有准确的偏移量值。与此相反，MyUnion2_2 的布局则是连续的，原因是引用类型不允许使用显式布局。 MarshalAsAttribute 特性将 UnmanagedType 枚举设置为 ByValTStr，后者用于标识在联合的非托管表示形式中出现的内联的、固定长度的字符数组。

LibWrap 类包含 TestUnion 和 TestUnion2 方法的原型。重载 TestUnion2 以便将 MyUnion2_1 或 MyUnion2_2 声明为参数。

声明原型

' Declares managed structures instead of unions.
<StructLayout(LayoutKind.Explicit)> _
Public Structure MyUnion
    <FieldOffset(0)> Public i As Integer
    <FieldOffset(0)> Public d As Double
End Structure 'MyUnion

<StructLayout(LayoutKind.Explicit, Size := 128)> _
Public Structure MyUnion2_1
    <FieldOffset(0)> Public i As Integer
End Structure 'MyUnion2_1

<StructLayout(LayoutKind.Sequential)> _
Public Structure MyUnion2_2
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst := 128)> _
    Public str As String
End Structure 'MyUnion2_2

Public Class LibWrap
    ' Declares managed prototypes for unmanaged function.
    Declare Sub TestUnion Lib "..\LIB\PinvokeLib.dll" ( _
        ByVal u As MyUnion, ByVal type As Integer)

    Overloads Declare Sub TestUnion2 Lib "..\LIB\PinvokeLib.dll" ( _
        ByVal u As MyUnion2_1, ByVal type As Integer)

    Overloads Declare Sub TestUnion2 Lib "..\LIB\PinvokeLib.dll" ( _
        ByVal u As MyUnion2_2, ByVal type As Integer)
End Class 'LibWrap

// Declares managed structures instead of unions.
[StructLayout(LayoutKind.Explicit)]
public struct MyUnion
{
    [FieldOffset(0)]
    public int i;
    [FieldOffset(0)]
    public double d;
}

[StructLayout(LayoutKind.Explicit, Size=128)]
public struct MyUnion2_1
{
    [FieldOffset(0)]
    public int i;
}

[StructLayout(LayoutKind.Sequential)]
public struct MyUnion2_2
{
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst=128)]
    public string str;
}

public class LibWrap
{
    // Declares managed prototypes for unmanaged function.
    [DllImport( "..\\LIB\\PInvokeLib.dll")]
    public static extern void TestUnion(MyUnion u, int type);

    [DllImport( "..\\LIB\\PInvokeLib.dll")]
    public static extern void TestUnion2(MyUnion2_1 u, int type);

    [DllImport( "..\\LIB\\PInvokeLib.dll")]
    public static extern void TestUnion2(MyUnion2_2 u, int type);
}

// Declares managed structures instead of unions.
[StructLayout(LayoutKind::Explicit)]
public value struct MyUnion
{
public:
    [FieldOffset(0)]
    int i;
    [FieldOffset(0)]
    double d;
};

[StructLayout(LayoutKind::Explicit, Size=128)]
public value struct MyUnion2_1
{
public:
    [FieldOffset(0)]
    int i;
};

[StructLayout(LayoutKind::Sequential)]
public value struct MyUnion2_2
{
public:
    [MarshalAs(UnmanagedType::ByValTStr, SizeConst=128)]
    String^ str;
};

public ref class LibWrap
{
public:
    // Declares managed prototypes for unmanaged function.
    [DllImport("..\\LIB\\PInvokeLib.dll")]
    static void TestUnion(MyUnion u, int type);

    [DllImport("..\\LIB\\PInvokeLib.dll")]
    static void TestUnion2(MyUnion2_1 u, int type);

    [DllImport("..\\LIB\\PInvokeLib.dll")]
    static void TestUnion2(MyUnion2_2 u, int type);
};

调用函数

Public Class App
    Public Shared Sub Main()
        Dim mu As New MyUnion()
        mu.i = 99
        LibWrap.TestUnion(mu, 1)

        mu.d = 99.99
        LibWrap.TestUnion(mu, 2)

        Dim mu2_1 As New MyUnion2_1()
        mu2_1.i = 99
        LibWrap.TestUnion2(mu2_1, 1)

        Dim mu2_2 As New MyUnion2_2()
        mu2_2.str = "*** string ***"
        LibWrap.TestUnion2(mu2_2, 2)
    End Sub 'Main
End Class 'App

public class App
{
    public static void Main()
    {
        MyUnion mu = new MyUnion();
        mu.i = 99;
        LibWrap.TestUnion(mu, 1);

        mu.d = 99.99;
        LibWrap.TestUnion(mu, 2);

        MyUnion2_1 mu2_1 = new MyUnion2_1();
        mu2_1.i = 99;
        LibWrap.TestUnion2(mu2_1, 1);

        MyUnion2_2 mu2_2 = new MyUnion2_2();
        mu2_2.str = "*** string ***";
        LibWrap.TestUnion2(mu2_2, 2);
    }
}

public ref class App
{
public:
    static void Main()
    {
        MyUnion mu;// = new MyUnion();
        mu.i = 99;
        LibWrap::TestUnion(mu, 1);

        mu.d = 99.99;
        LibWrap::TestUnion(mu, 2);

        MyUnion2_1 mu2_1;// = new MyUnion2_1();
        mu2_1.i = 99;
        LibWrap::TestUnion2(mu2_1, 1);

        MyUnion2_2 mu2_2;// = new MyUnion2_2();
        mu2_2.str = "*** string ***";
        LibWrap::TestUnion2(mu2_2, 2);
    }
};

请参见

概念

封送类、结构和联合

平台调用数据类型

在托管代码中创建原型

“联合”示例

声明原型

调用函数

请参见

概念

其他资源