Enumerable.Range(Int32, Int32) Método

Definição

Namespace:

System.Linq

Assembly:

System.Linq.dll

Origem:

Range.cs

Gera uma sequência de números integrais dentro de um intervalo especificado.

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)

Parâmetros

start

Int32

O valor do primeiro inteiro na sequência.

count

Int32

O número de inteiros sequenciais a serem gerados.

Retornos

IEnumerable<Int32>

Um IEnumerable<Int32> em C# ou IEnumerable(Of Int32) no Visual Basic que contém um intervalo de números integrais sequenciais.

Exceções

ArgumentOutOfRangeException

count é menor que 0.

- ou -

start + count -1 é maior que Int32.MaxValue.

Exemplos

O exemplo de código a seguir demonstra como usar Range para gerar uma sequência de valores.

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

Comentários

Esse método é implementado usando a execução adiada. O valor retornado imediato é um objeto que armazena todas as informações necessárias para executar a ação. A consulta representada por esse método não é executada até que o objeto seja enumerado chamando seu GetEnumerator método diretamente ou usando foreach em C# ou For Each no Visual Basic.