StructLayoutAttribute Clase

Definición

Espacio de nombres:

System.Runtime.InteropServices

Ensamblado:

System.Runtime.dll

Source:

StructLayoutAttribute.cs

Le permite controlar el diseño físico de los campos de datos de una clase o una estructura en la memoria.

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

Herencia

Object

Attribute

StructLayoutAttribute

Atributos

AttributeUsageAttribute

Ejemplos

En el ejemplo siguiente se muestra una declaración administrada de la función y se MySystemTime define la GetSystemTime clase con LayoutKind.Explicit el diseño. GetSystemTime obtiene la hora del sistema e imprime en la consola.

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

Comentarios

Puede aplicar este atributo a clases o estructuras.

Common Language Runtime controla el diseño físico de los campos de datos de una clase o estructura en memoria administrada. Sin embargo, si desea pasar el tipo al código no administrado, puede usar el StructLayoutAttribute atributo para controlar el diseño no administrado del tipo. Use el atributo con LayoutKind.Sequential para forzar que los miembros se establezcan secuencialmente en el orden en que aparecen. En el caso de los tipos de tabla de bits, LayoutKind.Sequential controla el diseño en memoria administrada y el diseño en memoria no administrada. En el caso de los tipos no blittables, controla el diseño cuando la clase o estructura se serializa en código no administrado, pero no controla el diseño en memoria administrada. Use el atributo con LayoutKind.Explicit para controlar la posición precisa de cada miembro de datos. Esto afecta tanto al diseño administrado como al no administrado, tanto para los tipos blittables como para los que no se pueden transferir en bloque. El uso LayoutKind.Explicit de requiere que use el FieldOffsetAttribute atributo para indicar la posición de cada campo dentro del tipo.

Los compiladores de C#, Visual Basic y C++ aplican el valor de Sequential diseño a las estructuras de forma predeterminada. Para las clases, debe aplicar el LayoutKind.Sequential valor explícitamente. Tlbimp.exe (Importador de biblioteca de tipos) también aplica el StructLayoutAttribute atributo ; siempre aplica el LayoutKind.Sequential valor cuando importa una biblioteca de tipos.

Constructores

StructLayoutAttribute(Int16)	Inicializa una nueva instancia de la clase StructLayoutAttribute con el miembro de enumeración LayoutKind especificado.
StructLayoutAttribute(LayoutKind)	Inicializa una nueva instancia de la clase StructLayoutAttribute con el miembro de enumeración LayoutKind especificado.

Campos

CharSet	Indica si las referencias de los campos de datos de cadena dentro de la clase deben calcularse como LPWSTR o LPSTR de forma predeterminada.
Pack	Controla la alineación de los campos de datos de una clase o una estructura en la memoria.
Size	Indica el tamaño absoluto de la clase o estructura.

Propiedades

TypeId	Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute. (Heredado de Attribute)
Value	Obtiene el valor de LayoutKind que especifica la forma en que está organizada la clase o estructura.

Métodos

Equals(Object)	Devuelve un valor que indica si esta instancia es igual que un objeto especificado. (Heredado de Attribute)
GetHashCode()	Devuelve el código hash de esta instancia. (Heredado de Attribute)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
IsDefaultAttribute()	Si se reemplaza en una clase derivada, indica si el valor de esta instancia es el valor predeterminado de la clase derivada. (Heredado de Attribute)
Match(Object)	Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado. (Heredado de Attribute)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Consulte también

• TlbImp.exe (Importador de la biblioteca de tipos)