TypeBuilder.DefineNestedType Method (String, TypeAttributes, Type, Type[])

Defines a nested type, given its name, attributes, the type that it extends, and the interfaces that it implements.

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

[ComVisibleAttribute(true)]
public TypeBuilder DefineNestedType(
	string name,
	TypeAttributes attr,
	Type parent,
	Type[] interfaces
)

Parameters

name
Type: System.String
The short name of the type. name cannot contain embedded nulls.
attr
Type: System.Reflection.TypeAttributes
The attributes of the type.
parent
Type: System.Type
The type that the nested type extends.
interfaces
Type: System.Type[]
The interfaces that the nested type implements.

Return Value

Type: System.Reflection.Emit.TypeBuilder
The defined nested type.

ExceptionCondition
ArgumentException

The nested attribute is not specified.

-or-

This type is sealed.

-or-

This type is an array.

-or-

This type is an interface, but the nested type is not an interface.

-or-

The length of name is zero or greater than 1023.

-or-

This operation would create a type with a duplicate FullName in the current assembly.

ArgumentNullException

name is null.

-or-

An element of the interfaces array is null.

This method can be used to create nested types even after the CreateType method has been called on the enclosing type.

The nested type needs to be complete before you can reflect on it using GetMembers, GetNestedType, or GetNestedTypes.

See the description of CreateType for the order in which nested types and nesting types should be completed.

A duplicate name is not necessarily created if name is identical to the name of a previously defined type or nested type. To be duplicates, the full names must be the same, including the namespace and all nesting types.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft