System.InvalidOperationException-Klasse
Dieser Artikel enthält ergänzende Hinweise zur Referenzdokumentation für diese API.
Die InvalidOperationException-Ausnahme wird in Fällen verwendet, in denen der Fehler beim Aufrufen einer Methode durch andere Gründe als ungültige Argumente verursacht wird. In der Regel wird sie ausgelöst, wenn der Status eines Objekts den Methodenaufruf nicht unterstützen kann. Beispielsweise kann eine InvalidOperationException-Ausnahme durch folgende Methoden ausgelöst werden:
- IEnumerator.MoveNext, wenn Objekte einer Collection geändert werden, nachdem der Enumerator erstellt wurde. Weitere Informationen finden Sie unter Ändern einer Collection beim Durchlaufen.
- ResourceSet.GetString, wenn der Ressourcensatz geschlossen wird, bevor der Methodenaufruf ausgeführt wird
- XContainer.Add, wenn die hinzuzufügenden Objekte zu einem falsch strukturierten XML-Dokument führen würden
- Eine Methode, die versucht, die Benutzeroberfläche über einen Thread zu bearbeiten, der nicht der Haupt- oder Benutzeroberflächenthread ist
Wichtig
Da die InvalidOperationException-Ausnahme unter verschiedenen Umständen ausgelöst werden kann, ist es wichtig, die Ausnahmemeldung zu lesen, die von der Message-Eigenschaft zurückgegeben wird.
InvalidOperationException verwendet den HRESULT-Datentyp COR_E_INVALIDOPERATION
mit dem Wert 0x80131509.
Eine Liste der anfänglichen Eigenschaftswerte für eine Instanz von InvalidOperationException, finden Sie unter den InvalidOperationException Konstruktoren.
Häufige Ursachen für InvalidOperationException-Ausnahmen
In den folgenden Abschnitten werden Fälle behandelt, in denen häufige eine InvalidOperationException-Ausnahme in einer App ausgelöst wird. Wie Sie Probleme behandeln, hängt von der jeweiligen Situation ab. Am häufigsten resultiert die Ausnahme jedoch aus einem Entwicklerfehler, und die InvalidOperationException-Ausnahme kann erwartet und vermieden werden.
Aktualisieren eines Benutzeroberflächenthreads oder anderen Threads
Häufig werden Arbeitsthreads verwendet, um einige Hintergrundtasks auszuführen, zum Beispiel das Sammeln von Daten, die auf der Benutzeroberfläche einer Anwendung angezeigt werden. Es ist aber Die meisten .NET-GUI-Anwendungsframeworks, wie z. B. Windows Forms und Windows Presentation Foundation (WPF) ermöglichen Ihnen den Zugriff auf GUI-Objekte (Graphical User Interface, grafische Benutzeroberfläche) nur über den Thread, der die Benutzeroberfläche erstellt und verwaltet (Haupt- oder Benutzeroberflächenthread). Eine InvalidOperationException-Ausnahme wird ausgelöst, wenn Sie versuchen, auf ein Element der Benutzeroberfläche über einen anderen Thread als den Benutzeroberflächenthread zuzugreifen. Der Text der Ausnahmemeldung wird in der folgenden Tabelle angezeigt.
Anwendungstyp | `Message` |
---|---|
WPF-App | Der aufrufende Thread kann nicht auf dieses Objekt zugreifen, weil sich das Objekt im Besitz eines anderen Threads befindet. |
UWP-App | Die Anwendung hat eine Schnittstelle aufgerufen, die für einen anderen Thread gemarshallt wurde. |
Windows Forms-App | Ungültiger threadübergreifender Vorgang: Der Zugriff auf das Steuerelement „TextBox1“ erfolgte von einem anderen Thread als dem Thread, für den es erstellt wurde. |
Benutzeroberflächenframeworks für .NET implementieren ein Dispatcher-Muster, das eine Methode umfasst, mit der überprüft werden kann, ob ein Aufruf eines Members eines Benutzeroberflächenelements im Benutzeroberflächenthread ausgeführt wird, und andere Methoden, um den Aufruf des Benutzeroberflächenthreads zu planen:
- Rufen Sie in WPF-Apps die Dispatcher.CheckAccess-Methode auf, um zu ermitteln, ob eine Methode in einem anderen Thread als einem Benutzeroberflächenthread ausgeführt wird. Sie gibt
true
zurück, wenn die Methode im Benutzeroberflächenthread ausgeführt wird, und andernfallsfalse
. Rufen Sie eine der Überladungen der Dispatcher.Invoke-Methode auf, um den Aufruf im Benutzeroberflächenthread zu planen. - Überprüfen Sie in UWP-Apps die CoreDispatcher.HasThreadAccess-Eigenschaft, um zu ermitteln, ob eine Methode in einem anderen Thread als einem Benutzeroberflächenthread ausgeführt wird. Rufen Sie die CoreDispatcher.RunAsync-Methode auf, um einen Delegaten auszuführen, der den Benutzeroberflächenthread aktualisiert.
- Verwenden Sie in Windows Forms-Apps die Control.InvokeRequired-Eigenschaft, um zu ermitteln, ob eine Methode in einem anderen Thread als einem Benutzeroberflächenthread ausgeführt wird. Rufen Sie eine der Überladungen der Control.Invoke-Methode auf, um einen Delegaten auszuführen, der den Benutzeroberflächenthread aktualisiert.
Die folgenden Beispiele veranschaulichen die InvalidOperationException-Ausnahme, die ausgelöst wird, wenn Sie versuchen, ein Benutzeroberflächenelement aus einem anderen Thread als dem Thread zu aktualisieren, der es erstellt hat. Jedes Beispiel erfordert, dass Sie zwei Steuerelemente erstellen:
- Ein Textfeld-Steuerelement mit dem Namen
textBox1
. In einer Windows Forms-App sollten Sie dessen Multiline-Eigenschaft auftrue
festlegen. - Ein Schaltflächen-Steuerelement mit dem Namen
threadExampleBtn
. Das Beispiel gibt den HandlerThreadsExampleBtn_Click
für dasClick
-Ereignis der Schaltfläche an.
In jedem Fall ruft der threadExampleBtn_Click
-Ereignishandler die DoSomeWork
-Methode zweimal auf. Der erste Aufruf wird synchron ausgeführt und ist erfolgreich. Der zweite Aufruf, der asynchron in einem Threadpoolthread ausgeführt wird, versucht jedoch, die Benutzeroberfläche über einen anderen Thread als den Benutzeroberflächenthread zu aktualisieren. Das führt zu einer InvalidOperationException-Ausnahme.
WPF-Apps
private async void threadExampleBtn_Click(object sender, RoutedEventArgs e)
{
textBox1.Text = String.Empty;
textBox1.Text = "Simulating work on UI thread.\n";
DoSomeWork(20);
textBox1.Text += "Work completed...\n";
textBox1.Text += "Simulating work on non-UI thread.\n";
await Task.Run(() => DoSomeWork(1000));
textBox1.Text += "Work completed...\n";
}
private async void DoSomeWork(int milliseconds)
{
// Simulate work.
await Task.Delay(milliseconds);
// Report completion.
var msg = String.Format("Some work completed in {0} ms.\n", milliseconds);
textBox1.Text += msg;
}
Die folgende Version der DoSomeWork
-Methode beseitigt die Ausnahme in einer WPF-App.
private async void DoSomeWork(int milliseconds)
{
// Simulate work.
await Task.Delay(milliseconds);
// Report completion.
bool uiAccess = textBox1.Dispatcher.CheckAccess();
String msg = String.Format("Some work completed in {0} ms. on {1}UI thread\n",
milliseconds, uiAccess ? String.Empty : "non-");
if (uiAccess)
textBox1.Text += msg;
else
textBox1.Dispatcher.Invoke(() => { textBox1.Text += msg; });
}
Windows Forms-Anwendungen
List<String> lines = new List<String>();
private async void threadExampleBtn_Click(object sender, EventArgs e)
{
textBox1.Text = String.Empty;
lines.Clear();
lines.Add("Simulating work on UI thread.");
textBox1.Lines = lines.ToArray();
DoSomeWork(20);
lines.Add("Simulating work on non-UI thread.");
textBox1.Lines = lines.ToArray();
await Task.Run(() => DoSomeWork(1000));
lines.Add("ThreadsExampleBtn_Click completes. ");
textBox1.Lines = lines.ToArray();
}
private async void DoSomeWork(int milliseconds)
{
// simulate work
await Task.Delay(milliseconds);
// report completion
lines.Add(String.Format("Some work completed in {0} ms on UI thread.", milliseconds));
textBox1.Lines = lines.ToArray();
}
Dim lines As New List(Of String)()
Private Async Sub threadExampleBtn_Click(sender As Object, e As EventArgs) Handles Button1.Click
TextBox1.Text = String.Empty
lines.Clear()
lines.Add("Simulating work on UI thread.")
TextBox1.Lines = lines.ToArray()
DoSomeWork(20)
lines.Add("Simulating work on non-UI thread.")
TextBox1.Lines = lines.ToArray()
Await Task.Run(Sub() DoSomeWork(1000))
lines.Add("ThreadsExampleBtn_Click completes. ")
TextBox1.Lines = lines.ToArray()
End Sub
Private Async Sub DoSomeWork(milliseconds As Integer)
' Simulate work.
Await Task.Delay(milliseconds)
' Report completion.
lines.Add(String.Format("Some work completed in {0} ms on UI thread.", milliseconds))
textBox1.Lines = lines.ToArray()
End Sub
Die folgende Version der DoSomeWork
-Methode beseitigt die Ausnahme in einer Windows Forms-App.
private async void DoSomeWork(int milliseconds)
{
// simulate work
await Task.Delay(milliseconds);
// Report completion.
bool uiMarshal = textBox1.InvokeRequired;
String msg = String.Format("Some work completed in {0} ms. on {1}UI thread\n",
milliseconds, uiMarshal ? String.Empty : "non-");
lines.Add(msg);
if (uiMarshal) {
textBox1.Invoke(new Action(() => { textBox1.Lines = lines.ToArray(); }));
}
else {
textBox1.Lines = lines.ToArray();
}
}
Private Async Sub DoSomeWork(milliseconds As Integer)
' Simulate work.
Await Task.Delay(milliseconds)
' Report completion.
Dim uiMarshal As Boolean = TextBox1.InvokeRequired
Dim msg As String = String.Format("Some work completed in {0} ms. on {1}UI thread" + vbCrLf,
milliseconds, If(uiMarshal, String.Empty, "non-"))
lines.Add(msg)
If uiMarshal Then
TextBox1.Invoke(New Action(Sub() TextBox1.Lines = lines.ToArray()))
Else
TextBox1.Lines = lines.ToArray()
End If
End Sub
Ändern einer Collection beim Durchlaufen
Die foreach
-Anweisung in C#, for...in
-Anweisung in F# oder For Each
-Anweisung in Visual Basic wird verwendet, um die Member einer Collection zu durchlaufen und die einzelnen Elemente zu lesen oder zu ändern. Sie kann jedoch nicht verwendet werden, um Elemente zur Collection hinzuzufügen oder daraus zu entfernen. Dadurch wird eine InvalidOperationException-Ausnahme mit einer Meldung wie der folgenden ausgelöst: Die Sammlung wurde geändert. Der Enumerationsvorgang wird ggf. nicht ausgeführt.
Im folgenden Beispiel wird eine Collection mit Integerwerten durchlaufen und versucht, der Collection das Quadrat jedes Integerwerts hinzuzufügen. Im Beispiel wird InvalidOperationException mit dem ersten Aufruf der List<T>.Add-Methode ausgelöst.
using System;
using System.Collections.Generic;
public class IteratingEx1
{
public static void Main()
{
var numbers = new List<int>() { 1, 2, 3, 4, 5 };
foreach (var number in numbers)
{
int square = (int)Math.Pow(number, 2);
Console.WriteLine("{0}^{1}", number, square);
Console.WriteLine("Adding {0} to the collection...\n", square);
numbers.Add(square);
}
}
}
// The example displays the following output:
// 1^1
// Adding 1 to the collection...
//
//
// Unhandled Exception: System.InvalidOperationException: Collection was modified;
// enumeration operation may not execute.
// at System.ThrowHelper.ThrowInvalidOperationException(ExceptionResource resource)
// at System.Collections.Generic.List`1.Enumerator.MoveNextRare()
// at Example.Main()
open System
let numbers = ResizeArray [| 1; 2; 3; 4; 5 |]
for number in numbers do
let square = Math.Pow(number, 2) |> int
printfn $"{number}^{square}"
printfn $"Adding {square} to the collection...\n"
numbers.Add square
// The example displays the following output:
// 1^1
// Adding 1 to the collection...
//
//
// Unhandled Exception: System.InvalidOperationException: Collection was modified
// enumeration operation may not execute.
// at System.ThrowHelper.ThrowInvalidOperationException(ExceptionResource resource)
// at System.Collections.Generic.List`1.Enumerator.MoveNextRare()
// at <StartupCode$fs>.main()
Imports System.Collections.Generic
Module Example6
Public Sub Main()
Dim numbers As New List(Of Integer)({1, 2, 3, 4, 5})
For Each number In numbers
Dim square As Integer = CInt(Math.Pow(number, 2))
Console.WriteLine("{0}^{1}", number, square)
Console.WriteLine("Adding {0} to the collection..." + vbCrLf,
square)
numbers.Add(square)
Next
End Sub
End Module
' The example displays the following output:
' 1^1
' Adding 1 to the collection...
'
'
' Unhandled Exception: System.InvalidOperationException: Collection was modified;
' enumeration operation may not execute.
' at System.ThrowHelper.ThrowInvalidOperationException(ExceptionResource resource)
' at System.Collections.Generic.List`1.Enumerator.MoveNextRare()
' at Example.Main()
Je nach Anwendungslogik können Sie die Ausnahme auf eine von zwei Arten beseitigen:
Wenn Elemente während der Iteration der Collection hinzugefügt werden müssen, können Sie sie mithilfe der
for
-Anweisung (for..to
in F#) anstelle vonforeach
,for...in
oderFor Each
durchlaufen. Im folgenden Beispiel wird die for-Anweisung verwendet, um das Quadrat der Zahlen in der Collection zu dieser hinzuzufügen.using System; using System.Collections.Generic; public class IteratingEx2 { public static void Main() { var numbers = new List<int>() { 1, 2, 3, 4, 5 }; int upperBound = numbers.Count - 1; for (int ctr = 0; ctr <= upperBound; ctr++) { int square = (int)Math.Pow(numbers[ctr], 2); Console.WriteLine("{0}^{1}", numbers[ctr], square); Console.WriteLine("Adding {0} to the collection...\n", square); numbers.Add(square); } Console.WriteLine("Elements now in the collection: "); foreach (var number in numbers) Console.Write("{0} ", number); } } // The example displays the following output: // 1^1 // Adding 1 to the collection... // // 2^4 // Adding 4 to the collection... // // 3^9 // Adding 9 to the collection... // // 4^16 // Adding 16 to the collection... // // 5^25 // Adding 25 to the collection... // // Elements now in the collection: // 1 2 3 4 5 1 4 9 16 25
open System open System.Collections.Generic let numbers = ResizeArray [| 1; 2; 3; 4; 5 |] let upperBound = numbers.Count - 1 for i = 0 to upperBound do let square = Math.Pow(numbers[i], 2) |> int printfn $"{numbers[i]}^{square}" printfn $"Adding {square} to the collection...\n" numbers.Add square printfn "Elements now in the collection: " for number in numbers do printf $"{number} " // The example displays the following output: // 1^1 // Adding 1 to the collection... // // 2^4 // Adding 4 to the collection... // // 3^9 // Adding 9 to the collection... // // 4^16 // Adding 16 to the collection... // // 5^25 // Adding 25 to the collection... // // Elements now in the collection: // 1 2 3 4 5 1 4 9 16 25
Imports System.Collections.Generic Module Example7 Public Sub Main() Dim numbers As New List(Of Integer)({1, 2, 3, 4, 5}) Dim upperBound = numbers.Count - 1 For ctr As Integer = 0 To upperBound Dim square As Integer = CInt(Math.Pow(numbers(ctr), 2)) Console.WriteLine("{0}^{1}", numbers(ctr), square) Console.WriteLine("Adding {0} to the collection..." + vbCrLf, square) numbers.Add(square) Next Console.WriteLine("Elements now in the collection: ") For Each number In numbers Console.Write("{0} ", number) Next End Sub End Module ' The example displays the following output: ' 1^1 ' Adding 1 to the collection... ' ' 2^4 ' Adding 4 to the collection... ' ' 3^9 ' Adding 9 to the collection... ' ' 4^16 ' Adding 16 to the collection... ' ' 5^25 ' Adding 25 to the collection... ' ' Elements now in the collection: ' 1 2 3 4 5 1 4 9 16 25
Beachten Sie, dass Sie die Anzahl der Iterationen festlegen müssen, bevor Sie die Collection durchlaufen, indem Sie entweder einen Zähler innerhalb der Schleife verwenden, der die Schleife entsprechend beendet, indem sie rückwärts durchlaufen wird, wie im Beispiel von „
Count
- 1 bis 0“, oder indem Sie die Anzahl der Elemente im Array einer Variablen zuweisen und sie zum Einrichten der oberen Grenze der Schleife verwenden. Andernfalls ergibt sich eine Endlosschleife, wenn der Collection bei jeder Iteration ein Element hinzugefügt wird.Wenn beim Durchlaufen der Collection keine Elemente hinzugefügt werden müssen, können Sie die hinzuzufügenden Elemente in einer temporären Collection speichern, die Sie hinzufügen, wenn die Iteration der Collection abgeschlossen ist. Im folgenden Beispiel wird dieser Ansatz verwendet, um das Quadrat der Zahlen in einer Collection zu einer temporären Collection hinzuzufügen und dann die Collections in einem einzelnen Arrayobjekt zu kombinieren.
using System; using System.Collections.Generic; public class IteratingEx3 { public static void Main() { var numbers = new List<int>() { 1, 2, 3, 4, 5 }; var temp = new List<int>(); // Square each number and store it in a temporary collection. foreach (var number in numbers) { int square = (int)Math.Pow(number, 2); temp.Add(square); } // Combine the numbers into a single array. int[] combined = new int[numbers.Count + temp.Count]; Array.Copy(numbers.ToArray(), 0, combined, 0, numbers.Count); Array.Copy(temp.ToArray(), 0, combined, numbers.Count, temp.Count); // Iterate the array. foreach (var value in combined) Console.Write("{0} ", value); } } // The example displays the following output: // 1 2 3 4 5 1 4 9 16 25
open System open System.Collections.Generic let numbers = ResizeArray [| 1; 2; 3; 4; 5 |] let temp = ResizeArray() // Square each number and store it in a temporary collection. for number in numbers do let square = Math.Pow(number, 2) |> int temp.Add square // Combine the numbers into a single array. let combined = Array.zeroCreate<int> (numbers.Count + temp.Count) Array.Copy(numbers.ToArray(), 0, combined, 0, numbers.Count) Array.Copy(temp.ToArray(), 0, combined, numbers.Count, temp.Count) // Iterate the array. for value in combined do printf $"{value} " // The example displays the following output: // 1 2 3 4 5 1 4 9 16 25
Imports System.Collections.Generic Module Example8 Public Sub Main() Dim numbers As New List(Of Integer)({1, 2, 3, 4, 5}) Dim temp As New List(Of Integer)() ' Square each number and store it in a temporary collection. For Each number In numbers Dim square As Integer = CInt(Math.Pow(number, 2)) temp.Add(square) Next ' Combine the numbers into a single array. Dim combined(numbers.Count + temp.Count - 1) As Integer Array.Copy(numbers.ToArray(), 0, combined, 0, numbers.Count) Array.Copy(temp.ToArray(), 0, combined, numbers.Count, temp.Count) ' Iterate the array. For Each value In combined Console.Write("{0} ", value) Next End Sub End Module ' The example displays the following output: ' 1 2 3 4 5 1 4 9 16 25
Sortieren eines Arrays oder einer Collection, deren Objekte nicht verglichen werden können
Für universelle Sortiermethoden, z. B. die Array.Sort(Array)-Methode oder die List<T>.Sort()-Methode, ist in der Regel erforderlich, dass in mindestens einem der zu sortierenden Objekte die Schnittstelle IComparable<T> oder IComparable implementiert ist. Andernfalls kann die Collection oder das Array nicht sortiert werden, und die Methode löst eine InvalidOperationException-Ausnahme aus. Im folgenden Beispiel wird eine Person
-Klasse definiert, zwei Person
-Objekte werden in einem generischen List<T>-Objekt gespeichert, und es wird versucht, sie zu sortieren. Wie die Ausgabe aus dem Beispiel zeigt, löst der Aufruf der List<T>.Sort()-Methode InvalidOperationException aus.
using System;
using System.Collections.Generic;
public class Person1
{
public Person1(string fName, string lName)
{
FirstName = fName;
LastName = lName;
}
public string FirstName { get; set; }
public string LastName { get; set; }
}
public class ListSortEx1
{
public static void Main()
{
var people = new List<Person1>();
people.Add(new Person1("John", "Doe"));
people.Add(new Person1("Jane", "Doe"));
people.Sort();
foreach (var person in people)
Console.WriteLine("{0} {1}", person.FirstName, person.LastName);
}
}
// The example displays the following output:
// Unhandled Exception: System.InvalidOperationException: Failed to compare two elements in the array. --->
// System.ArgumentException: At least one object must implement IComparable.
// at System.Collections.Comparer.Compare(Object a, Object b)
// at System.Collections.Generic.ArraySortHelper`1.SwapIfGreater(T[] keys, IComparer`1 comparer, Int32 a, Int32 b)
// at System.Collections.Generic.ArraySortHelper`1.DepthLimitedQuickSort(T[] keys, Int32 left, Int32 right, IComparer`1 comparer, Int32 depthLimit)
// at System.Collections.Generic.ArraySortHelper`1.Sort(T[] keys, Int32 index, Int32 length, IComparer`1 comparer)
// --- End of inner exception stack trace ---
// at System.Collections.Generic.ArraySortHelper`1.Sort(T[] keys, Int32 index, Int32 length, IComparer`1 comparer)
// at System.Array.Sort[T](T[] array, Int32 index, Int32 length, IComparer`1 comparer)
// at System.Collections.Generic.List`1.Sort(Int32 index, Int32 count, IComparer`1 comparer)
// at Example.Main()
type Person(firstName: string, lastName: string) =
member val FirstName = firstName with get, set
member val LastName = lastName with get, set
let people = ResizeArray()
people.Add(Person("John", "Doe"))
people.Add(Person("Jane", "Doe"))
people.Sort()
for person in people do
printfn $"{person.FirstName} {person.LastName}"
// The example displays the following output:
// Unhandled Exception: System.InvalidOperationException: Failed to compare two elements in the array. --->
// System.ArgumentException: At least one object must implement IComparable.
// at System.Collections.Comparer.Compare(Object a, Object b)
// at System.Collections.Generic.ArraySortHelper`1.SwapIfGreater(T[] keys, IComparer`1 comparer, Int32 a, Int32 b)
// at System.Collections.Generic.ArraySortHelper`1.DepthLimitedQuickSort(T[] keys, Int32 left, Int32 right, IComparer`1 comparer, Int32 depthLimit)
// at System.Collections.Generic.ArraySortHelper`1.Sort(T[] keys, Int32 index, Int32 length, IComparer`1 comparer)
// --- End of inner exception stack trace ---
// at System.Collections.Generic.ArraySortHelper`1.Sort(T[] keys, Int32 index, Int32 length, IComparer`1 comparer)
// at System.Array.Sort[T](T[] array, Int32 index, Int32 length, IComparer`1 comparer)
// at System.Collections.Generic.List`1.Sort(Int32 index, Int32 count, IComparer`1 comparer)
// at <StartupCode$fs>.main()
Imports System.Collections.Generic
Public Class Person9
Public Sub New(fName As String, lName As String)
FirstName = fName
LastName = lName
End Sub
Public Property FirstName As String
Public Property LastName As String
End Class
Module Example9
Public Sub Main()
Dim people As New List(Of Person9)()
people.Add(New Person9("John", "Doe"))
people.Add(New Person9("Jane", "Doe"))
people.Sort()
For Each person In people
Console.WriteLine("{0} {1}", person.FirstName, person.LastName)
Next
End Sub
End Module
' The example displays the following output:
' Unhandled Exception: System.InvalidOperationException: Failed to compare two elements in the array. --->
' System.ArgumentException: At least one object must implement IComparable.
' at System.Collections.Comparer.Compare(Object a, Object b)
' at System.Collections.Generic.ArraySortHelper`1.SwapIfGreater(T[] keys, IComparer`1 comparer, Int32 a, Int32 b)
' at System.Collections.Generic.ArraySortHelper`1.DepthLimitedQuickSort(T[] keys, Int32 left, Int32 right, IComparer`1 comparer, Int32 depthLimit)
' at System.Collections.Generic.ArraySortHelper`1.Sort(T[] keys, Int32 index, Int32 length, IComparer`1 comparer)
' --- End of inner exception stack trace ---
' at System.Collections.Generic.ArraySortHelper`1.Sort(T[] keys, Int32 index, Int32 length, IComparer`1 comparer)
' at System.Array.Sort[T](T[] array, Int32 index, Int32 length, IComparer`1 comparer)
' at System.Collections.Generic.List`1.Sort(Int32 index, Int32 count, IComparer`1 comparer)
' at Example.Main()
Sie können die Ausnahme auf eine von drei Arten beseitigen:
Wenn Sie den Typ besitzen können, den Sie sortieren möchten (d. h., wenn Sie dessen Quellcode verwalten), können Sie ihn ändern, damit er die Schnittstelle IComparable<T> oder IComparable implementiert. Dafür müssen Sie entweder die IComparable<T>.CompareTo- oder die CompareTo-Methode implementieren. Das Hinzufügen einer Schnittstellenimplementierung zu einem vorhandenen Typ ist kein Breaking Change.
Im folgenden Beispiel wird dieser Ansatz verwendet, um eine IComparable<T>-Implementierung für die
Person
-Klasse bereitzustellen. Sie können die universelle Sortiermethode der Collection oder des Arrays weiterhin aufrufen. Wie die Ausgabe aus dem Beispiel zeigt, wird die Collection erfolgreich sortiert.using System; using System.Collections.Generic; public class Person2 : IComparable<Person> { public Person2(String fName, String lName) { FirstName = fName; LastName = lName; } public String FirstName { get; set; } public String LastName { get; set; } public int CompareTo(Person other) { return String.Format("{0} {1}", LastName, FirstName). CompareTo(String.Format("{0} {1}", other.LastName, other.FirstName)); } } public class ListSortEx2 { public static void Main() { var people = new List<Person2>(); people.Add(new Person2("John", "Doe")); people.Add(new Person2("Jane", "Doe")); people.Sort(); foreach (var person in people) Console.WriteLine("{0} {1}", person.FirstName, person.LastName); } } // The example displays the following output: // Jane Doe // John Doe
open System type Person(firstName: string, lastName: string) = member val FirstName = firstName with get, set member val LastName = lastName with get, set interface IComparable<Person> with member this.CompareTo(other) = compare $"{this.LastName} {this.FirstName}" $"{other.LastName} {other.FirstName}" let people = ResizeArray() people.Add(new Person("John", "Doe")) people.Add(new Person("Jane", "Doe")) people.Sort() for person in people do printfn $"{person.FirstName} {person.LastName}" // The example displays the following output: // Jane Doe // John Doe
Imports System.Collections.Generic Public Class Person : Implements IComparable(Of Person) Public Sub New(fName As String, lName As String) FirstName = fName LastName = lName End Sub Public Property FirstName As String Public Property LastName As String Public Function CompareTo(other As Person) As Integer _ Implements IComparable(Of Person).CompareTo Return String.Format("{0} {1}", LastName, FirstName). CompareTo(String.Format("{0} {1}", other.LastName, other.FirstName)) End Function End Class Module Example10 Public Sub Main() Dim people As New List(Of Person)() people.Add(New Person("John", "Doe")) people.Add(New Person("Jane", "Doe")) people.Sort() For Each person In people Console.WriteLine("{0} {1}", person.FirstName, person.LastName) Next End Sub End Module ' The example displays the following output: ' Jane Doe ' John Doe
Wenn Sie den Quellcode für den Typ, den Sie sortieren möchten, nicht ändern können, können Sie eine spezielle Sortierklasse definieren, die die IComparer<T>-Schnittstelle implementiert. Sie können eine Überladung der
Sort
-Methode aufrufen, die einen IComparer<T>-Parameter enthält. Dieser Ansatz ist besonders hilfreich, wenn Sie eine spezielle Sortierklasse entwickeln möchten, die Objekte anhand mehrerer Kriterien sortieren kann.Im folgenden Beispiel wird der Ansatz verwendet, indem eine benutzerdefinierte
PersonComparer
-Klasse entwickelt wird, die zum Sortieren vonPerson
-Collections verwendet wird. Anschließend wird eine Instanz dieser Klasse an die List<T>.Sort(IComparer<T>)-Methode übergeben.using System; using System.Collections.Generic; public class Person3 { public Person3(String fName, String lName) { FirstName = fName; LastName = lName; } public String FirstName { get; set; } public String LastName { get; set; } } public class PersonComparer : IComparer<Person3> { public int Compare(Person3 x, Person3 y) { return String.Format("{0} {1}", x.LastName, x.FirstName). CompareTo(String.Format("{0} {1}", y.LastName, y.FirstName)); } } public class ListSortEx3 { public static void Main() { var people = new List<Person3>(); people.Add(new Person3("John", "Doe")); people.Add(new Person3("Jane", "Doe")); people.Sort(new PersonComparer()); foreach (var person in people) Console.WriteLine("{0} {1}", person.FirstName, person.LastName); } } // The example displays the following output: // Jane Doe // John Doe
open System open System.Collections.Generic type Person(firstName, lastName) = member val FirstName = firstName with get, set member val LastName = lastName with get, set type PersonComparer() = interface IComparer<Person> with member _.Compare(x: Person, y: Person) = $"{x.LastName} {x.FirstName}".CompareTo $"{y.LastName} {y.FirstName}" let people = ResizeArray() people.Add(Person("John", "Doe")) people.Add(Person("Jane", "Doe")) people.Sort(PersonComparer()) for person in people do printfn $"{person.FirstName} {person.LastName}" // The example displays the following output: // Jane Doe // John Doe
Imports System.Collections.Generic Public Class Person11 Public Sub New(fName As String, lName As String) FirstName = fName LastName = lName End Sub Public Property FirstName As String Public Property LastName As String End Class Public Class PersonComparer : Implements IComparer(Of Person11) Public Function Compare(x As Person11, y As Person11) As Integer _ Implements IComparer(Of Person11).Compare Return String.Format("{0} {1}", x.LastName, x.FirstName). CompareTo(String.Format("{0} {1}", y.LastName, y.FirstName)) End Function End Class Module Example11 Public Sub Main() Dim people As New List(Of Person11)() people.Add(New Person11("John", "Doe")) people.Add(New Person11("Jane", "Doe")) people.Sort(New PersonComparer()) For Each person In people Console.WriteLine("{0} {1}", person.FirstName, person.LastName) Next End Sub End Module ' The example displays the following output: ' Jane Doe ' John Doe
Wenn Sie den Quellcode für den Typ, den Sie sortieren möchten, nicht ändern können, können Sie einen Comparison<T>-Delegaten erstellen, um die Sortierung durchzuführen. Die Delegatsignatur ist:
Function Comparison(Of T)(x As T, y As T) As Integer
int Comparison<T>(T x, T y)
Im folgenden Beispiel wird dieser Ansatz verwendet, indem eine
PersonComparison
-Methode definiert wird, die der Comparison<T>-Delegatsignatur entspricht. Anschließend wird dieser Delegat an die List<T>.Sort(Comparison<T>)-Methode übergeben.using System; using System.Collections.Generic; public class Person { public Person(String fName, String lName) { FirstName = fName; LastName = lName; } public String FirstName { get; set; } public String LastName { get; set; } } public class ListSortEx4 { public static void Main() { var people = new List<Person>(); people.Add(new Person("John", "Doe")); people.Add(new Person("Jane", "Doe")); people.Sort(PersonComparison); foreach (var person in people) Console.WriteLine("{0} {1}", person.FirstName, person.LastName); } public static int PersonComparison(Person x, Person y) { return String.Format("{0} {1}", x.LastName, x.FirstName). CompareTo(String.Format("{0} {1}", y.LastName, y.FirstName)); } } // The example displays the following output: // Jane Doe // John Doe
open System open System.Collections.Generic type Person(firstName, lastName) = member val FirstName = firstName with get, set member val LastName = lastName with get, set let personComparison (x: Person) (y: Person) = $"{x.LastName} {x.FirstName}".CompareTo $"{y.LastName} {y.FirstName}" let people = ResizeArray() people.Add(Person("John", "Doe")) people.Add(Person("Jane", "Doe")) people.Sort personComparison for person in people do printfn $"{person.FirstName} {person.LastName}" // The example displays the following output: // Jane Doe // John Doe
Imports System.Collections.Generic Public Class Person12 Public Sub New(fName As String, lName As String) FirstName = fName LastName = lName End Sub Public Property FirstName As String Public Property LastName As String End Class Module Example12 Public Sub Main() Dim people As New List(Of Person12)() people.Add(New Person12("John", "Doe")) people.Add(New Person12("Jane", "Doe")) people.Sort(AddressOf PersonComparison) For Each person In people Console.WriteLine("{0} {1}", person.FirstName, person.LastName) Next End Sub Public Function PersonComparison(x As Person12, y As Person12) As Integer Return String.Format("{0} {1}", x.LastName, x.FirstName). CompareTo(String.Format("{0} {1}", y.LastName, y.FirstName)) End Function End Module ' The example displays the following output: ' Jane Doe ' John Doe
Umwandeln eines Nullable<T>-Werts mit Wert NULL in den zugrunde liegenden Typ
Beim Versuch, einen Nullable<T>-Wert, der null
ist, in den zugrunde liegenden Typ umzuwandeln, wird eine InvalidOperationException-Ausnahme ausgelöst und die Fehlermeldung Ein Nullwerte zulassendes Objekt muss einen Wert haben angezeigt.
Im folgenden Beispiel wird eine InvalidOperationException-Ausnahme ausgelöst, wenn versucht wird, ein Array zu durchlaufen, das einen Nullable(Of Integer)
-Wert enthält.
using System;
using System.Linq;
public class NullableEx1
{
public static void Main()
{
var queryResult = new int?[] { 1, 2, null, 4 };
var map = queryResult.Select(nullableInt => (int)nullableInt);
// Display list.
foreach (var num in map)
Console.Write("{0} ", num);
Console.WriteLine();
}
}
// The example displays the following output:
// 1 2
// Unhandled Exception: System.InvalidOperationException: Nullable object must have a value.
// at System.ThrowHelper.ThrowInvalidOperationException(ExceptionResource resource)
// at Example.<Main>b__0(Nullable`1 nullableInt)
// at System.Linq.Enumerable.WhereSelectArrayIterator`2.MoveNext()
// at Example.Main()
open System
open System.Linq
let queryResult = [| Nullable 1; Nullable 2; Nullable(); Nullable 4 |]
let map = queryResult.Select(fun nullableInt -> nullableInt.Value)
// Display list.
for num in map do
printf $"{num} "
printfn ""
// The example displays the following output:
// 1 2
// Unhandled Exception: System.InvalidOperationException: Nullable object must have a value.
// at System.ThrowHelper.ThrowInvalidOperationException(ExceptionResource resource)
// at Example.<Main>b__0(Nullable`1 nullableInt)
// at System.Linq.Enumerable.WhereSelectArrayIterator`2.MoveNext()
// at <StartupCode$fs>.main()
Imports System.Linq
Module Example13
Public Sub Main()
Dim queryResult = New Integer?() {1, 2, Nothing, 4}
Dim map = queryResult.Select(Function(nullableInt) CInt(nullableInt))
' Display list.
For Each num In map
Console.Write("{0} ", num)
Next
Console.WriteLine()
End Sub
End Module
' The example displays thIe following output:
' 1 2
' Unhandled Exception: System.InvalidOperationException: Nullable object must have a value.
' at System.ThrowHelper.ThrowInvalidOperationException(ExceptionResource resource)
' at Example.<Main>b__0(Nullable`1 nullableInt)
' at System.Linq.Enumerable.WhereSelectArrayIterator`2.MoveNext()
' at Example.Main()
So verhindern Sie die Ausnahme:
- Verwenden Sie die Nullable<T>.HasValue-Eigenschaft, um nur die Elemente auszuwählen, die nicht
null
sind. - Rufen Sie eine der Nullable<T>.GetValueOrDefault-Überladungen auf, um einen Standardwert für einen
null
-Wert bereitzustellen.
Im folgenden Beispiel werden beide Maßnahmen ergriffen, um die InvalidOperationException-Ausnahme zu vermeiden.
using System;
using System.Linq;
public class NullableEx2
{
public static void Main()
{
var queryResult = new int?[] { 1, 2, null, 4 };
var numbers = queryResult.Select(nullableInt => (int)nullableInt.GetValueOrDefault());
// Display list using Nullable<int>.HasValue.
foreach (var number in numbers)
Console.Write("{0} ", number);
Console.WriteLine();
numbers = queryResult.Select(nullableInt => (int) (nullableInt.HasValue ? nullableInt : -1));
// Display list using Nullable<int>.GetValueOrDefault.
foreach (var number in numbers)
Console.Write("{0} ", number);
Console.WriteLine();
}
}
// The example displays the following output:
// 1 2 0 4
// 1 2 -1 4
open System
open System.Linq
let queryResult = [| Nullable 1; Nullable 2; Nullable(); Nullable 4 |]
let numbers = queryResult.Select(fun nullableInt -> nullableInt.GetValueOrDefault())
// Display list using Nullable<int>.HasValue.
for number in numbers do
printf $"{number} "
printfn ""
let numbers2 = queryResult.Select(fun nullableInt -> if nullableInt.HasValue then nullableInt.Value else -1)
// Display list using Nullable<int>.GetValueOrDefault.
for number in numbers2 do
printf $"{number} "
printfn ""
// The example displays the following output:
// 1 2 0 4
// 1 2 -1 4
Imports System.Linq
Module Example14
Public Sub Main()
Dim queryResult = New Integer?() {1, 2, Nothing, 4}
Dim numbers = queryResult.Select(Function(nullableInt) _
CInt(nullableInt.GetValueOrDefault()))
' Display list.
For Each number In numbers
Console.Write("{0} ", number)
Next
Console.WriteLine()
' Use -1 to indicate a missing values.
numbers = queryResult.Select(Function(nullableInt) _
CInt(If(nullableInt.HasValue, nullableInt, -1)))
' Display list.
For Each number In numbers
Console.Write("{0} ", number)
Next
Console.WriteLine()
End Sub
End Module
' The example displays the following output:
' 1 2 0 4
' 1 2 -1 4
Aufrufen einer System.Linq.Enumerable-Methode für eine leere Collection
Die Methoden Enumerable.Aggregate, Enumerable.Average, Enumerable.First, Enumerable.Last, Enumerable.Max, Enumerable.Min, Enumerable.Single und Enumerable.SingleOrDefault führen Operationen für eine Sequenz durch und geben ein Einzelergebnis zurück. Einige Überladungen dieser Methoden lösen eine InvalidOperationException-Ausnahme aus, wenn die Sequenz leer ist, während andere null
zurückgeben. Die Enumerable.SingleOrDefault-Methode löst auch eine InvalidOperationException-Ausnahme aus, wenn die Sequenz mehrere Elemente enthält.
Hinweis
Die meisten Methoden, die eine InvalidOperationException-Ausnahme auslösen, sind Überladungen. Sie müssen das Verhalten der ausgewählten Überladung kennen.
In der folgenden Tabelle sind die Ausnahmemeldungen aus den InvalidOperationException-Ausnahmeobjekten aufgeführt, die von Aufrufen einiger System.Linq.Enumerable-Methoden ausgelöst werden.
Methode | `Message` |
---|---|
Aggregate Average Last Max Min |
Die Sequenz enthält keine Elemente. |
First |
Die Sequenz enthält kein übereinstimmendes Element. |
Single SingleOrDefault |
Die Sequenz enthält mehr als ein übereinstimmendes Element. |
Wie Sie die Ausnahme beseitigen oder behandeln, hängt von den Annahmen Ihrer Anwendung und der jeweiligen Methode ab, die Sie aufrufen.
Wenn Sie eine dieser Methoden absichtlich aufrufen, ohne diese auf eine leere Sequenz zu überprüfen, gehen Sie davon aus, dass die Sequenz nicht leer und eine leere Sequenz ein unerwartetes Ereignis ist. In diesem Fall sollten Sie die Ausnahme abfangen oder erneut auslösen.
Wenn die Überprüfung auf eine leere Sequenz versehentlich nicht ausgeführt wurde, können Sie eine der Überladungen der Enumerable.Any-Überladung aufrufen, um festzustellen, ob eine Sequenz Elemente enthält.
Tipp
Das Aufrufen der Enumerable.Any<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)-Methode vor dem Generieren einer Sequenz kann die Leistung verbessern, wenn die zu verarbeitenden Daten möglicherweise eine große Anzahl von Elementen enthalten oder wenn der Vorgang, der die Sequenz generiert, teuer ist.
Wenn Sie eine Methode wie Enumerable.First, Enumerable.Last oder Enumerable.Single aufgerufen haben, können Sie eine alternative Methode wie Enumerable.FirstOrDefault, Enumerable.LastOrDefault oder Enumerable.SingleOrDefault verwenden, die anstelle eines Members der Sequenz einen Standardwert zurückgibt.
Die Beispiele liefern zusätzliche Details.
Im folgenden Beispiel wird die Enumerable.Average-Methode verwendet, um den Mittelwert einer Sequenz zu berechnen, deren Werte größer als 4 sind. Da kein Werte aus dem ursprünglichen Array 4 überschreitet, sind keine Werte in der Sequenz enthalten, und die Methode löst eine InvalidOperationException-Ausnahme aus.
using System;
using System.Linq;
public class Example
{
public static void Main()
{
int[] data = { 1, 2, 3, 4 };
var average = data.Where(num => num > 4).Average();
Console.Write("The average of numbers greater than 4 is {0}",
average);
}
}
// The example displays the following output:
// Unhandled Exception: System.InvalidOperationException: Sequence contains no elements
// at System.Linq.Enumerable.Average(IEnumerable`1 source)
// at Example.Main()
open System
open System.Linq
let data = [| 1; 2; 3; 4 |]
let average =
data.Where(fun num -> num > 4).Average();
printfn $"The average of numbers greater than 4 is {average}"
// The example displays the following output:
// Unhandled Exception: System.InvalidOperationException: Sequence contains no elements
// at System.Linq.Enumerable.Average(IEnumerable`1 source)
// at <StartupCode$fs>.main()
Imports System.Linq
Module Example
Public Sub Main()
Dim data() As Integer = { 1, 2, 3, 4 }
Dim average = data.Where(Function(num) num > 4).Average()
Console.Write("The average of numbers greater than 4 is {0}",
average)
End Sub
End Module
' The example displays the following output:
' Unhandled Exception: System.InvalidOperationException: Sequence contains no elements
' at System.Linq.Enumerable.Average(IEnumerable`1 source)
' at Example.Main()
Die Ausnahme kann durch Aufrufen der Any-Methode beseitigt werden. Auf diese Weise wird bestimmt, ob die Sequenz Elemente enthält, bevor die Methode aufgerufen wird, die die Sequenz verarbeitet. Dies wird im folgenden Beispiel gezeigt.
using System;
using System.Linq;
public class EnumerableEx2
{
public static void Main()
{
int[] dbQueryResults = { 1, 2, 3, 4 };
var moreThan4 = dbQueryResults.Where(num => num > 4);
if (moreThan4.Any())
Console.WriteLine("Average value of numbers greater than 4: {0}:",
moreThan4.Average());
else
// handle empty collection
Console.WriteLine("The dataset has no values greater than 4.");
}
}
// The example displays the following output:
// The dataset has no values greater than 4.
open System
open System.Linq
let dbQueryResults = [| 1; 2; 3; 4 |]
let moreThan4 =
dbQueryResults.Where(fun num -> num > 4)
if moreThan4.Any() then
printfn $"Average value of numbers greater than 4: {moreThan4.Average()}:"
else
// handle empty collection
printfn "The dataset has no values greater than 4."
// The example displays the following output:
// The dataset has no values greater than 4.
Imports System.Linq
Module Example1
Public Sub Main()
Dim dbQueryResults() As Integer = {1, 2, 3, 4}
Dim moreThan4 = dbQueryResults.Where(Function(num) num > 4)
If moreThan4.Any() Then
Console.WriteLine("Average value of numbers greater than 4: {0}:",
moreThan4.Average())
Else
' Handle empty collection.
Console.WriteLine("The dataset has no values greater than 4.")
End If
End Sub
End Module
' The example displays the following output:
' The dataset has no values greater than 4.
Die Enumerable.First-Methode gibt das erste Element in einer Sequenz oder das erste Element in einer Sequenz zurück, das eine angegebene Bedingung erfüllt. Wenn die Sequenz leer und daher kein erstes Element vorhanden ist, löst sie eine InvalidOperationException-Ausnahme aus.
Im folgenden Beispiel löst die Enumerable.First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)-Methode eine InvalidOperationException-Ausnahme aus, da das dbQueryResults-Array kein Element enthält, das größer als 4 ist.
using System;
using System.Linq;
public class EnumerableEx3
{
public static void Main()
{
int[] dbQueryResults = { 1, 2, 3, 4 };
var firstNum = dbQueryResults.First(n => n > 4);
Console.WriteLine("The first value greater than 4 is {0}",
firstNum);
}
}
// The example displays the following output:
// Unhandled Exception: System.InvalidOperationException:
// Sequence contains no matching element
// at System.Linq.Enumerable.First[TSource](IEnumerable`1 source, Func`2 predicate)
// at Example.Main()
open System
open System.Linq
let dbQueryResults = [| 1; 2; 3; 4 |]
let firstNum = dbQueryResults.First(fun n -> n > 4)
printfn $"The first value greater than 4 is {firstNum}"
// The example displays the following output:
// Unhandled Exception: System.InvalidOperationException:
// Sequence contains no matching element
// at System.Linq.Enumerable.First[TSource](IEnumerable`1 source, Func`2 predicate)
// at <StartupCode$fs>.main()
Imports System.Linq
Module Example2
Public Sub Main()
Dim dbQueryResults() As Integer = {1, 2, 3, 4}
Dim firstNum = dbQueryResults.First(Function(n) n > 4)
Console.WriteLine("The first value greater than 4 is {0}",
firstNum)
End Sub
End Module
' The example displays the following output:
' Unhandled Exception: System.InvalidOperationException:
' Sequence contains no matching element
' at System.Linq.Enumerable.First[TSource](IEnumerable`1 source, Func`2 predicate)
' at Example.Main()
Sie können die Enumerable.FirstOrDefault-Methode anstelle von Enumerable.First aufrufen, um einen angegebenen Wert oder Standardwert zurückzugeben. Wenn die Methode kein erstes Element in der Sequenz findet, wird der Standardwert für diesen Datentyp zurückgegeben. Der Standardwert ist null
für einen Verweistyp, null für einen numerischen Datentyp und DateTime.MinValue für den DateTime-Typ.
Hinweis
Die Interpretation des von der Enumerable.FirstOrDefault-Methode zurückgegebenen Werts ist häufig kompliziert, da der Standardwert des Typs ein gültiger Wert in der Sequenz sein kann. In diesem Fall rufen Sie die Enumerable.Any-Methode auf, um zu bestimmen, ob die Sequenz über gültige Member verfügt, bevor Sie die Enumerable.First-Methode aufrufen.
Im folgenden Beispiel wird die Enumerable.FirstOrDefault<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)-Methode aufgerufen, um zu verhindern, dass die im vorherigen Beispiel ausgelöste InvalidOperationException-Ausnahme ausgelöst wird.
using System;
using System.Linq;
public class EnumerableEx4
{
public static void Main()
{
int[] dbQueryResults = { 1, 2, 3, 4 };
var firstNum = dbQueryResults.FirstOrDefault(n => n > 4);
if (firstNum == 0)
Console.WriteLine("No value is greater than 4.");
else
Console.WriteLine("The first value greater than 4 is {0}",
firstNum);
}
}
// The example displays the following output:
// No value is greater than 4.
open System
open System.Linq
let dbQueryResults = [| 1; 2; 3; 4 |]
let firstNum = dbQueryResults.FirstOrDefault(fun n -> n > 4)
if firstNum = 0 then
printfn "No value is greater than 4."
else
printfn $"The first value greater than 4 is {firstNum}"
// The example displays the following output:
// No value is greater than 4.
Imports System.Linq
Module Example3
Public Sub Main()
Dim dbQueryResults() As Integer = {1, 2, 3, 4}
Dim firstNum = dbQueryResults.FirstOrDefault(Function(n) n > 4)
If firstNum = 0 Then
Console.WriteLine("No value is greater than 4.")
Else
Console.WriteLine("The first value greater than 4 is {0}",
firstNum)
End If
End Sub
End Module
' The example displays the following output:
' No value is greater than 4.
Aufrufen von Enumerable.Single oder Enumerable.SingleOrDefault in einer Sequenz ohne Elemente
Die Enumerable.Single-Methode gibt das einzige Element einer Sequenz oder das einzige Element einer Sequenz zurück, das eine angegebene Bedingung erfüllt. Wenn keine oder mehrere Elemente in der Sequenz vorhanden sind, löst die Methode eine InvalidOperationException-Ausnahme aus.
Sie können die Enumerable.SingleOrDefault-Methode verwenden, um einen Standardwert zurückzugeben, anstatt eine Ausnahme auszulösen, wenn die Sequenz keine Elemente enthält. Die Enumerable.SingleOrDefault-Methode löst jedoch trotzdem eine InvalidOperationException-Ausnahme aus, wenn die Sequenz mehrere Elemente enthält.
In der folgenden Tabelle sind die Ausnahmemeldungen aus den InvalidOperationException-Ausnahmeobjekten aufgeführt, die von Aufrufen einiger Enumerable.Single- und Enumerable.SingleOrDefault-Methoden ausgelöst werden.
Methode | `Message` |
---|---|
Single |
Die Sequenz enthält kein übereinstimmendes Element. |
Single SingleOrDefault |
Die Sequenz enthält mehr als ein übereinstimmendes Element. |
Im folgenden Beispiel löst der Aufruf der Enumerable.Single-Methode eine InvalidOperationException-Ausnahme aus, da die Sequenz kein Element größer als 4 enthält.
using System;
using System.Linq;
public class EnumerableEx5
{
public static void Main()
{
int[] dbQueryResults = { 1, 2, 3, 4 };
var singleObject = dbQueryResults.Single(value => value > 4);
// Display results.
Console.WriteLine("{0} is the only value greater than 4", singleObject);
}
}
// The example displays the following output:
// Unhandled Exception: System.InvalidOperationException:
// Sequence contains no matching element
// at System.Linq.Enumerable.Single[TSource](IEnumerable`1 source, Func`2 predicate)
// at Example.Main()
open System
open System.Linq
let dbQueryResults = [| 1; 2; 3; 4 |]
let singleObject = dbQueryResults.Single(fun value -> value > 4)
// Display results.
printfn $"{singleObject} is the only value greater than 4"
// The example displays the following output:
// Unhandled Exception: System.InvalidOperationException:
// Sequence contains no matching element
// at System.Linq.Enumerable.Single[TSource](IEnumerable`1 source, Func`2 predicate)
// at <StartupCode$fs>.main()
Imports System.Linq
Module Example4
Public Sub Main()
Dim dbQueryResults() As Integer = {1, 2, 3, 4}
Dim singleObject = dbQueryResults.Single(Function(value) value > 4)
' Display results.
Console.WriteLine("{0} is the only value greater than 4",
singleObject)
End Sub
End Module
' The example displays the following output:
' Unhandled Exception: System.InvalidOperationException:
' Sequence contains no matching element
' at System.Linq.Enumerable.Single[TSource](IEnumerable`1 source, Func`2 predicate)
' at Example.Main()
Im folgenden Beispiel wird versucht, die ausgelöste InvalidOperationException-Ausnahme zu verhindern, wenn eine Sequenz leer ist, indem stattdessen die Enumerable.SingleOrDefault-Methode aufgerufen wird. Da diese Sequenz jedoch mehrere Elemente zurückgibt, deren Wert größer als 2 ist, löst sie auch eine InvalidOperationException-Ausnahme aus.
using System;
using System.Linq;
public class EnumerableEx6
{
public static void Main()
{
int[] dbQueryResults = { 1, 2, 3, 4 };
var singleObject = dbQueryResults.SingleOrDefault(value => value > 2);
if (singleObject != 0)
Console.WriteLine("{0} is the only value greater than 2",
singleObject);
else
// Handle an empty collection.
Console.WriteLine("No value is greater than 2");
}
}
// The example displays the following output:
// Unhandled Exception: System.InvalidOperationException:
// Sequence contains more than one matching element
// at System.Linq.Enumerable.SingleOrDefault[TSource](IEnumerable`1 source, Func`2 predicate)
// at Example.Main()
open System
open System.Linq
let dbQueryResults = [| 1; 2; 3; 4 |]
let singleObject = dbQueryResults.SingleOrDefault(fun value -> value > 2)
if singleObject <> 0 then
printfn $"{singleObject} is the only value greater than 2"
else
// Handle an empty collection.
printfn "No value is greater than 2"
// The example displays the following output:
// Unhandled Exception: System.InvalidOperationException:
// Sequence contains more than one matching element
// at System.Linq.Enumerable.SingleOrDefault[TSource](IEnumerable`1 source, Func`2 predicate)
// at <StartupCode$fs>.main()
Imports System.Linq
Module Example5
Public Sub Main()
Dim dbQueryResults() As Integer = {1, 2, 3, 4}
Dim singleObject = dbQueryResults.SingleOrDefault(Function(value) value > 2)
If singleObject <> 0 Then
Console.WriteLine("{0} is the only value greater than 2",
singleObject)
Else
' Handle an empty collection.
Console.WriteLine("No value is greater than 2")
End If
End Sub
End Module
' The example displays the following output:
' Unhandled Exception: System.InvalidOperationException:
' Sequence contains more than one matching element
' at System.Linq.Enumerable.SingleOrDefault[TSource](IEnumerable`1 source, Func`2 predicate)
' at Example.Main()
Beim Aufrufen der Enumerable.Single-Methode wird davon ausgegangen, dass entweder eine Sequenz oder die Sequenz, die den angegebenen Kriterien entspricht, nur ein Element enthält. Enumerable.SingleOrDefault geht von einer Sequenz mit null oder maximal einem Ergebnis aus. Wenn diese Annahme von Ihnen beabsichtigt ist und diese Bedingungen nicht erfüllt sind, wird das erneute Auslösen oder Abfangen der resultierenden InvalidOperationException-Ausnahme empfohlen. Andernfalls, oder wenn Sie davon ausgehen, dass ungültige Bedingungen mit einer gewissen Regelmäßigkeit auftreten, sollten Sie in Betracht ziehen, andere Enumerable-Methode zu verwenden, z. B. FirstOrDefault oder Where.
Dynamischer anwendungsdomänenübergreifender Feldzugriff
Die OpCodes.Ldflda allgemeine CIL-Anweisung (CIL) löst eine InvalidOperationException Ausnahme aus, wenn das Objekt, das das Feld enthält, dessen Adresse Sie abrufen möchten, nicht innerhalb der Anwendung liegt Standard in der der Code ausgeführt wird. Auf die Adresse eines Felds kann nur über die Anwendungsdomäne zugegriffen werden, in der es sich befindet.
Auslösen einer InvalidOperationException-Ausnahme
Sie sollten eine InvalidOperationException-Ausnahme nur auslösen, wenn der Status des Objekts einen bestimmten Methodenaufruf aus irgendeinem Grund nicht unterstützt. Das heißt, der Methodenaufruf ist unter bestimmten Umständen oder in bestimmten Kontexten gültig, ist aber in anderen ungültig.
Wenn der fehlerhafte Aufruf der Methode auf ungültige Argumente zurückzuführen ist, sollte stattdessen ArgumentException oder eine der abgeleiteten Klassen ArgumentNullException oder ArgumentOutOfRangeException ausgelöst werden.