StructLayoutAttribute Kelas

Definisi

Ruang nama:

System.Runtime.InteropServices

Rakitan:

System.Runtime.dll

Sumber:

StructLayoutAttribute.cs

Memungkinkan Anda mengontrol tata letak fisik bidang data kelas atau struktur dalam memori.

public ref class StructLayoutAttribute sealed : Attribute

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

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

Public NotInheritable Class StructLayoutAttribute
Inherits Attribute

Warisan

Object

Attribute

StructLayoutAttribute

Atribut

AttributeUsageAttribute

Contoh

Contoh berikut menunjukkan deklarasi fungsi terkelola GetSystemTime dan menentukan MySystemTime kelas dengan LayoutKind.Explicit tata letak. GetSystemTime mendapatkan waktu sistem dan mencetak ke konsol.

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

Keterangan

Anda dapat menerapkan atribut ini ke kelas atau struktur.

Runtime bahasa umum mengontrol tata letak fisik bidang data kelas atau struktur dalam memori terkelola. Namun, jika Anda ingin meneruskan jenis ke kode yang tidak dikelola, Anda dapat menggunakan StructLayoutAttribute atribut untuk mengontrol tata letak jenis yang tidak dikelola. Gunakan atribut dengan LayoutKind.Sequential untuk memaksa anggota ditata secara berurutan dalam urutan yang mereka munculkan. Untuk jenis blittable, LayoutKind.Sequential mengontrol tata letak dalam memori terkelola dan tata letak dalam memori yang tidak dikelola. Untuk jenis yang tidak dapat di-blittable, ia mengontrol tata letak ketika kelas atau struktur dinamai ke kode yang tidak dikelola, tetapi tidak mengontrol tata letak dalam memori terkelola. Gunakan atribut dengan LayoutKind.Explicit untuk mengontrol posisi yang tepat dari setiap anggota data. Ini mempengaruhi tata letak terkelola dan tidak terkelola, untuk jenis yang dapat di-blittable dan tidak dapat di-blittable. Menggunakan LayoutKind.Explicit mengharuskan Anda menggunakan FieldOffsetAttribute atribut untuk menunjukkan posisi setiap bidang dalam jenis .

Pengkompilasi C#, Visual Basic, dan C++ menerapkan Sequential nilai tata letak ke struktur secara default. Untuk kelas, Anda harus menerapkan LayoutKind.Sequential nilai secara eksplisit. Tlbimp.exe (Type Library Importer) juga menerapkan StructLayoutAttribute atribut ; selalu menerapkan LayoutKind.Sequential nilai saat mengimpor pustaka jenis.

Konstruktor

StructLayoutAttribute(Int16)	Menginisialisasi instans StructLayoutAttribute baru kelas dengan anggota enumerasi yang ditentukan LayoutKind .
StructLayoutAttribute(LayoutKind)	Menginisialisasi instans StructLayoutAttribute baru kelas dengan anggota enumerasi yang ditentukan LayoutKind .

Bidang

CharSet	Menunjukkan apakah bidang data string dalam kelas harus dinamai sebagai LPWSTR atau LPSTR secara default.
Pack	Mengontrol perataan bidang data dari kelas atau struktur dalam memori.
Size	Menunjukkan ukuran mutlak kelas atau struktur.

Properti

TypeId	Ketika diimplementasikan di kelas turunan, mendapatkan pengidentifikasi unik untuk ini Attribute. (Diperoleh dari Attribute)
Value	LayoutKind Mendapatkan nilai yang menentukan bagaimana kelas atau struktur diatur.

Metode

Equals(Object)	Mengembalikan nilai yang menunjukkan apakah instans ini sama dengan objek tertentu. (Diperoleh dari Attribute)
GetHashCode()	Mengembalikan kode hash untuk instans ini. (Diperoleh dari Attribute)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
IsDefaultAttribute()	Ketika ditimpa di kelas turunan, menunjukkan apakah nilai instans ini adalah nilai default untuk kelas turunan. (Diperoleh dari Attribute)
Match(Object)	Saat ditimpa di kelas turunan, mengembalikan nilai yang menunjukkan apakah instans ini sama dengan objek tertentu. (Diperoleh dari Attribute)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Lihat juga

• Tlbimp.exe ( Pengimpor Pustaka Jenis)