Expression.NewArrayInit Méthode

Définition

Crée un NewArrayExpression qui représente la création d'un tableau unidimensionnel et son initialisation à partir d'une liste d'éléments.Creates a NewArrayExpression that represents creating a one-dimensional array and initializing it from a list of elements.

Surcharges

NewArrayInit(Type, IEnumerable<Expression>)

Crée un NewArrayExpression qui représente la création d'un tableau unidimensionnel et son initialisation à partir d'une liste d'éléments.Creates a NewArrayExpression that represents creating a one-dimensional array and initializing it from a list of elements.

NewArrayInit(Type, Expression[])

Crée un NewArrayExpression qui représente la création d'un tableau unidimensionnel et son initialisation à partir d'une liste d'éléments.Creates a NewArrayExpression that represents creating a one-dimensional array and initializing it from a list of elements.

NewArrayInit(Type, IEnumerable<Expression>)

Crée un NewArrayExpression qui représente la création d'un tableau unidimensionnel et son initialisation à partir d'une liste d'éléments.Creates a NewArrayExpression that represents creating a one-dimensional array and initializing it from a list of elements.

public:
 static System::Linq::Expressions::NewArrayExpression ^ NewArrayInit(Type ^ type, System::Collections::Generic::IEnumerable<System::Linq::Expressions::Expression ^> ^ initializers);
public static System.Linq.Expressions.NewArrayExpression NewArrayInit (Type type, System.Collections.Generic.IEnumerable<System.Linq.Expressions.Expression> initializers);
static member NewArrayInit : Type * seq<System.Linq.Expressions.Expression> -> System.Linq.Expressions.NewArrayExpression

Paramètres

type
Type

Type qui représente le type d'élément du tableau.A Type that represents the element type of the array.

initializers
IEnumerable<Expression>

IEnumerable<T> qui contient des objets Expression à utiliser pour remplir la collection Expressions.An IEnumerable<T> that contains Expression objects to use to populate the Expressions collection.

Retours

NewArrayExpression dont la propriété NodeType est égale à NewArrayInit et dont la propriété Expressions a la valeur spécifiée.A NewArrayExpression that has the NodeType property equal to NewArrayInit and the Expressions property set to the specified value.

Exceptions

type ou initializers est null.type or initializers is null.

ou-or- Un élément de initializers est null.An element of initializers is null.

La propriété Type d'un élément du paramètre initializers représente un type qui ne peut pas être assigné au type représenté par type.The Type property of an element of initializers represents a type that is not assignable to the type that type represents.

Exemples

L’exemple suivant montre comment utiliser la NewArrayInit méthode pour créer une arborescence d’expressions qui représente la création d’un tableau de chaînes unidimensionnel qui est initialisé à l’aide d’une liste d’expressions de chaîne.The following example demonstrates how to use the NewArrayInit method to create an expression tree that represents creating a one-dimensional string array that is initialized with a list of string expressions.

List<System.Linq.Expressions.Expression> trees =
    new List<System.Linq.Expressions.Expression>()
        { System.Linq.Expressions.Expression.Constant("oak"),
          System.Linq.Expressions.Expression.Constant("fir"),
          System.Linq.Expressions.Expression.Constant("spruce"),
          System.Linq.Expressions.Expression.Constant("alder") };

// Create an expression tree that represents creating and  
// initializing a one-dimensional array of type string.
System.Linq.Expressions.NewArrayExpression newArrayExpression =
    System.Linq.Expressions.Expression.NewArrayInit(typeof(string), trees);

// Output the string representation of the Expression.
Console.WriteLine(newArrayExpression.ToString());

// This code produces the following output:
//
// new [] {"oak", "fir", "spruce", "alder"}
Dim trees As New System.Collections.Generic.List(Of System.Linq.Expressions.Expression) _
        (New System.Linq.Expressions.Expression() _
         {System.Linq.Expressions.Expression.Constant("oak"), _
          System.Linq.Expressions.Expression.Constant("fir"), _
          System.Linq.Expressions.Expression.Constant("spruce"), _
          System.Linq.Expressions.Expression.Constant("alder")})

' Create an expression tree that represents creating and  
' initializing a one-dimensional array of type string.
Dim newArrayExpression As System.Linq.Expressions.NewArrayExpression = _
    System.Linq.Expressions.Expression.NewArrayInit(Type.GetType("System.String"), trees)

' Output the string representation of the Expression.
Console.WriteLine(newArrayExpression.ToString())

' This code produces the following output:
'
' new [] {"oak", "fir", "spruce", "alder"}

Remarques

La Type propriété de chaque élément de initializers doit représenter un type qui peut être assigné au type représenté par type, éventuellement après avoir été placé entre guillemets.The Type property of each element of initializers must represent a type that is assignable to the type represented by type, possibly after it is quoted.

Notes

