Enumerable.Repeat<TResult>(TResult, Int32) Método

Definição

Namespace:

System.Linq

Assembly:

System.Linq.dll

Origem:

Repeat.cs

Gera uma sequência que contém um valor repetido.

public:
generic <typename TResult>
 static System::Collections::Generic::IEnumerable<TResult> ^ Repeat(TResult element, int count);

public static System.Collections.Generic.IEnumerable<TResult> Repeat<TResult> (TResult element, int count);

static member Repeat : 'Result * int -> seq<'Result>

Public Function Repeat(Of TResult) (element As TResult, count As Integer) As IEnumerable(Of TResult)

Parâmetros de tipo

TResult

O tipo do valor a ser repetido na sequência de resultado.

Parâmetros

element

TResult

O valor a ser repetido.

count

Int32

O número de vezes para repetir o valor na sequência gerada.

Retornos

IEnumerable<TResult>

Um IEnumerable<T> que contém um valor repetido.

Exceções

ArgumentOutOfRangeException

count é menor que 0.

Exemplos

O exemplo de código a seguir demonstra como usar Repeat para gerar uma sequência de um valor repetido.

IEnumerable<string> strings =
    Enumerable.Repeat("I like programming.", 15);

foreach (String str in strings)
{
    Console.WriteLine(str);
}

/*
 This code produces the following output:

 I like programming.
 I like programming.
 I like programming.
 I like programming.
 I like programming.
 I like programming.
 I like programming.
 I like programming.
 I like programming.
 I like programming.
 I like programming.
 I like programming.
 I like programming.
 I like programming.
 I like programming.
*/

' Repeat the same string to create a sequence.
Dim sentences As IEnumerable(Of String) =
Enumerable.Repeat("I like programming.", 15)

Dim output As New System.Text.StringBuilder
For Each sentence As String In sentences
    output.AppendLine(sentence)
Next

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

' This code produces the following output:
'
' I like programming.
' I like programming.
' I like programming.
' I like programming.
' I like programming.
' I like programming.
' I like programming.
' I like programming.
' I like programming.
' I like programming.
' I like programming.
' I like programming.
' I like programming.
' I like programming.
' I like programming.

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.