(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

Queryable.ElementAtOrDefault<TSource>-Methode

Gibt das Element an einem angegebenen Index in einer Sequenz oder einen Standardwert zurück, wenn der Index außerhalb des gültigen Bereichs liegt.

Namespace:  System.Linq
Assembly:  System.Core (in System.Core.dll)

public static TSource ElementAtOrDefault<TSource>(
	this IQueryable<TSource> source,
	int index
)

Typparameter

TSource

Der Typ der Elemente von source.

Parameter

source
Typ: System.Linq.IQueryable<TSource>
Ein IQueryable<T>, aus dem ein Element zurückgegeben werden soll.
index
Typ: System.Int32
Der auf 0 (null) basierende Index des abzurufenden Elements.

Rückgabewert

Typ: TSource
default(TSource), wenn index außerhalb der Begrenzungen von source liegt, andernfalls das Element an der angegebenen Position in source.

Hinweis zur Verwendung

In Visual Basic und C# können Sie diese Methode als Instanzenmethode für ein beliebiges Objekt vom Typ IQueryable<TSource> aufrufen. Bei Verwendung der Syntax für Instanzenmethoden lassen Sie den ersten Parameter aus. Weitere Informationen finden Sie unter Erweiterungsmethoden (Visual Basic) und Erweiterungsmethoden (C#-Programmierhandbuch).

AusnahmeBedingung
ArgumentNullException

source ist null.

Die ElementAtOrDefault<TSource>(IQueryable<TSource>, Int32)-Methode generiert einen MethodCallExpression, der den Aufruf von ElementAtOrDefault<TSource>(IQueryable<TSource>, Int32) durch sich selbst als konstruierte generische Methode darstellt. Anschließend übergibt sie die MethodCallExpression an die Execute<TResult>(Expression)-Methode des IQueryProvider, der von der Provider-Eigenschaft des source-Parameters dargestellt wird.

Das Abfrageverhalten, das durch das Ausführen einer Ausdrucksbaumstruktur auftritt, die einen Aufruf von ElementAtOrDefault<TSource>(IQueryable<TSource>, Int32) darstellt, hängt von der Implementierung des Typs des source-Parameters ab. Es wird erwartet, dass das Element an der Position index in source zurückgegeben wird, oder dass default(TSource) zurückgegeben wird, wenn index außerhalb der Begrenzungen von source liegt.

Im folgenden Codebeispiel wird die Verwendung von ElementAtOrDefault<TSource>(IQueryable<TSource>, Int32) veranschaulicht. In diesem Beispiel wird ein Wert für index verwendet, der außerhalb der Begrenzungen der Quellsequenz liegt.


            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]'.
            */



.NET Framework

Unterstützt in: 4.5.2, 4.5.1, 4.5, 4, 3.5

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Portable Klassenbibliothek

Unterstützt in: Portable Klassenbibliothek

.NET für Windows Store-Apps

Unterstützt in: Windows 8

.NET für Windows Phone-Apps

Unterstützt in: 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 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Community-Beiträge

HINZUFÜGEN
Microsoft führt eine Onlineumfrage durch, um Ihre Meinung zur MSDN-Website zu erfahren. Wenn Sie sich zur Teilnahme entscheiden, wird Ihnen die Onlineumfrage angezeigt, sobald Sie die MSDN-Website verlassen.

Möchten Sie an der Umfrage teilnehmen?
Anzeigen:
© 2014 Microsoft