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

Définition

Espace de noms:

System.Linq

Assembly:

System.Linq.dll

Source:

Repeat.cs

Génère une séquence qui contient une valeur répétée.

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)

Paramètres de type

TResult

Type de la valeur à répéter dans la séquence de résultat.

Paramètres

element

TResult

Valeur à répéter.

count

Int32

Nombre de fois que la valeur doit être répétée dans la séquence générée.

Retours

IEnumerable<TResult>

IEnumerable<T> qui contient une valeur répétée.

Exceptions

ArgumentOutOfRangeException

count est inférieur à 0.

Exemples

L’exemple de code suivant montre comment utiliser Repeat pour générer une séquence d’une valeur répétée.

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.

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.