Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C#

Enumerable.Single: odniesienie praktyczne

Enumerable.Single: odniesienie praktyczne: Wymaga dokładnie jednego elementu albo dopasowania i enumeruje dostatecznie daleko, by wykryć drugi.

Wersja: .NET LINQ; verified on .NET 10.0.14

Składnia

source.Single(/* overload-specific arguments */)

Wymaga dokładnie jednego elementu albo dopasowania i enumeruje dostatecznie daleko, by wykryć drugi.

Stosuj do egzekwowania unikalności wyniku, na przykład klucza biznesowego.

Single(source) wywołuje MoveNext, aż potwierdzi koniec po jednym elemencie albo zobaczy drugi; wersja z predykatem testuje elementy aż do drugiego dopasowania lub końca. Skutki uboczne iteratora i predykatu są wykonywane, a nieskończone źródło z mniej niż dwoma dopasowaniami może nigdy nie zakończyć operacji.

Zero lub więcej niż jeden wynik zgłasza InvalidOperationException. Null source lub predicate powoduje ArgumentNullException.

Kompletny program rzeczywiście używa Enumerable.Single; oczekiwany stdout to dokładnie 2.

Przykłady

using System;
using System.Collections.Generic;
using System.Linq;

Console.WriteLine(new[] { 2, 7, 9 }.Single(value => value % 2 == 0));

Wynik

2

Kompletny program rzeczywiście używa `Enumerable.Single`; oczekiwany stdout to dokładnie `2`.

Źródła