CodeArrayCreateExpression Class
TOC
Collapse the table of content
Expand the table of content

CodeArrayCreateExpression Class

 

Represents an expression that creates an array.

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

System.Object
  System.CodeDom.CodeObject
    System.CodeDom.CodeExpression
      System.CodeDom.CodeArrayCreateExpression

[SerializableAttribute]
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]
[ComVisibleAttribute(true)]
public class CodeArrayCreateExpression : CodeExpression

NameDescription
System_CAPS_pubmethodCodeArrayCreateExpression()

Initializes a new instance of the CodeArrayCreateExpression class.

System_CAPS_pubmethodCodeArrayCreateExpression(CodeTypeReference, CodeExpression)

Initializes a new instance of the CodeArrayCreateExpression class using the specified array data type and code expression indicating the number of indexes for the array.

System_CAPS_pubmethodCodeArrayCreateExpression(CodeTypeReference, CodeExpression[])

Initializes a new instance of the CodeArrayCreateExpression class using the specified array data type and initialization expressions.

System_CAPS_pubmethodCodeArrayCreateExpression(CodeTypeReference, Int32)

Initializes a new instance of the CodeArrayCreateExpression class using the specified array data type and number of indexes for the array.

System_CAPS_pubmethodCodeArrayCreateExpression(String, CodeExpression)

Initializes a new instance of the CodeArrayCreateExpression class using the specified array data type name and code expression indicating the number of indexes for the array.

System_CAPS_pubmethodCodeArrayCreateExpression(String, CodeExpression[])

Initializes a new instance of the CodeArrayCreateExpression class using the specified array data type name and initializers.

System_CAPS_pubmethodCodeArrayCreateExpression(String, Int32)

Initializes a new instance of the CodeArrayCreateExpression class using the specified array data type name and number of indexes for the array.

System_CAPS_pubmethodCodeArrayCreateExpression(Type, CodeExpression)

Initializes a new instance of the CodeArrayCreateExpression class using the specified array data type and code expression indicating the number of indexes for the array.

System_CAPS_pubmethodCodeArrayCreateExpression(Type, CodeExpression[])

Initializes a new instance of the CodeArrayCreateExpression class using the specified array data type and initializers.

System_CAPS_pubmethodCodeArrayCreateExpression(Type, Int32)

Initializes a new instance of the CodeArrayCreateExpression class using the specified array data type and number of indexes for the array.

NameDescription
System_CAPS_pubpropertyCreateType

Gets or sets the type of array to create.

System_CAPS_pubpropertyInitializers

Gets the initializers with which to initialize the array.

System_CAPS_pubpropertySize

Gets or sets the number of indexes in the array.

System_CAPS_pubpropertySizeExpression

Gets or sets the expression that indicates the size of the array.

System_CAPS_pubpropertyUserData

Gets the user-definable data for the current object.(Inherited from CodeObject.)

NameDescription
System_CAPS_pubmethodEquals(Object)

Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_protmethodFinalize()

Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)

System_CAPS_pubmethodGetHashCode()

Serves as the default hash function. (Inherited from Object.)

System_CAPS_pubmethodGetType()

Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_protmethodMemberwiseClone()

Creates a shallow copy of the current Object.(Inherited from Object.)

System_CAPS_pubmethodToString()

Returns a string that represents the current object.(Inherited from Object.)

CodeArrayCreateExpression can be used to represent a code expression that creates an array. Expressions that create an array should specify either a number of elements, or a list of expressions to use to initialize the array.

Most arrays can be initialized immediately following declaration. The Initializers property can be set to the expression to use to initialize the array.

A CodeArrayCreateExpression only directly supports creating single-dimension arrays. If a language allows arrays of arrays, it is possible to create them by nesting a CodeArrayCreateExpression within a CodeArrayCreateExpression. Not all languages support arrays of arrays. You can check whether an ICodeGenerator for a language declares support for nested arrays by calling Supports with the ArraysOfArrays flag.

The following code uses a CodeArrayCreateExpression to create an array of integers with 10 indexes.

// Create an initialization expression for a new array of type Int32 with 10 indices
CodeArrayCreateExpression ca1 = new CodeArrayCreateExpression("System.Int32", 10);                        

// Declare an array of type Int32, using the CodeArrayCreateExpression ca1 as the initialization expression
CodeVariableDeclarationStatement cv1 = new CodeVariableDeclarationStatement("System.Int32[]", "x", ca1);

// A C# code generator produces the following source code for the preceeding example code:

// int[] x = new int[10];

.NET Framework
Available since 1.1

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top
Show:
© 2016 Microsoft