StructLayoutAttribute.Pack Campo
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Controla la alineación de los campos de datos de una clase o una estructura en la memoria.
public: int Pack;public int Pack;val mutable Pack : intPublic Pack As Integer Valor de campo
Comentarios
El Pack campo controla la alineación de los campos de un tipo en memoria. Afecta a LayoutKind.Sequential. De forma predeterminada, el valor es 0, que indica el tamaño de empaquetado predeterminado para la plataforma actual. El valor de Pack debe ser 0, 1, 2, 4, 8, 16, 32, 64 o 128:
Los campos de una instancia de tipo se alinean mediante las reglas siguientes:
La alineación del tipo es el tamaño de su elemento más grande (1, 2, 4, 8, etc., bytes) o el tamaño de empaquetado especificado, lo que sea menor.
Cada campo debe alinearse con los campos de su propio tamaño (1, 2, 4, 8, etc., bytes) o la alineación del tipo, lo que sea menor. Dado que la alineación predeterminada del tipo es el tamaño de su elemento más grande, que es mayor o igual que todas las demás longitudes de campo, esto suele significar que los campos están alineados por su tamaño. Por ejemplo, incluso si el campo más grande de un tipo es un entero de 64 bits (8 bytes) o el campo Pack se establece en 8, Byte los campos se alinean en límites de 1 byte, Int16 los campos se alinean en límites de 2 bytes y Int32 los campos se alinean en límites de 4 bytes.
El relleno se agrega entre campos para satisfacer los requisitos de alineación.
Por ejemplo, considere la siguiente estructura, que consta de dos Byte campos y un Int32 campo, cuando se usa con varios valores para el Pack campo.
using System;
struct ExampleStruct
{
public byte b1;
public byte b2;
public int i3;
}
Importante
Para compilar correctamente los ejemplos de C#, debe especificar el /unsafe modificador del compilador.
Si especifica el tamaño de empaquetado predeterminado, el tamaño de la estructura es de 8 bytes. Los dos bytes ocupan los dos primeros bytes de memoria, ya que los bytes deben alinearse en límites de un byte. Dado que la alineación predeterminada del tipo es de 4 bytes, que es el tamaño de sus campos más grandes, i3, hay dos bytes de relleno seguidos del campo entero.
using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, Pack=0)]
struct ExampleStruct
{
public byte b1;
public byte b2;
public int i3;
}
public class Example
{
public unsafe static void Main()
{
ExampleStruct ex = new ExampleStruct();
byte* addr = (byte*) &ex;
Console.WriteLine("Size: {0}", sizeof(ExampleStruct));
Console.WriteLine("b1 Offset: {0}", &ex.b1 - addr);
Console.WriteLine("b2 Offset: {0}", &ex.b2 - addr);
Console.WriteLine("i3 Offset: {0}", (byte*) &ex.i3 - addr);
}
}
// The example displays the following output:
// Size: 8
// b1 Offset: 0
// b2 Offset: 1
// i3 Offset: 4
Si Pack se establece en 2, el tamaño de la estructura es de 6 bytes. Como antes, los dos bytes ocupan los dos primeros bytes de memoria. Dado que los campos se alinean ahora en límites de 2 bytes, no hay relleno entre el segundo byte y el entero.
using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, Pack=2)]
struct ExampleStruct
{
public byte b1;
public byte b2;
public int i3;
}
public class Example
{
public unsafe static void Main()
{
ExampleStruct ex = new ExampleStruct();
byte* addr = (byte*) &ex;
Console.WriteLine("Size: {0}", sizeof(ExampleStruct));
Console.WriteLine("b1 Offset: {0}", &ex.b1 - addr);
Console.WriteLine("b2 Offset: {0}", &ex.b2 - addr);
Console.WriteLine("i3 Offset: {0}", (byte*) &ex.i3 - addr);
}
}
// The example displays the following output:
// Size: 6
// b1 Offset: 0
// b2 Offset: 1
// i3 Offset: 2
Si Pack se establece en 4, el tamaño de la estructura es el mismo que en el caso predeterminado, donde la alineación del tipo se definió mediante el tamaño de su campo más grande, i3, que es 4.
using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, Pack=4)]
struct ExampleStruct
{
public byte b1;
public byte b2;
public int i3;
}
public class Example
{
public unsafe static void Main()
{
ExampleStruct ex = new ExampleStruct();
byte* addr = (byte*) &ex;
Console.WriteLine("Size: {0}", sizeof(ExampleStruct));
Console.WriteLine("b1 Offset: {0}", &ex.b1 - addr);
Console.WriteLine("b2 Offset: {0}", &ex.b2 - addr);
Console.WriteLine("i3 Offset: {0}", (byte*) &ex.i3 - addr);
}
}
// The example displays the following output:
// Size: 8
// b1 Offset: 0
// b2 Offset: 1
// i3 Offset: 4
Si Pack se establece en 8, el tamaño de la estructura sigue siendo el mismo que en el caso predeterminado, porque el i3 campo se alinea en un límite de 4 bytes, que es menor que el límite de 8 bytes especificado por el campo Pack.
using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, Pack=8)]
struct ExampleStruct
{
public byte b1;
public byte b2;
public int i3;
}
public class Example
{
public unsafe static void Main()
{
ExampleStruct ex = new ExampleStruct();
byte* addr = (byte*) &ex;
Console.WriteLine("Size: {0}", sizeof(ExampleStruct));
Console.WriteLine("b1 Offset: {0}", &ex.b1 - addr);
Console.WriteLine("b2 Offset: {0}", &ex.b2 - addr);
Console.WriteLine("i3 Offset: {0}", (byte*) &ex.i3 - addr);
}
}
// The example displays the following output:
// Size: 8
// b1 Offset: 0
// b2 Offset: 1
// i3 Offset: 4
Para tomar otro ejemplo, considere la siguiente estructura, que consta de dos campos de bytes, un campo entero de 32 bits con signo, una matriz de bytes de un solo elemento y un valor decimal. Con el tamaño de empaquetado predeterminado, el tamaño de la estructura es de 28 bytes. Los dos bytes ocupan los dos primeros bytes de memoria, seguidos de dos bytes de relleno, seguidos del entero. A continuación, se muestra la matriz de un byte, seguida de tres bytes de relleno. Por último, el Decimal campo, d5, se alinea en un límite de 4 bytes porque un valor decimal consta de cuatro Int32 campos, por lo que su alineación se basa en el tamaño del mayor de sus campos en lugar del tamaño de la Decimal estructura en su conjunto.
using System;
using System.Runtime.InteropServices;
unsafe struct ExampleStruct2
{
public byte b1;
public byte b2;
public int i3;
public fixed byte a4[1];
public decimal d5;
}
public class Example
{
public unsafe static void Main()
{
ExampleStruct2 ex = new ExampleStruct2();
byte* addr = (byte*) &ex;
Console.WriteLine("Size: {0}", sizeof(ExampleStruct2));
Console.WriteLine("b1 Offset: {0}", &ex.b1 - addr);
Console.WriteLine("b2 Offset: {0}", &ex.b2 - addr);
Console.WriteLine("i3 Offset: {0}", (byte*) &ex.i3 - addr);
Console.WriteLine("a4 Offset: {0}", ex.a4 - addr);
Console.WriteLine("d5 Offset: {0}", (byte*) &ex.d5 - addr);
}
}
// The example displays the following output:
// Size: 28
// b1 Offset: 0
// b2 Offset: 1
// i3 Offset: 4
// a4 Offset: 8
// d5 Offset: 12
Si Pack se establece en 2, el tamaño de la estructura es de 24 bytes. En comparación con la alineación predeterminada, los dos bytes de relleno entre los dos bytes y el entero se han quitado porque la alineación del tipo es ahora 4 en lugar de 2. Y los tres bytes de relleno después a4 de haber sido reemplazados por un byte de relleno, ya que d5 ahora se alinea en un límite de 2 bytes en lugar de un límite de 4 bytes.
using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, Pack = 2)]
unsafe struct ExampleStruct2
{
public byte b1;
public byte b2;
public int i3;
public fixed byte a4[1];
public decimal d5;
}
public class Example
{
public unsafe static void Main()
{
ExampleStruct2 ex = new ExampleStruct2();
byte* addr = (byte*) &ex;
Console.WriteLine("Size: {0}", sizeof(ExampleStruct2));
Console.WriteLine("b1 Offset: {0}", &ex.b1 - addr);
Console.WriteLine("b2 Offset: {0}", &ex.b2 - addr);
Console.WriteLine("i3 Offset: {0}", (byte*) &ex.i3 - addr);
Console.WriteLine("a4 Offset: {0}", ex.a4 - addr);
Console.WriteLine("d5 Offset: {0}", (byte*) &ex.d5 - addr);
}
}
// The example displays the following output:
// Size: 24
// b1 Offset: 0
// b2 Offset: 1
// i3 Offset: 2
// a4 Offset: 6
// d5 Offset: 8
Si Pack se establece en 8, el tamaño de la estructura es el mismo que en el caso predeterminado, porque todos los requisitos de alineación de esta estructura son inferiores a 8.
using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, Pack = 8)]
unsafe struct ExampleStruct2
{
public byte b1;
public byte b2;
public int i3;
public fixed byte a4[1];
public decimal d5;
}
public class Example
{
public unsafe static void Main()
{
ExampleStruct2 ex = new ExampleStruct2();
byte* addr = (byte*) &ex;
Console.WriteLine("Size: {0}", sizeof(ExampleStruct2));
Console.WriteLine("b1 Offset: {0}", &ex.b1 - addr);
Console.WriteLine("b2 Offset: {0}", &ex.b2 - addr);
Console.WriteLine("i3 Offset: {0}", (byte*) &ex.i3 - addr);
Console.WriteLine("a4 Offset: {0}", ex.a4 - addr);
Console.WriteLine("d5 Offset: {0}", (byte*) &ex.d5 - addr);
}
}
// The example displays the following output:
// Size: 28
// b1 Offset: 0
// b2 Offset: 1
// i3 Offset: 4
// a4 Offset: 8
// d5 Offset: 12
El Pack campo se usa con frecuencia cuando las estructuras se exportan durante las operaciones de escritura de disco y red. El campo también se usa con frecuencia durante las operaciones de invocación e interoperabilidad de la plataforma.
En ocasiones, el campo se usa para reducir los requisitos de memoria mediante la producción de un tamaño de empaquetado más ajustado. Sin embargo, este uso requiere una consideración cuidadosa de las restricciones de hardware reales y puede degradar realmente el rendimiento.
Se aplica a
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de