StructLayoutAttribute Klasse

Definition

Namespace:

System.Runtime.InteropServices

Assembly:

mscorlib.dll

Hiermit können Sie das physische Layout der Datenfelder einer Klasse oder Struktur im Arbeitsspeicher steuern.

public ref class StructLayoutAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Struct, Inherited=false)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class StructLayoutAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Struct, Inherited=false)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type StructLayoutAttribute = class
    inherit Attribute

Public NotInheritable Class StructLayoutAttribute
Inherits Attribute

Vererbung

Object

Attribute

StructLayoutAttribute

Attribute

AttributeUsageAttribute ComVisibleAttribute

Beispiele

Das folgende Beispiel veranschaulicht eine verwaltete Deklaration der GetSystemTime Funktion und definiert MySystemTime die Klasse mit LayoutKind.Explicit layout. GetSystemTime ruft die Systemzeit ab und druckt sie in der Konsole.

using namespace System;
using namespace System::Runtime::InteropServices;


[StructLayout(LayoutKind::Explicit,Size=16,CharSet=CharSet::Ansi)]
value class MySystemTime
{
public:

   [FieldOffset(0)]
   short wYear;

   [FieldOffset(2)]
   short wMonth;

   [FieldOffset(4)]
   short wDayOfWeek;

   [FieldOffset(6)]
   short wDay;

   [FieldOffset(8)]
   short wHour;

   [FieldOffset(10)]
   short wMinute;

   [FieldOffset(12)]
   short wSecond;

   [FieldOffset(14)]
   short wMilliseconds;
};

ref class NativeMethods
{
public:

   [DllImport("kernel32.dll")]
   static void GetSystemTime( MySystemTime * st );
};

int main()
{
   try
   {
      MySystemTime sysTime;
      NativeMethods::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 : {0}", e->Message );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "Exception : {0}", e->Message );
   }

}

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

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

   class TestApplication
   {
      public static void Main()
      {
         try
         {
            MySystemTime sysTime = new MySystemTime();
            NativeMethods.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);
         }
      }
   }
}

Imports System.Runtime.InteropServices

Namespace InteropSample

   <StructLayout(LayoutKind.Explicit, Size:=16, CharSet:=CharSet.Ansi)> _
   Public Class MySystemTime
      <FieldOffset(0)> Public wYear As Short
      <FieldOffset(2)> Public wMonth As Short
      <FieldOffset(4)> Public wDayOfWeek As Short
      <FieldOffset(6)> Public wDay As Short
      <FieldOffset(8)> Public wHour As Short
      <FieldOffset(10)> Public wMinute As Short
      <FieldOffset(12)> Public wSecond As Short
      <FieldOffset(14)> Public wMilliseconds As Short
   End Class


   Friend Class NativeMethods

      <DllImport("kernel32.dll")> _
      Friend Shared Sub GetSystemTime(<MarshalAs(UnmanagedType.LPStruct)> ByVal st As MySystemTime)
      End Sub
   End Class

   Class TestApplication

      Public Shared Sub Main()
         Try
            Dim sysTime As New MySystemTime()
            NativeMethods.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 e As TypeLoadException
            Console.WriteLine(("TypeLoadException : " + e.Message.ToString()))
         Catch e As Exception
            Console.WriteLine(("Exception : " + e.Message.ToString()))
         End Try
      End Sub
   End Class
End Namespace 'InteropSample

Hinweise

Sie können dieses Attribut auf Klassen oder Strukturen anwenden.

Die Common Language Runtime steuert das physische Layout der Datenfelder einer Klasse oder Struktur im verwalteten Speicher. Wenn Sie den Typ jedoch an nicht verwalteten Code übergeben möchten, können Sie das StructLayoutAttribute Attribut verwenden, um das nicht verwaltete Layout des Typs zu steuern. Verwenden Sie das Attribut, LayoutKind.Sequential um zu erzwingen, dass die Elemente sequenziell in der Reihenfolge angeordnet werden, in der sie angezeigt werden. Steuert für teilbare Typen LayoutKind.Sequential sowohl das Layout im verwalteten Speicher als auch das Layout im nicht verwalteten Speicher. Bei nicht teilbaren Typen steuert sie das Layout, wenn die Klasse oder Struktur an nicht verwalteten Code gemarstet wird, aber nicht das Layout im verwalteten Speicher steuert. Verwenden Sie das Attribut, LayoutKind.Explicit um die genaue Position jedes Datenelements zu steuern. Dies wirkt sich sowohl auf das verwaltete als auch auf das nicht verwaltete Layout aus, sowohl für blittbare als auch für nicht bearbeitbare Typen. Die Verwendung LayoutKind.Explicit erfordert, dass Sie das FieldOffsetAttribute Attribut verwenden, um die Position jedes Felds innerhalb des Typs anzugeben.

C#-, Visual Basic- und C++-Compiler wenden standardmäßig den Sequential Layoutwert auf Strukturen an. Für Klassen müssen Sie den LayoutKind.Sequential Wert explizit anwenden. Tlbimp.exe (Type Library Importer) wendet auch das StructLayoutAttribute Attribut an. Er wendet immer den LayoutKind.Sequential Wert an, wenn eine Typbibliothek importiert wird.

Konstruktoren

Name	Beschreibung
StructLayoutAttribute(Int16)	Initialisiert eine neue Instanz der StructLayoutAttribute Klasse mit dem angegebenen LayoutKind Enumerationsmememm.
StructLayoutAttribute(LayoutKind)	Initialisiert eine neue Instanz der StructLayoutAttribute Klasse mit dem angegebenen LayoutKind Enumerationsmememm.

Felder

Name	Beschreibung
CharSet	Gibt an, ob Zeichenfolgendatenfelder innerhalb der Klasse standardmäßig LPWSTRLPSTR gemarstet werden sollen.
Pack	Steuert die Ausrichtung von Datenfeldern einer Klasse oder Struktur im Arbeitsspeicher.
Size	Gibt die absolute Größe der Klasse oder Struktur an.

Eigenschaften

Name	Beschreibung
TypeId	Wenn sie in einer abgeleiteten Klasse implementiert wird, wird ein eindeutiger Bezeichner für diese Attribute. (Geerbt von Attribute)
Value	Ruft den Wert ab, der LayoutKind angibt, wie die Klasse oder Struktur angeordnet wird.

Methoden

Name	Beschreibung
Equals(Object)	Gibt einen Wert zurück, der angibt, ob diese Instanz einem angegebenen Objekt entspricht. (Geerbt von Attribute)
GetHashCode()	Gibt den Hashcode für diesen instance zurück. (Geerbt von Attribute)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
IsDefaultAttribute()	Wenn sie in einer abgeleiteten Klasse überschrieben wird, gibt an, ob der Wert dieser Instanz der Standardwert für die abgeleitete Klasse ist. (Geerbt von Attribute)
Match(Object)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem angegebenen Objekt entspricht. (Geerbt von Attribute)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

Name	Beschreibung
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu. (Geerbt von Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Ruft die Typinformationen für ein Objekt ab, mit denen die Typinformationen für eine Schnittstelle abgerufen werden können. (Geerbt von Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1). (Geerbt von Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Bietet Zugriff auf Eigenschaften und Methoden, die von einem Objekt verfügbar gemacht werden. (Geerbt von Attribute)

Weitere Informationen

• Tlbimp.exe (Typbibliotheksimporteur)