Type.IsExplicitLayout Propriedade

Definição

Namespace:

System

Assemblies:

netstandard.dll, System.Runtime.dll

Origem:

Type.cs

Obtém um valor que indica se os campos do tipo atual são dispostos em deslocamentos explicitamente especificados.

public:
 property bool IsExplicitLayout { bool get(); };

public bool IsExplicitLayout { get; }

member this.IsExplicitLayout : bool

Public ReadOnly Property IsExplicitLayout As Boolean

Valor da propriedade

Boolean

true se a Attributes propriedade do tipo atual incluir ExplicitLayout; caso contrário, false.

Exemplos

O exemplo a seguir cria uma instância de um tipo e exibe o valor de sua IsExplicitLayout propriedade. Ele usa a MySystemTime classe, que também está no exemplo de código para StructLayoutAttribute.

using System;
using System.Reflection;
using System.ComponentModel;
using System.Runtime.InteropServices;

// Class to test for the ExplicitLayout property.
[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;
}

public class Program
{
    public static void Main(string[] args)
    {
        // Create an instance of the type using the GetType method.
        Type  t = typeof(MySystemTime);
        // Get and display the IsExplicitLayout property.
        Console.WriteLine("\nIsExplicitLayout for MySystemTime is {0}.",
            t.IsExplicitLayout);
    }
}

open System.Runtime.InteropServices

// Class to test for the ExplicitLayout property.
[<StructLayout(LayoutKind.Explicit, Size=16, CharSet=CharSet.Ansi)>]
type MySystemTime =
   [<FieldOffset 0>] val public wYear: uint16
   [<FieldOffset 2>] val public wMonth: uint16
   [<FieldOffset 4>] val public wDayOfWeek: uint16
   [<FieldOffset 6>] val public wDay: uint16
   [<FieldOffset 8>] val public wHour: uint16
   [<FieldOffset 10>] val public wMinute: uint16
   [<FieldOffset 12>] val public wSecond: uint16
   [<FieldOffset 14>] val public wMilliseconds: uint16

// Create an instance of the type using the GetType method.
let t = typeof<MySystemTime>
// Get and display the IsExplicitLayout property.
printfn $"\nIsExplicitLayout for MySystemTime is {t.IsExplicitLayout}."

Imports System.Reflection
Imports System.ComponentModel
Imports System.Runtime.InteropServices

'Class to test for the ExplicitLayout property.
   <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 

Public Class Program
    Public Shared Sub Main()
        'Create an instance of type using the GetType method.
        Dim t As Type = GetType(MySystemTime)
        ' Get and display the IsExplicitLayout property.
        Console.WriteLine(vbCrLf & "IsExplicitLayout for MySystemTime is {0}.", _
            t.IsExplicitLayout)
    End Sub
End Class

Comentários

Essa propriedade é fornecida como uma conveniência. Como alternativa, você pode usar o valor de TypeAttributes.LayoutMask enumeração para selecionar os atributos de layout de tipo e, em seguida, testar se TypeAttributes.ExplicitLayout está definido. Os TypeAttributes.AutoLayoutvalores , TypeAttributes.ExplicitLayoute enumeração TypeAttributes.SequentialLayout indicam a maneira como os campos do tipo são dispostos na memória.

Para tipos dinâmicos, você pode especificar TypeAttributes.ExplicitLayout ao criar o tipo. No código, aplique o StructLayoutAttribute atributo com o LayoutKind.Explicit valor de enumeração ao tipo, para especificar que os deslocamentos em que os campos começam são especificados explicitamente.

Observação

Você não pode usar o GetCustomAttributes método para determinar se ele StructLayoutAttribute foi aplicado a um tipo.

Se a corrente Type representar um tipo genérico construído, essa propriedade se aplicará à definição de tipo genérico da qual o tipo foi construído. Por exemplo, se a atual Type representa MyGenericType<int> (MyGenericType(Of Integer) no Visual Basic), o valor dessa propriedade é determinado por MyGenericType<T>.

Se a corrente Type representar um parâmetro de tipo na definição de um tipo genérico ou método genérico, essa propriedade sempre retornará false.

Confira também

• TypeAttributes
• StructLayoutAttribute
• IsAutoLayout
• IsLayoutSequential
• Metadados e componentes de Self-Describing