Exemplo de uniões
Este exemplo demonstra como passar estruturas contendo apenas os tipos de valor e estruturas contendo um tipo de valor e uma string como parâmetros para uma função não gerenciada, esperando uma união. Uma união representa um local de memória que pode ser compartilhado por dois ou mais variáveis.
O exemplo de uniões usa a seguinte função não gerenciada, mostrada com sua declaração de função original:
TestUnion exportados do PinvokeLib.dll.
void TestUnion(MYUNION u, int type);
PinvokeLib.dll é uma biblioteca de não gerenciada personalizada que contém uma implementação para a função listada anteriormente e duas uniões, MYUNION e MYUNION2. As uniões contenham os seguintes elementos:
union MYUNION
{
int number;
double d;
}
union MYUNION2
{
int i;
char str[128];
};
No código gerenciado, uniões são definidos como estruturas. O MyUnion estrutura contém dois tipos de valor, como seus membros: um inteiro e um double. O StructLayoutAttribute atributo está definido para controlar a posição exata de cada membro de dados. O FieldOffsetAttribute atributo fornece a posição física dos campos dentro a representação não gerenciada da união. Observe que ambos os membros possuem os mesmos valores de deslocamento, portanto, os membros podem definir a mesma parte da memória.
MyUnion2_1e MyUnion2_2 contêm um tipo de valor (inteiro) e uma seqüência de caracteres, respectivamente. No código gerenciado, os tipos de valor e tipos de referência não são permitidos para sobrepor. Este exemplo usa o método de sobrecarga para permitir que o chamador para use ambos os tipos, ao chamar a mesma função não gerenciada. O layout de MyUnion2_1 é explícita e tem um valor de deslocamento precisos. Em contraste, MyUnion2_2 tem um layout seqüencial, como layouts explícitos não são permitidos com tipos de referência. O MarshalAsAttribute define o atributo de UnmanagedType enumeração para ByValTStr, que é usado para identificar o embutido, conjuntos de caracteres de comprimento fixo que aparecem dentro da representação não gerenciada da união.
O LibWrap classe contém os protótipos para o TestUnion e TestUnion2 métodos. TestUnion2está sobrecarregado para declarar MyUnion2_1 ou MyUnion2_2 como parâmetros.
A declaração de protótipos
' 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);
};
Chamando funções
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);
}
};
Consulte também
Conceitos
O empacotamento de Classes, estruturas e uniões