Enumerable.Range(Int32, Int32) Método

Referência

Definição

Namespace:: System.Linq

Assembly:: System.Linq.dll

Assembly:: System.Core.dll

Assembly:: netstandard.dll

Origem:: Range.cs

Origem:: Range.cs

Origem:: Range.cs

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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.

Aplica-se a

Produto	Versões
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

Compartilhar via