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.SingleOrDefault<TSource> (Método) (IEnumerable<TSource>, Func<TSource, Boolean>)

Devuelve el único elemento de una secuencia que cumpla la condición especificada, o bien, un valor predeterminado si ese elemento no existe; este método produce una excepción si varios elementos cumplen la condición.

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

public static TSource SingleOrDefault<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>
IEnumerable<T> del que se va a devolver un único elemento.
predicate
Tipo: System.Func<TSource, Boolean>
Función que va a probar si un elemento satisface una condición.

Valor devuelto

Tipo: TSource
El único elemento de la secuencia de entrada que satisface la condición o default(TSource) si no se encuentra dicho elemento.

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.

El valor predeterminado de los tipos de referencia y los tipos que aceptan valores NULL es null.

En el ejemplo de código siguiente se muestra cómo se utiliza SingleOrDefault<TSource>(IEnumerable<TSource>, Func<TSource, Boolean>) para seleccionar el único elemento de una matriz que cumple una condición.


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

            string fruit1 = fruits.SingleOrDefault(fruit => fruit.Length > 10);

            Console.WriteLine(fruit1);

            /*
             This code produces the following output:

             passionfruit
            */



En el ejemplo de código siguiente se muestra que SingleOrDefault<TSource>(IEnumerable<TSource>, Func<TSource, Boolean>) devuelve un valor predeterminado cuando la secuencia no contiene exactamente un elemento que cumpla la condición.


            string fruit2 =
                fruits.SingleOrDefault(fruit => fruit.Length > 15);

            Console.WriteLine(
                String.IsNullOrEmpty(fruit2) ? "No such string!" : fruit2);

            /*
             This code produces the following output:

             No such string!
            */



.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