Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

Enumerable.TakeWhile<TSource> (Método) (IEnumerable<TSource>, Func<TSource, Boolean>)

Devuelve los elementos de una secuencia en tanto que el valor de una condición especificada sea true.

Espacio de nombres:  System.Linq
Ensamblado:  System.Core (en System.Core.dll)

public static IEnumerable<TSource> TakeWhile<TSource>(
	this IEnumerable<TSource> source,
	Func<TSource, bool> predicate
)

Parámetros de tipo

TSource

Tipo de los elementos de source.

Parámetros

source
Tipo: System.Collections.Generic.IEnumerable<TSource>
Secuencia cuyos elementos se van a devolver.
predicate
Tipo: System.Func<TSource, Boolean>
Función para probar cada elemento de una condición.

Valor devuelto

Tipo: System.Collections.Generic.IEnumerable<TSource>
IEnumerable<T> que contiene los elementos de la secuencia de entrada que se encuentran antes del elemento que no supera la prueba.

Nota sobre el uso

En Visual Basic y C#, se puede llamar a este método como a un método de instancia en cualquier objeto de tipo IEnumerable<TSource>. Cuando emplee la sintaxis del método de instancia para llamar a este método, omita el primer parámetro. Para obtener más información, vea Métodos de extensión (Visual Basic) o Métodos de extensión (Guía de programación de C#).

ExcepciónCondición
ArgumentNullException

source o predicate es null.

Este método se implementa usando la ejecución diferida. El valor devuelto inmediato es un objeto que almacena toda la información necesaria para realizar la acción. La consulta representada por este método no se ejecuta hasta que se enumera el objeto mediante una llamada directa a su método GetEnumerator o a través de foreach en Visual C# o For Each en Visual Basic.

El método TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource, Boolean>) prueba cada elemento de source mediante predicate y devuelve el elemento si el resultado es true. La enumeración se detiene cuando la función de predicado devuelve false para un elemento o cuando source no contiene ningún elemento más.

Los métodos TakeWhile y SkipWhile son complementos funcionales. Dada una secuencia coll y una función pura p, si se concatenan los resultados de coll.TakeWhile(p) y coll.SkipWhile(p), se genera la misma secuencia que coll.

En la sintaxis de las expresiones de consulta de Visual Basic, una cláusula Take While se convierte en una invocación de TakeWhile.

En el ejemplo de código siguiente se muestra cómo se utiliza TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource, Boolean>) para devolver los elementos desde el comienzo de una secuencia siempre que se cumpla una condición.


            string[] fruits = { "apple", "banana", "mango", "orange", 
                                  "passionfruit", "grape" };

            IEnumerable<string> query =
                fruits.TakeWhile(fruit => String.Compare("orange", fruit, true) != 0);

            foreach (string fruit in query)
            {
                Console.WriteLine(fruit);
            }

            /*
             This code produces the following output:

             apple
             banana
             mango
            */



.NET Framework

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Biblioteca de clases portable

Compatible con: Biblioteca de clases portable

.NET para aplicaciones de la Tienda Windows

Compatible con: Windows 8

.NET para aplicaciones de Windows Phone

Compatible con: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft