Type.IsExplicitLayout Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém um valor que indica se os campos do tipo atual são apresentados 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
true
se a Attributes Propriedade do tipo atual incluir ExplicitLayout ; caso contrário, false
.
Implementações
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);
}
}
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 TypeAttributes.LayoutMask valor de enumeração para selecionar os atributos de layout de tipo e, em seguida, testar se o TypeAttributes.ExplicitLayout está definido. Os TypeAttributes.AutoLayout TypeAttributes.ExplicitLayout valores de enumeração, e 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 quando 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 nos quais os campos começam são especificados explicitamente.
Observação
Você não pode usar o GetCustomAttributes método para determinar se o StructLayoutAttribute foi aplicado a um tipo.
Caso o Type atual represente um tipo genérico construído, esta propriedade aplica-se à definição de tipo genérico a partir da qual o tipo foi construído. Por exemplo, se o Type atual representar MyGenericType<int>
(MyGenericType(Of Integer)
no Visual Basic), o valor dessa propriedade será determinado por MyGenericType<T>
.
Caso o Type atual represente um parâmetro de tipo na definição de um tipo genérico ou um método genérico, esta propriedade sempre retorna false
.