Enumerable.Single Metode

Definisi

Ruang nama:

System.Linq

Rakitan:

System.Linq.dll

Mengembalikan satu elemen tertentu dari urutan.

Overload

Single<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)	Mengembalikan satu-satunya elemen dari urutan yang memenuhi kondisi tertentu, dan melemparkan pengecualian jika ada lebih dari satu elemen tersebut.
Single<TSource>(IEnumerable<TSource>)	Mengembalikan satu-satunya elemen dari urutan, dan melemparkan pengecualian jika tidak ada tepat satu elemen dalam urutan.

Single<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)

Sumber:

Single.cs

Mengembalikan satu-satunya elemen dari urutan yang memenuhi kondisi tertentu, dan melemparkan pengecualian jika ada lebih dari satu elemen tersebut.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static TSource Single(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, bool> ^ predicate);

public static TSource Single<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,bool> predicate);

static member Single : seq<'Source> * Func<'Source, bool> -> 'Source

<Extension()>
Public Function Single(Of TSource) (source As IEnumerable(Of TSource), predicate As Func(Of TSource, Boolean)) As TSource

Jenis parameter

TSource

Jenis elemen source.

Parameter

source

IEnumerable<TSource>

IEnumerable<T> Untuk mengembalikan satu elemen dari.

predicate

Func<TSource,Boolean>

Fungsi untuk menguji elemen untuk kondisi.

Mengembalikan

TSource

Elemen tunggal dari urutan input yang memenuhi kondisi.

Pengecualian

ArgumentNullException

source atau predicate adalah null.

InvalidOperationException

Tidak ada elemen yang memenuhi kondisi di predicate.

-atau-

Lebih dari satu elemen memenuhi kondisi di predicate.

-atau-

Urutan sumber kosong.

Contoh

Contoh kode berikut menunjukkan cara menggunakan Single<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) untuk memilih satu-satunya elemen array yang memenuhi kondisi.

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

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

Console.WriteLine(fruit1);

/*
 This code produces the following output:

 passionfruit
*/

' Create an array of strings.
Dim fruits() As String =
{"apple", "banana", "mango", "orange", "passionfruit", "grape"}

' Get the single item in the array whose length is greater than 10.
Dim result As String =
fruits.Single(Function(fruit) fruit.Length > 10)

' Display the result.
Console.WriteLine($"First query: {result}")

Contoh kode berikut menunjukkan bahwa Single<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) melemparkan pengecualian ketika urutan tidak berisi tepat satu elemen yang memenuhi kondisi.

string fruit2 = null;

try
{
    fruit2 = fruits.Single(fruit => fruit.Length > 15);
}
catch (System.InvalidOperationException)
{
    Console.WriteLine(@"The collection does not contain exactly
                    one element whose length is greater than 15.");
}

Console.WriteLine(fruit2);

// This code produces the following output:
//
// The collection does not contain exactly
// one element whose length is greater than 15.

result = String.Empty

' Try to get the single item in the array whose length is > 15.
Try
    result = fruits.Single(Function(fruit) _
                           fruit.Length > 15)
Catch ex As System.InvalidOperationException
    result = "There is not EXACTLY ONE element whose length is > 15."
End Try

' Display the result.
Console.WriteLine($"Second query: {result}")

' This code produces the following output:
'
' First query: passionfruit
' Second query: There is not EXACTLY ONE element whose length is > 15.

Keterangan

Metode Single<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) ini memberikan pengecualian jika urutan input tidak berisi elemen yang cocok. Untuk mengembalikan null ketika tidak ada elemen yang cocok yang ditemukan, gunakan SingleOrDefault.

Single<TSource>(IEnumerable<TSource>)

Sumber:

Single.cs

Mengembalikan satu-satunya elemen dari urutan, dan melemparkan pengecualian jika tidak ada tepat satu elemen dalam urutan.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static TSource Single(System::Collections::Generic::IEnumerable<TSource> ^ source);

public static TSource Single<TSource> (this System.Collections.Generic.IEnumerable<TSource> source);

static member Single : seq<'Source> -> 'Source

<Extension()>
Public Function Single(Of TSource) (source As IEnumerable(Of TSource)) As TSource

Jenis parameter

TSource

Jenis elemen source.

Parameter

source

IEnumerable<TSource>

IEnumerable<T> untuk mengembalikan elemen tunggal.

Mengembalikan

TSource

Elemen tunggal dari urutan input.

Pengecualian

ArgumentNullException

sourceadalah null.

InvalidOperationException

Urutan input berisi lebih dari satu elemen.

-atau-

Urutan input kosong.

Contoh

Contoh kode berikut menunjukkan cara menggunakan Single<TSource>(IEnumerable<TSource>) untuk memilih satu-satunya elemen array.

string[] fruits1 = { "orange" };

string fruit1 = fruits1.Single();

Console.WriteLine(fruit1);

/*
 This code produces the following output:

 orange
*/

' Create an array that contains one item.
Dim fruits1() As String = {"orange"}

' Get the single item in the array.
Dim result As String = fruits1.Single()

' Display the result.
Console.WriteLine($"First query: {result}")

Contoh kode berikut menunjukkan bahwa Single<TSource>(IEnumerable<TSource>) melemparkan pengecualian ketika urutannya tidak berisi tepat satu elemen.

string[] fruits2 = { "orange", "apple" };
string fruit2 = null;

try
{
    fruit2 = fruits2.Single();
}
catch (System.InvalidOperationException)
{
    Console.WriteLine("The collection does not contain exactly one element.");
}

Console.WriteLine(fruit2);

/*
 This code produces the following output:

 The collection does not contain exactly one element.
*/

' Create an array that contains two items.
Dim fruits2() As String = {"orange", "apple"}

result = String.Empty

' Try to get the 'single' item in the array.
Try
    result = fruits2.Single()
Catch ex As System.InvalidOperationException
    result = "The collection does not contain exactly one element."
End Try

' Display the result.
Console.WriteLine($"Second query: {result}")

' This code produces the following output:
'
' First query: orange
' Second query: The collection does not contain exactly one element.

Keterangan

Metode Single<TSource>(IEnumerable<TSource>) ini memberikan pengecualian jika urutan input kosong. Untuk mengembalikan null ketika urutan input kosong, gunakan SingleOrDefault.