StructLayoutAttribute Sınıf

Tanım

Ad Alanı:

System.Runtime.InteropServices

Bütünleştirilmiş Kod:

System.Runtime.dll

Kaynak:

StructLayoutAttribute.cs

Bellekteki bir sınıfın veya yapının veri alanlarının fiziksel düzenini denetlemenizi sağlar.

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

Devralma

Object

Attribute

StructLayoutAttribute

Öznitelikler

AttributeUsageAttribute

Örnekler

Aşağıdaki örnek, işlevin yönetilen bildirimini GetSystemTime gösterir ve düzeni olan LayoutKind.Explicit sınıfı tanımlarMySystemTime. GetSystemTime sistem saatini alır ve konsola yazdırır.

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

Açıklamalar

Bu özniteliği sınıflara veya yapılara uygulayabilirsiniz.

Ortak dil çalışma zamanı, yönetilen bellekteki bir sınıfın veya yapının veri alanlarının fiziksel düzenini denetler. Ancak, türü yönetilmeyen koda geçirmek istiyorsanız, türün StructLayoutAttribute yönetilmeyen düzenini denetlemek için özniteliğini kullanabilirsiniz. Üyeleri göründükleri sırayla sıralı olarak yerleştirilmeye zorlamak için ile LayoutKind.Sequential özniteliğini kullanın. Kesilebilir türler için hem LayoutKind.Sequential yönetilen bellekteki düzeni hem de yönetilmeyen bellekteki düzeni denetler. Bölünebilir olmayan türler için, sınıf veya yapı yönetilmeyen koda sıralandığında düzeni denetler, ancak yönetilen bellekteki düzeni denetlemez. Her veri üyesinin tam konumunu denetlemek için özniteliğini ile LayoutKind.Explicit kullanın. Bu, hem blittable hem de blittable olmayan türler için hem yönetilen hem de yönetilmeyen düzeni etkiler. kullanmak LayoutKind.Explicit , türündeki FieldOffsetAttribute her alanın konumunu belirtmek için özniteliğini kullanmanızı gerektirir.

C#, Visual Basic ve C++ derleyicileri düzen değerini varsayılan olarak yapılara uygular Sequential . Sınıflar için değeri açıkça uygulamanız LayoutKind.Sequential gerekir. Tlbimp.exe (Tür Kitaplığı İçeri Aktarıcısı) özniteliğini de uygular StructLayoutAttribute ; tür kitaplığını içeri aktardığında her zaman değeri uygular LayoutKind.Sequential .

Oluşturucular

StructLayoutAttribute(Int16)	Belirtilen LayoutKind numaralandırma üyesiyle sınıfının yeni bir örneğini StructLayoutAttribute başlatır.
StructLayoutAttribute(LayoutKind)	Belirtilen LayoutKind numaralandırma üyesiyle sınıfının yeni bir örneğini StructLayoutAttribute başlatır.

Alanlar

CharSet	sınıfındaki dize veri alanlarının varsayılan olarak mı yoksa olarak LPWSTR mı LPSTR sıralanması gerektiğini gösterir.
Pack	Bellekteki bir sınıfın veya yapının veri alanlarının hizalamasını denetler.
Size	Sınıfın veya yapının mutlak boyutunu gösterir.

Özellikler

TypeId	Türetilmiş bir sınıfta uygulandığında, bu Attributeiçin benzersiz bir tanımlayıcı alır. (Devralındığı yer: Attribute)
Value	Sınıfın LayoutKind veya yapının nasıl düzenlendiğini belirten değeri alır.

Yöntemler

Equals(Object)	Bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değeri döndürür. (Devralındığı yer: Attribute)
GetHashCode()	Bu örneğe ilişkin karma kodu döndürür. (Devralındığı yer: Attribute)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
IsDefaultAttribute()	Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin değerinin türetilmiş sınıf için varsayılan değer olup olmadığını gösterir. (Devralındığı yer: Attribute)
Match(Object)	Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değer döndürür. (Devralındığı yer: Attribute)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Ayrıca bkz.

• Tlbimp.exe (Tür Kitaplığı İçeri Aktarıcı)