CodeArrayCreateExpression Class

Definition

Namespace:

System.CodeDom

Assembly:

System.CodeDom.dll

Source:

CodeArrayCreateExpression.cs

Represents an expression that creates an array.

public ref class CodeArrayCreateExpression : System::CodeDom::CodeExpression

public class CodeArrayCreateExpression : System.CodeDom.CodeExpression

type CodeArrayCreateExpression = class
    inherit CodeExpression

Public Class CodeArrayCreateExpression
Inherits CodeExpression

Inheritance

Object

CodeObject

CodeExpression

CodeArrayCreateExpression

Examples

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 = gcnew CodeArrayCreateExpression( "System.Int32",10 );

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

// A C# code generator produces the following source code for the preceeding example code:
// int[] x = new int[10];

// 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];

' Create an initialization expression for a new array of type Int32 with 10 indices
Dim ca1 As New CodeArrayCreateExpression("System.Int32", 10)

' Declare an array of type Int32, using the CodeArrayCreateExpression ca1 as the initialization expression
Dim cv1 As New CodeVariableDeclarationStatement("System.Int32[]", "x", ca1)

' A Visual Basic code generator produces the following source code for the preceeding example code:

' Dim x() As Integer = New Integer(9) {}

Remarks

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.

Constructors

CodeArrayCreateExpression()	Initializes a new instance of the CodeArrayCreateExpression class.
CodeArrayCreateExpression(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.
CodeArrayCreateExpression(CodeTypeReference, CodeExpression[])	Initializes a new instance of the CodeArrayCreateExpression class using the specified array data type and initialization expressions.
CodeArrayCreateExpression(CodeTypeReference, Int32)	Initializes a new instance of the CodeArrayCreateExpression class using the specified array data type and number of indexes for the array.
CodeArrayCreateExpression(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.
CodeArrayCreateExpression(String, CodeExpression[])	Initializes a new instance of the CodeArrayCreateExpression class using the specified array data type name and initializers.
CodeArrayCreateExpression(String, Int32)	Initializes a new instance of the CodeArrayCreateExpression class using the specified array data type name and number of indexes for the array.
CodeArrayCreateExpression(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.
CodeArrayCreateExpression(Type, CodeExpression[])	Initializes a new instance of the CodeArrayCreateExpression class using the specified array data type and initializers.
CodeArrayCreateExpression(Type, Int32)	Initializes a new instance of the CodeArrayCreateExpression class using the specified array data type and number of indexes for the array.

Properties

CreateType	Gets or sets the type of array to create.
Initializers	Gets the initializers with which to initialize the array.
Size	Gets or sets the number of indexes in the array.
SizeExpression	Gets or sets the expression that indicates the size of the array.
UserData	Gets the user-definable data for the current object. (Inherited from CodeObject)

Methods

Equals(Object)	Determines whether the specified object is equal to the current object. (Inherited from Object)
GetHashCode()	Serves as the default hash function. (Inherited from Object)
GetType()	Gets the Type of the current instance. (Inherited from Object)
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
ToString()	Returns a string that represents the current object. (Inherited from Object)

See also

• CodeObjectCreateExpression