Expand Minimize

Type::IsLayoutSequential Property

Gets a value indicating whether the fields of the current type are laid out sequentially, in the order that they were defined or emitted to the metadata.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)

public:
virtual property bool IsLayoutSequential {
	bool get () sealed;
}

Property Value

Type: System::Boolean
true if the Attributes property of the current type includes TypeAttributes::SequentialLayout; otherwise, false.

Implements

_Type::IsLayoutSequential

This property is provided as a convenience. Alternatively, you can use the TypeAttributes::LayoutMask enumeration value to select the type layout attributes, and then test whether TypeAttributes::SequentialLayout is set. The TypeAttributes::AutoLayout, TypeAttributes::ExplicitLayout, and TypeAttributes::SequentialLayout enumeration values indicate the way the fields of the type are laid out in memory.

For dynamic types, you can specify TypeAttributes::SequentialLayout when you create the type. In code, apply the StructLayoutAttribute attribute with the LayoutKind::Sequential enumeration value to the type, to specify that layout is sequential.

NoteNote

You cannot use the GetCustomAttributes method to determine whether the StructLayoutAttribute has been applied to a type.

For more information, see section 9.1.2 of the specification for the Common Language Infrastructure (CLI) documentation, "Partition II: Metadata Definition and Semantics". The documentation is available online; see ECMA C# and Common Language Infrastructure Standards on MSDN and Standard ECMA-335 - Common Language Infrastructure (CLI) on the Ecma International Web site.

If the current Type represents a constructed generic type, this property applies to the generic type definition from which the type was constructed. For example, if the current Type represents MyGenericType<int> (MyGenericType(Of Integer) in Visual Basic), the value of this property is determined by MyGenericType<T>.

If the current Type represents a type parameter in the definition of a generic type or generic method, this property always returns false.

The following example creates an instance of a class for which the LayoutKind::Sequential enumeration value in the StructLayoutAttribute class has been set, checks for the IsLayoutSequential property, and displays the result.

#using <System.dll>

using namespace System;
using namespace System::Reflection;
using namespace System::ComponentModel;
using namespace System::Runtime::InteropServices;
ref class MyTypeSequential1{};


[StructLayoutAttribute(LayoutKind::Sequential)]
ref class MyTypeSequential2{};

int main()
{
   try
   {

      // Create an instance of myTypeSeq1.
      MyTypeSequential1^ myObj1 = gcnew MyTypeSequential1;

      // Check for and display the SequentialLayout attribute.
      Console::WriteLine( "\nThe object myObj1 has IsLayoutSequential: {0}.", myObj1->GetType()->IsLayoutSequential );

      // Create an instance of 'myTypeSeq2' class.
      MyTypeSequential2^ myObj2 = gcnew MyTypeSequential2;

      // Check for and display the SequentialLayout attribute.
      Console::WriteLine( "\nThe object myObj2 has IsLayoutSequential: {0}.", myObj2->GetType()->IsLayoutSequential );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "\nAn exception occurred: {0}", e->Message );
   }

}

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft