StructLayoutAttribute-Klasse
Die StructLayoutAttribute-Klasse ermöglicht es dem Benutzer, das physikalische Layout der Datenfelder einer Klasse oder Struktur zu steuern.
Namespace: System.Runtime.InteropServices
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
<ComVisibleAttribute(True)> _
<AttributeUsageAttribute(AttributeTargets.Class Or AttributeTargets.Struct, Inherited:=False)> _
Public NotInheritable Class StructLayoutAttribute
Inherits Attribute
'Usage
Dim instance As StructLayoutAttribute
[ComVisibleAttribute(true)]
[AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Struct, Inherited=false)]
public sealed class StructLayoutAttribute : Attribute
[ComVisibleAttribute(true)]
[AttributeUsageAttribute(AttributeTargets::Class|AttributeTargets::Struct, Inherited=false)]
public ref class StructLayoutAttribute sealed : public Attribute
/** @attribute ComVisibleAttribute(true) */
/** @attribute AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Struct, Inherited=false) */
public final class StructLayoutAttribute extends Attribute
ComVisibleAttribute(true)
AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Struct, Inherited=false)
public final class StructLayoutAttribute extends Attribute
Hinweise
Dieses Attribut kann auf Klassen oder Strukturen angewendet werden.
Das physikalische Layout der Datenfelder einer Klasse oder Struktur in verwaltetem Speicher wird i. d. R. von der Common Language Runtime gesteuert. Wenn die Klasse oder Struktur auf eine bestimmte Art angeordnet werden soll, können Sie StructLayoutAttribute verwenden. Die explizite Steuerung eines Klassenlayouts ist von großer Bedeutung, wenn die Klasse an nicht verwalteten Code übergeben wird, der ein bestimmtes Layout erwartet. Der LayoutKind-Wert Sequential wird verwendet, um die sequenzielle Anordnung der Member in der Reihenfolge zu erzwingen, in der sie auftreten. Explicit wird zum Steuern der genauen Position der einzelnen Datenmember verwendet. Bei Explicit muss jedes Member FieldOffsetAttribute verwenden, um die Position dieses Felds innerhalb des Typs anzugeben.
C#-, Visual Basic-, .NET- und C++-Compiler wenden den Sequential-Layoutwert standardmäßig auf Strukturen an. Bei Klassen müssen Sie den Sequential-Wert explizit anwenden. Type Library Importer-Tool (Tlbimp.exe) wendet dieses Attribut ebenfalls an. Der Sequential-Wert wird immer dann angewendet, wenn eine Typbibliothek importiert wird.
Beispiel
Im folgenden Beispiel wird eine verwaltete Deklaration der GetSystemTime-Funktion veranschaulicht, und es wird die MySystemTime-Klasse mit LayoutKind.Explicit-Layout definiert. GetSystemTime ruft die Systemzeit ab und gibt diese auf der Konsole aus.
<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 'MySystemTime
Class LibWrapper
<DllImport("kernel32.dll")> _
Public Shared Sub GetSystemTime(<MarshalAs(UnmanagedType.LPStruct)> st As MySystemTime)
End SUb
End Class 'LibWrapper
Class TestApplication
Public Shared Sub Main()
Try
Dim sysTime As 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 e As TypeLoadException
Console.WriteLine(("TypeLoadException : " + e.Message.ToString()))
Catch e As Exception
Console.WriteLine(("Exception : " + e.Message.ToString()))
End Try
End Sub 'Main
End Class 'TestApplication
End 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);
}
}
}
[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 LibWrapper
{
public:
[DllImport("kernel32.dll")]
static void GetSystemTime( MySystemTime * st );
};
int main()
{
try
{
MySystemTime sysTime;
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 : {0}", e->Message );
}
catch ( Exception^ e )
{
Console::WriteLine( "Exception : {0}", e->Message );
}
}
/** @attribute StructLayout(LayoutKind.Explicit, Size = 16,
CharSet = CharSet.Ansi)
*/
public class MySystemTime
{
/** @attribute FieldOffset(0)
*/
public short wYear;
/** @attribute FieldOffset(2)
*/
public short wMonth;
/** @attribute FieldOffset(4)
*/
public short wDayOfWeek;
/** @attribute FieldOffset(6)
*/
public short wDay;
/** @attribute FieldOffset(8)
*/
public short wHour;
/** @attribute FieldOffset(10)
*/
public short wMinute;
/** @attribute FieldOffset(12)
*/
public short wSecond;
/** @attribute FieldOffset(14)
*/
public short wMilliseconds;
} //MySystemTime
class LibWrapper
{
/** @attribute DllImport("kernel32.dll")
*/
public static native void GetSystemTime(
/** @attribute MarshalAs(UnmanagedType.LPStruct)
*/
MySystemTime st);
} //LibWrapper
class TestApplication
{
public static void main(String[] args)
{
try {
MySystemTime sysTime = new MySystemTime();
LibWrapper.GetSystemTime(sysTime);
Console.WriteLine("The System time is {0}/{1}/{2} {3}:{4}:{5}",
new Object[] { (Int32)sysTime.wDay, (Int32)sysTime.wMonth,
(Int32)sysTime.wYear, (Int32)sysTime.wHour, (Int32)sysTime.
wMinute, (Int32)sysTime.wSecond });
}
catch (TypeLoadException e) {
Console.WriteLine("TypeLoadException : " + e.get_Message());
}
catch (System.Exception e) {
Console.WriteLine("Exception : " + e.get_Message());
}
} //main
} //TestApplication
Vererbungshierarchie
System.Object
System.Attribute
System.Runtime.InteropServices.StructLayoutAttribute
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0, 1.0
Siehe auch
Referenz
StructLayoutAttribute-Member
System.Runtime.InteropServices-Namespace