LayoutKind Sabit listesi

Tanım

Yönetilmeyen koda aktarıldığında nesnenin düzenini denetler.

C#
public enum LayoutKind
C#
[System.Serializable]
public enum LayoutKind
C#
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public enum LayoutKind
Devralma
LayoutKind
Öznitelikler

Alanlar

Name Değer Description
Auto 3

Çalışma zamanı, yönetilmeyen bellekteki bir nesnenin üyeleri için otomatik olarak uygun bir düzen seçer. Bu numaralandırma üyesiyle tanımlanan nesneler yönetilen kodun dışında gösterilemez. Bunu yapmak bir özel durum oluşturur.

Explicit 2

Bir nesnenin her üyesinin yönetilmeyen bellekteki tam konumu, alanın ayarına Pack bağlı olarak açıkça denetlenmektedir. Her üye, FieldOffsetAttribute bu alanın türü içindeki konumunu belirtmek için öğesini kullanmalıdır.

Sequential 0

Nesnenin üyeleri, yönetilmeyen belleğe aktarıldığında göründükleri sırayla sıralı olarak düzenlenir. Üyeler içinde belirtilen Packambalaja göre düzenlenir ve bitişik olmayabilir.

Örnekler

Aşağıdaki örnek, bir noktanın PtInRect dikdörtgen içinde olup olmadığını denetleyen ve Sıralı düzen ve Açık düzenli bir PointRect yapı tanımlayan işlevin yönetilen bildirimini gösterir.

C#
enum Bool
{
   False = 0,
   True
};
[StructLayout(LayoutKind.Sequential)]
public struct Point
{
   public int x;
   public int y;
}

[StructLayout(LayoutKind.Explicit)]
public struct Rect
{
   [FieldOffset(0)] public int left;
   [FieldOffset(4)] public int top;
   [FieldOffset(8)] public int right;
   [FieldOffset(12)] public int bottom;
}

internal static class NativeMethods
{
   [DllImport("user32.dll", CallingConvention=CallingConvention.StdCall)]
   internal static extern Bool PtInRect(ref Rect r, Point p);
};

class TestApplication
{
   public static void Main()
   {
      try
      {
         Bool bPointInRect = 0;
         Rect myRect = new Rect();
         myRect.left = 10;
         myRect.right = 100;
         myRect.top = 10;
         myRect.bottom = 100;
         Point myPoint = new Point();
         myPoint.x = 50;
         myPoint.y = 50;
         bPointInRect = NativeMethods.PtInRect(ref myRect, myPoint);
         if(bPointInRect == Bool.True)
            Console.WriteLine("Point lies within the Rect");
         else
            Console.WriteLine("Point did not lie within the Rect");
      }
      catch(Exception e)
      {
         Console.WriteLine("Exception : " + e.Message);
      }
   }
}

Açıklamalar

Bu numaralandırma ile StructLayoutAttributekullanılır. Ortak dil çalışma zamanı varsayılan olarak düzen değerini kullanır Auto . Değerle ilişkili düzen ile Auto ilgili sorunları azaltmak için C#, Visual Basic ve C++ derleyicileri değer türleri için düzen belirtir Sequential .

Önemli

Alan StructLayoutAttribute.Pack , veri alanlarının hizalamasını denetler ve bu nedenle belirttiğiniz değerden bağımsız olarak LayoutKind düzeni etkiler. Varsayılan olarak değeri Pack 0'dır ve bu değer geçerli platform için varsayılan paketleme boyutunu gösterir. Örneğin, düzen değerini kullandığınızda Explicit ve bayt sınırlarında alan hizalamaları belirttiğinizde, istenen sonucu elde etmek için 1 olarak ayarlamanız Pack gerekir.

Şunlara uygulanır

Ürün Sürümler
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0