Un élément est mis entre guillemets type uniquement Expressionsi est.An element will be quoted only if type is Expression. Quote signifie que l’élément est encapsulé dans Quote un nœud.Quoting means the element is wrapped in a Quote node. Le nœud résultant est un UnaryExpression dont Operand la propriété est l’élément initializersde.The resulting node is a UnaryExpression whose Operand property is the element of initializers.

La Type propriété du résultant NewArrayExpression représente un type de tableau dont le rang est 1 et dont le type typed’élément est.The Type property of the resulting NewArrayExpression represents an array type whose rank is 1 and whose element type is type.

NewArrayInit(Type, Expression[])

Crée un NewArrayExpression qui représente la création d'un tableau unidimensionnel et son initialisation à partir d'une liste d'éléments.Creates a NewArrayExpression that represents creating a one-dimensional array and initializing it from a list of elements.

public:
 static System::Linq::Expressions::NewArrayExpression ^ NewArrayInit(Type ^ type, ... cli::array <System::Linq::Expressions::Expression ^> ^ initializers);
public static System.Linq.Expressions.NewArrayExpression NewArrayInit (Type type, params System.Linq.Expressions.Expression[] initializers);
static member NewArrayInit : Type * System.Linq.Expressions.Expression[] -> System.Linq.Expressions.NewArrayExpression

Paramètres

type
Type

Type qui représente le type d'élément du tableau.A Type that represents the element type of the array.

initializers
Expression[]

Tableau d'objets Expression à utiliser pour remplir la collection Expressions.An array of Expression objects to use to populate the Expressions collection.

Retours

NewArrayExpression dont la propriété NodeType est égale à NewArrayInit et dont la propriété Expressions a la valeur spécifiée.A NewArrayExpression that has the NodeType property equal to NewArrayInit and the Expressions property set to the specified value.

Exceptions

type ou initializers a la valeur null.type or initializers is null.

- ou --or- Un élément de initializers est null.An element of initializers is null.

La propriété Type d'un élément de initializers représente un type qui ne peut pas être assigné au type type.The Type property of an element of initializers represents a type that is not assignable to the type type.

Exemples

L’exemple suivant montre comment utiliser la NewArrayInit méthode pour créer une arborescence d’expressions qui représente la création d’un tableau de chaînes unidimensionnel qui est initialisé à l’aide d’une liste d’expressions de chaîne.The following example demonstrates how to use the NewArrayInit method to create an expression tree that represents creating a one-dimensional string array that is initialized with a list of string expressions.

List<System.Linq.Expressions.Expression> trees =
    new List<System.Linq.Expressions.Expression>()
        { System.Linq.Expressions.Expression.Constant("oak"),
          System.Linq.Expressions.Expression.Constant("fir"),
          System.Linq.Expressions.Expression.Constant("spruce"),
          System.Linq.Expressions.Expression.Constant("alder") };

// Create an expression tree that represents creating and  
// initializing a one-dimensional array of type string.
System.Linq.Expressions.NewArrayExpression newArrayExpression =
    System.Linq.Expressions.Expression.NewArrayInit(typeof(string), trees);

// Output the string representation of the Expression.
Console.WriteLine(newArrayExpression.ToString());

// This code produces the following output:
//
// new [] {"oak", "fir", "spruce", "alder"}
Dim trees As New System.Collections.Generic.List(Of System.Linq.Expressions.Expression) _
        (New System.Linq.Expressions.Expression() _
         {System.Linq.Expressions.Expression.Constant("oak"), _
          System.Linq.Expressions.Expression.Constant("fir"), _
          System.Linq.Expressions.Expression.Constant("spruce"), _
          System.Linq.Expressions.Expression.Constant("alder")})

' Create an expression tree that represents creating and  
' initializing a one-dimensional array of type string.
Dim newArrayExpression As System.Linq.Expressions.NewArrayExpression = _
    System.Linq.Expressions.Expression.NewArrayInit(Type.GetType("System.String"), trees)

' Output the string representation of the Expression.
Console.WriteLine(newArrayExpression.ToString())

' This code produces the following output:
'
' new [] {"oak", "fir", "spruce", "alder"}

Remarques

La Type propriété de chaque élément de initializers doit représenter un type qui peut être assigné au type représenté par type, éventuellement après avoir été placé entre guillemets.The Type property of each element of initializers must represent a type that is assignable to the type represented by type, possibly after it is quoted.

Notes

Un élément est mis entre guillemets type uniquement Expressionsi est.An element will be quoted only if type is Expression. Quote signifie que l’élément est encapsulé dans Quote un nœud.Quoting means the element is wrapped in a Quote node. Le nœud résultant est un UnaryExpression dont Operand la propriété est l’élément initializersde.The resulting node is a UnaryExpression whose Operand property is the element of initializers.

La Type propriété du résultant NewArrayExpression représente un type de tableau dont le rang est 1 et dont le type typed’élément est.The Type property of the resulting NewArrayExpression represents an array type whose rank is 1 and whose element type is type.

S’applique à