Exemplo de uniões

Este exemplo demonstra sistema autônomo passar estruturas contendo apenas sistema autônomo tipos de valor e estruturas que contêm um tipo de valor e uma seqüência de caracteres sistema autônomo parâmetros para uma função não gerenciada esperando uma união.Uma união representa um local da memória que pode ser compartilhado por dois ou mais variáveis.

O exemplo de uniões utiliza a seguinte função não gerenciada, mostrada com sua declaração de função original:

• TestUnion exportados de 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 and 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 sistema autônomo estruturas.The MyUnion estrutura contém dois tipos de valor sistema autônomo membros: um inteiro e um double.The StructLayoutAttribute atributo é definido para controlar a posição exata de cada membro de dados. The FieldOffsetAttribute atributo fornece sua posição física dos campos dentro a representação de uma união não gerenciado. Observe que ambos os membros têm os mesmos valores de deslocamento, para que os membros podem definir a mesma parte da memória.

MyUnion2_1 e MyUnion2_2 conter um tipo de valor (inteiro) e uma seqüência de caracteres, respectivamente. No código gerenciado, tipos de valor e tipos de referência não são permitidos se sobreponham.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ícito e tem um valor de deslocamento preciso. Em contraste, MyUnion2_2 tem um layout seqüencial, pois layouts explícitas não são permitidos com tipos de referência. The MarshalAsAttribute Define o atributo de UnmanagedType enumeração para ByValTStr, que é usado para identificar o in-line, matrizes de caractere de comprimento fixo que aparecem dentro a representação não gerenciada de união.

The LibWrap classe contém protótipos para o TestUnion e TestUnion2 métodos. TestUnion2 está sobrecarregado para declarar MyUnion2_1 ou MyUnion2_2 sistema autônomo parâmetros.

O código-fonte para os exemplos de código a seguir é fornecido pelo.NET estrutura Invocação de plataforma Tecnologia Exemplo.

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 );
}

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 );
   }
}

Consulte também

Conceitos

marshaling de classes, estruturas e uniões

Tipos de dados de invocação de plataforma

Criando protótipos em código gerenciado