Enumerable.ElementAtOrDefault(IEnumerable<TSource>, Int32) Enumerable.ElementAtOrDefault(IEnumerable<TSource>, Int32) Enumerable.ElementAtOrDefault(IEnumerable<TSource>, Int32) Enumerable.ElementAtOrDefault(IEnumerable<TSource>, Int32) Method

정의

시퀀스에서 지정된 인덱스의 요소를 반환하거나, 인덱스가 범위를 벗어나면 기본 값을 반환합니다.Returns the element at a specified index in a sequence or a default value if the index is out of range.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static TSource ElementAtOrDefault(System::Collections::Generic::IEnumerable<TSource> ^ source, int index);
public static TSource ElementAtOrDefault<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, int index);
static member ElementAtOrDefault : seq<'Source> * int -> 'Source
<Extension()>
Public Function ElementAtOrDefault(Of TSource) (source As IEnumerable(Of TSource), index As Integer) As TSource

형식 매개 변수

TSource

source 요소의 형식입니다.The type of the elements of source.

매개 변수

source
IEnumerable<TSource>

IEnumerable<T> 요소를 반환 합니다.An IEnumerable<T> to return an element from.

index
Int32 Int32 Int32 Int32

검색할 요소의 0부터 시작하는 인덱스입니다.The zero-based index of the element to retrieve.

반환

TSource TSource TSource TSource

default(TSource) 인덱스가 소스 시퀀스의 범위를 벗어난 경우 그렇지 않으면 소스 시퀀스에서 지정된 된 위치에 있는 요소입니다.default(TSource) if the index is outside the bounds of the source sequence; otherwise, the element at the specified position in the source sequence.

예외

예제

다음 코드 예제에서는 ElementAtOrDefault을 사용하는 방법을 보여 줍니다.The following code example demonstrates how to use ElementAtOrDefault. 이 예제에서는 배열의 범위 외부에 있는 인덱스를 사용 합니다.This example uses an index that is outside the bounds of the array.

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

int index = 20;

string name = names.ElementAtOrDefault(index);

Console.WriteLine(
    "The name chosen at index {0} is '{1}'.",
    index,
    String.IsNullOrEmpty(name) ? "<no name at this index>" : name);

/*
 This code produces the following output:

 The name chosen at index 20 is '<no name at this index>'.
*/
' Create an array of strings.
Dim names() As String =
{"Hartono, Tommy", "Adams, Terry", "Andersen, Henriette Thaulow", "Hedlund, Magnus", "Ito, Shu"}

Dim index As Integer = 20

' Get a string at an index that is out of range in the array.
Dim name As String = names.ElementAtOrDefault(index)

Dim text As String = If(String.IsNullOrEmpty(name), "[THERE IS NO NAME AT THIS INDEX]", name)

' Display the output.
MsgBox("The name chosen at index " & index & " is " & text)

' This code produces the following output:
'
' The name chosen at index 20 is [THERE IS NO NAME AT THIS INDEX]

설명

경우 유형의 source 구현 IList<T>, 구현에는 지정된 된 인덱스에 있는 요소를 가져오는 데 사용 됩니다.If the type of source implements IList<T>, that implementation is used to obtain the element at the specified index. 그렇지 않은 경우이 메서드는 지정된 된 요소를 가져옵니다.Otherwise, this method obtains the specified element.

참조 및 null 허용 형식에 대 한 기본값은 null합니다.The default value for reference and nullable types is null.

적용 대상