Enumerable.Range(Int32, Int32) Méthode

Définition

Espace de noms:

System.Linq

Assembly:

System.Linq.dll

Source:

Range.cs

Génère une séquence de nombres entiers dans une plage spécifiée.

public:
 static System::Collections::Generic::IEnumerable<int> ^ Range(int start, int count);

public static System.Collections.Generic.IEnumerable<int> Range (int start, int count);

static member Range : int * int -> seq<int>

Public Function Range (start As Integer, count As Integer) As IEnumerable(Of Integer)

Paramètres

start

Int32

Valeur du premier entier de la séquence.

count

Int32

Nombre d'entiers séquentiels à générer.

Retours

IEnumerable<Int32>

IEnumerable<Int32> en C# ou IEnumerable(Of Int32) en Visual Basic qui contient une plage de nombres intégraux séquentiels.

Exceptions

ArgumentOutOfRangeException

count est inférieur à 0.

-ou-

start + count -1 est supérieur à Int32.MaxValue.

Exemples

L’exemple de code suivant montre comment utiliser Range pour générer une séquence de valeurs.

// Generate a sequence of integers from 1 to 10
// and then select their squares.
IEnumerable<int> squares = Enumerable.Range(1, 10).Select(x => x * x);

foreach (int num in squares)
{
    Console.WriteLine(num);
}

/*
 This code produces the following output:

 1
 4
 9
 16
 25
 36
 49
 64
 81
 100
*/

' Generate a sequence of integers from 1 to 10
' and project their squares.
Dim squares As IEnumerable(Of Integer) =
Enumerable.Range(1, 10).Select(Function(x) x * x)

Dim output As New System.Text.StringBuilder
For Each num As Integer In squares
    output.AppendLine(num)
Next

' Display the output.
Console.WriteLine(output.ToString())

' This code produces the following output:
'
' 1
' 4
' 9
' 16
' 25
' 36
' 49
' 64
' 81
' 100

Remarques

Cette méthode est implémentée à l’aide d’une exécution différée. La valeur de retour immédiat est un objet qui stocke toutes les informations nécessaires à l’exécution de l’action. La requête représentée par cette méthode n’est pas exécutée tant que l’objet n’est pas énuméré soit en appelant directement sa GetEnumerator méthode, soit en utilisant foreach en C# ou For Each en Visual Basic.