StructLayoutAttribute-Klasse

Dieses Attribut kann auf Klassen oder Strukturen angewendet werden.

Die Common Language Runtime steuert das physische Layout der Datenfelder einer Klasse oder Struktur im verwalteten Speicher. Wenn Sie jedoch den Typ an nicht verwalteten Code übergeben möchten, verwenden Sie können StructLayoutAttribute-Attribut, um den nicht verwalteten Layouts des Typs zu steuern. Verwenden Sie das Attribut mit LayoutKind.Sequential um die sequenziell in der Reihenfolge angeordnet werden Member zu erzwingen, werden sie. Eine blitfähige Typenund LayoutKind.Sequential steuert das Layout im verwalteten Speicher und des Layouts im nicht verwalteten Speicher. Für nicht blitfähige Typen steuert das Layout, wenn die Klasse oder Struktur an nicht verwalteten Code gemarshallt wird, aber steuert nicht das Layout im verwalteten Speicher. Verwenden Sie das Attribut mit LayoutKind.Explicit Die genaue Position eines Datenmembers zu steuern. Dies betrifft verwaltete und nicht verwaltete Layout für Blittable and nicht blitfähige Typen. Anwendung LayoutKind.Explicit Erfordert, dass Sie verwenden FieldOffsetAttribute-Attribut, um die Position jedes Felds im Typ anzugeben.

C#-, Visual Basic- und C++-Compiler wenden den Sequential-Layoutwert standardmäßig auf Strukturen an. Bei Klassen müssen Sie den LayoutKind.Sequential-Wert explizit anwenden. Außerdem übernimmt Tlbimp.exe (Type Library Importer-Tool) das StructLayoutAttribute-Attribut. Es wird stets der LayoutKind.Sequential-Wert angewendet, wenn eine Typbibliothek importiert wird.

Im folgenden Beispiel wird eine verwaltete Deklaration der GetSystemTime-Funktion veranschaulicht, und es wird die MySystemTime-Klasse mit LayoutKind.Explicit-Layout definiert. GetSystemTime wird die Systemzeit ab und gibt an die Konsole ausgegeben.

using System;
using System.Runtime.InteropServices;

namespace InteropSample
{   

   [StructLayout(LayoutKind.Explicit, Size=16, CharSet=CharSet.Ansi)]
   public class MySystemTime 
   {
      [FieldOffset(0)]public ushort wYear; 
      [FieldOffset(2)]public ushort wMonth;
      [FieldOffset(4)]public ushort wDayOfWeek; 
      [FieldOffset(6)]public ushort wDay; 
      [FieldOffset(8)]public ushort wHour; 
      [FieldOffset(10)]public ushort wMinute; 
      [FieldOffset(12)]public ushort wSecond; 
      [FieldOffset(14)]public ushort wMilliseconds; 
   }

   class LibWrapper
   {
      [DllImport("kernel32.dll")]
      public static extern void GetSystemTime([MarshalAs(UnmanagedType.LPStruct)]MySystemTime st);
   };

   class TestApplication
   {      
      public static void Main()
      {
         try
         {
            MySystemTime sysTime = new MySystemTime();
            LibWrapper.GetSystemTime(sysTime);
            Console.WriteLine("The System time is {0}/{1}/{2} {3}:{4}:{5}", sysTime.wDay,
               sysTime.wMonth, sysTime.wYear, sysTime.wHour, sysTime.wMinute, sysTime.wSecond);            
         }         
         catch(TypeLoadException e)
         {
            Console.WriteLine("TypeLoadException : " + e.Message);
         }
         catch(Exception e)
         {
            Console.WriteLine("Exception : " + e.Message);
         }
      }
   }
}

.NET Framework

.NET Framework Client Profile

Portable Klassenbibliothek

.NET für Windows Store-Apps

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Referenz

Weitere Ressourcen