Queryable.ElementAtOrDefault 메서드

정의

네임스페이스:

System.Linq

어셈블리:

System.Linq.Queryable.dll

오버로드

ElementAtOrDefault<TSource>(IQueryable<TSource>, Index)	시퀀스에서 지정된 인덱스의 요소를 반환하거나, 인덱스가 범위를 벗어나면 기본 값을 반환합니다.
ElementAtOrDefault<TSource>(IQueryable<TSource>, Int32)	시퀀스에서 지정된 인덱스의 요소를 반환하거나, 인덱스가 범위를 벗어나면 기본 값을 반환합니다.

ElementAtOrDefault<TSource>(IQueryable<TSource>, Index)

Source:

Queryable.cs

시퀀스에서 지정된 인덱스의 요소를 반환하거나, 인덱스가 범위를 벗어나면 기본 값을 반환합니다.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static TSource ElementAtOrDefault(System::Linq::IQueryable<TSource> ^ source, Index index);

public static TSource? ElementAtOrDefault<TSource> (this System.Linq.IQueryable<TSource> source, Index index);

static member ElementAtOrDefault : System.Linq.IQueryable<'Source> * Index -> 'Source

<Extension()>
Public Function ElementAtOrDefault(Of TSource) (source As IQueryable(Of TSource), index As Index) As TSource

형식 매개 변수

TSource

source 요소의 형식입니다.

매개 변수

source

IQueryable<TSource>

요소를 반환할 IQueryable<T>입니다.

index

Index

검색할 요소의 인덱스로, 시작 또는 끝에서 가져옵니다.

반환

TSource

default가 시퀀스의 source 범위를 벗어나면 index 이고, 그렇지 않으면 시퀀스에서 지정된 위치에 있는 source 요소입니다.

예외

ArgumentNullException

source은 null입니다.

ElementAtOrDefault<TSource>(IQueryable<TSource>, Int32)

Source:

Queryable.cs

시퀀스에서 지정된 인덱스의 요소를 반환하거나, 인덱스가 범위를 벗어나면 기본 값을 반환합니다.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static TSource ElementAtOrDefault(System::Linq::IQueryable<TSource> ^ source, int index);

public static TSource? ElementAtOrDefault<TSource> (this System.Linq.IQueryable<TSource> source, int index);

static member ElementAtOrDefault : System.Linq.IQueryable<'Source> * int -> 'Source

<Extension()>
Public Function ElementAtOrDefault(Of TSource) (source As IQueryable(Of TSource), index As Integer) As TSource

형식 매개 변수

TSource

source 요소의 형식입니다.

매개 변수

source

IQueryable<TSource>

요소를 반환할 IQueryable<T>입니다.

index

Int32

검색할 요소의 0부터 시작하는 인덱스입니다.

반환

TSource

default(TSource) 가 의 source범위를 벗어나면 index 이고, 그렇지 않으면 의 지정된 위치에 있는 요소입니다source.

예외

ArgumentNullException

source이(가) null인 경우

예제

다음 코드 예제에서는 ElementAtOrDefault<TSource>(IQueryable<TSource>, Int32)을 사용하는 방법을 보여 줍니다. 이 예제에서는 소스 시퀀스의 범위를 벗어난 에 대한 index 값을 사용합니다.

string[] names = { "Hartono, Tommy", "Adams, Terry",
                   "Andersen, Henriette Thaulow",
                   "Hedlund, Magnus", "Ito, Shu" };

int index = 20;

string name = names.AsQueryable().ElementAtOrDefault(index);

Console.WriteLine(
    "The name chosen at index {0} is '{1}'.",
    index,
    String.IsNullOrEmpty(name) ? "[NONE AT THIS INDEX]" : name);

/*
    This code produces the following output:

    The name chosen at index 20 is '[NONE AT THIS INDEX]'.
*/

Dim names() As String = {"Hartono, Tommy", "Adams, Terry", _
                   "Andersen, Henriette Thaulow", _
                   "Hedlund, Magnus", "Ito, Shu"}

Dim index As Integer = 20

Dim name As String = names.AsQueryable().ElementAtOrDefault(index)

MsgBox(String.Format("The name at index {0} is '{1}'.", _
    index, IIf(String.IsNullOrEmpty(name), "[NONE AT THIS INDEX]", name)))

' This code produces the following output:
'
' The name at index 20 is '[NONE AT THIS INDEX]'.

설명

메서드는 ElementAtOrDefault<TSource>(IQueryable<TSource>, Int32)MethodCallExpression 생성된 제네릭 메서드로 자신을 호출 ElementAtOrDefault<TSource>(IQueryable<TSource>, Int32) 하는 을 생성합니다. 그런 다음 을 MethodCallExpression 매개 변수의 Execute<TResult>(Expression) 속성으로 나타내는 Provider 의 IQueryProvider 메서드에 source 전달합니다.

호출 ElementAtOrDefault<TSource>(IQueryable<TSource>, Int32) 을 나타내는 식 트리를 실행한 결과로 발생하는 쿼리 동작은 매개 변수 형식 source 의 구현에 따라 달라집니다. 예상되는 동작은 의 위치에 index 있는 source항목을 반환하거나 default(TSource) 가 의 source범위를 벗어나면 index 반환하는 것입니다.