System.InvalidOperationException-Klasse

Dieser Artikel enthält ergänzende Hinweise zur Referenzdokumentation für diese API.

InvalidOperationException wird in Fällen verwendet, in dem der Fehler beim Aufrufen einer Methode durch andere Gründe als ungültige Argumente verursacht wird. In der Regel wird er ausgelöst, wenn der Status eines Objekts den Methodenaufruf nicht unterstützen kann. Eine InvalidOperationException-Ausnahme wird von Methoden wie zum Beispiel ausgelöst:

• IEnumerator.MoveNext wenn Objekte einer Auflistung geändert werden, nachdem der Enumerator erstellt wurde. Weitere Informationen finden Sie unter Ändern einer Sammlung beim Iterieren.
• ResourceSet.GetString wenn der Ressourcensatz geschlossen wird, bevor der Methodenaufruf ausgeführt wird.
• XContainer.Add, wenn das hinzuzufügende Objekt oder objekte zu einem falsch strukturierten XML-Dokument führen würde.
• Eine Methode, die versucht, die Benutzeroberfläche von einem Thread zu bearbeiten, der nicht der Haupt- oder UI-Thread ist.

Von Bedeutung

Da die InvalidOperationException Ausnahme unter einer Vielzahl von Umständen ausgelöst werden kann, ist es wichtig, die von der Message Eigenschaft zurückgegebene Ausnahmemeldung zu lesen.

InvalidOperationException verwendet das HRESULT COR_E_INVALIDOPERATION, das den Wert 0x80131509 hat.

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 wird gezeigt, wie einige häufige Fälle auftreten, in denen eine InvalidOperationException Ausnahme in einer App ausgelöst wird. Wie Sie das Problem behandeln, hängt von der jeweiligen Situation ab. Am häufigsten führt die Ausnahme jedoch zu einem Entwicklerfehler, und die InvalidOperationException Ausnahme kann erwartet und vermieden werden.

Aktualisieren eines UI-Threads aus einem Nicht-UI-Thread

Häufig werden Arbeitsthreads verwendet, um einige Hintergrundaufgaben auszuführen, die das Sammeln von Daten beinhalten, die auf der Benutzeroberfläche einer Anwendung angezeigt werden. Beachten Sie jedoch: Die meisten GUI-Anwendungsframeworks (grafische Benutzeroberfläche) für .NET, z. B. Windows Forms und Windows Presentation Foundation (WPF), ermöglichen ihnen den Zugriff auf GUI-Objekte nur über den Thread, der die Benutzeroberfläche erstellt und verwaltet (haupt- oder UI-Thread). Ein InvalidOperationException Fehler wird ausgelöst, wenn Sie versuchen, über einen anderen Thread als den UI-Thread auf ein UI-Element zuzugreifen. Der Text der Ausnahmemeldung wird in der folgenden Tabelle angezeigt.

Anwendungstyp	Nachricht
WPF-App	Der aufrufende Thread kann nicht auf dieses Objekt zugreifen, da ein anderer Thread es besitzt.
UWP-App	Die Anwendung hat eine Schnittstelle aufgerufen, die für einen anderen Thread verarbeitet wurde.
Windows Forms-App	Threadübergreifender Vorgang ist ungültig: Steuerelement 'TextBox1', auf das von einem anderen Thread als dem Thread zugegriffen wurde, auf dem sie erstellt wurde.

UI-Frameworks für .NET implementieren ein Dispatchermuster, das eine Methode enthält, um zu überprüfen, ob ein Aufruf eines Mitglieds eines UI-Elements im UI-Thread ausgeführt wird, sowie weitere Methoden, um den Aufruf im UI-Thread zu planen.

• Rufen Sie in WPF-Apps die Dispatcher.CheckAccess Methode auf, um zu ermitteln, ob eine Methode in einem Nicht-UI-Thread ausgeführt wird. Es gibt true zurück, wenn die Methode im UI-Thread ausgeführt wird, und false andernfalls. 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 Nicht-UI-Thread ausgeführt wird. Rufen Sie die CoreDispatcher.RunAsync Methode auf, um einen Delegaten auszuführen, der den UI-Thread aktualisiert.
• Verwenden Sie in Windows Forms-Apps die Control.InvokeRequired Eigenschaft, um zu ermitteln, ob eine Methode in einem Nicht-UI-Thread 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 UI-Element aus einem anderen Thread als dem Thread zu aktualisieren, der ihn 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 auf truefestlegen.
• Ein Schaltflächensteuerelement mit dem Namen threadExampleBtn. Das Beispiel gibt den Handler ThreadsExampleBtn_Click für das Click-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, weil er asynchron auf einem Thread im Threadpool ausgeführt wird, versucht jedoch, die Benutzeroberfläche von einem Nicht-UI-Thread aus zu aktualisieren. Dies führt zu einer InvalidOperationException Ausnahme.

WPF-Anwendungen

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 Sammlung während des Iterierens.

Die foreach-Anweisung in C#, die for...in-Anweisung in F# oder die For Each-Anweisung in Visual Basic wird verwendet, um die Mitglieder einer Auflistung zu durchlaufen und deren einzelne Elemente zu lesen oder zu ändern. Es kann jedoch nicht verwendet werden, um Elemente aus der Auflistung hinzuzufügen oder daraus zu entfernen. Durch diese Aktion wird eine InvalidOperationException Exception mit einer Meldung ausgelöst, die ähnlich lautet wie: "Sammlung wurde geändert; Enumerationsvorgang kann nicht ausgeführt werden."

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($"{number}^{square}");
            Console.WriteLine($"Adding {square} to the collection...");
            Console.WriteLine();
            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 von foreach, for...in oder For 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($"{numbers[ctr]}^{square}");
              Console.WriteLine($"Adding {square} to the collection...");
              Console.WriteLine();
              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 Auflistung durchlaufen, entweder indem Sie einen Zähler innerhalb der Schleife verwenden, der die Schleife entsprechend beendet, oder indem Sie rückwärts von Count - 1 bis 0 durchlaufen, oder auch, wie im Beispiel, indem Sie die Anzahl der Elemente im Array einer Variablen zuweisen und diese Variable zur Festlegung der oberen Begrenzung der Schleife verwenden. Andernfalls ergibt sich, wenn der Auflistung bei jeder Iteration ein Element hinzugefügt wird, eine Endlosschleife.

• Wenn es nicht notwendig ist, beim Durchlaufen der Auflistung Elemente hinzuzufügen, können Sie die Elemente, die in einer temporären Auflistung gespeichert werden sollen, speichern und diese hinzufügen, nachdem das Durchlaufen der Auflistung abgeschlossen ist. Im folgenden Beispiel wird dieser Ansatz verwendet, um das Quadrat von Zahlen in einer Auflistung zu einer temporären Auflistung hinzuzufügen und dann die Auflistungen 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 Auflistung, deren Objekte nicht verglichen werden können

Allgemeine Sortiermethoden, wie die Array.Sort(Array) Methode oder die List<T>.Sort() Methode, erfordern in der Regel, dass mindestens eines der zu sortierenden Objekte die IComparable<T> oder die IComparable Schnittstelle implementieren muss. Andernfalls kann die Auflistung 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 in einem generischen List<T> Objekt gespeichert und versucht, sie zu sortieren. Wie die Ausgabe aus dem Beispiel zeigt, wirft der Aufruf der List<T>.Sort()-Methode eine InvalidOperationException.

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($"{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 drei Arten beseitigen:

• Wenn Sie den Typ besitzen können, den Sie sortieren möchten (d. h., wenn Sie die Kontrolle über den Quellcode haben), können Sie ihn ändern, um die IComparable<T>- oder die IComparable-Schnittstelle zu implementieren. Dazu müssen Sie entweder die IComparable<T>.CompareTo Methode 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 allgemeine Sortiermethode der Auflistung oder des Arrays weiterhin aufrufen, und wie die Ausgabe aus dem Beispiel zeigt, wird die Auflistung 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($"{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 Person von Sammlungen 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($"{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 eine Comparison<T> Stellvertretung 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 der Ansatz verwendet, indem eine PersonComparison Methode definiert wird, die der Stellvertretungssignatur Comparison<T> 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($"{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 nullvorhanden sind.
• Rufen Sie eine der Nullable<T>.GetValueOrDefault-Überladungen auf, um einen Standardwert für einen null-Wert bereitzustellen.

Das folgende Beispiel führt beide Maßnahmen durch, 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

Rufen Sie eine System.Linq.Enumerable-Methode für eine leere Sammlung auf

Die Methoden Enumerable.Aggregate, Enumerable.Average, Enumerable.First, Enumerable.Last, Enumerable.Max, Enumerable.Min, Enumerable.Single und Enumerable.SingleOrDefault führen Vorgänge für eine Sequenz aus und geben ein einzelnes Ergebnis zurück. Einige Überladungen dieser Methoden lösen eine InvalidOperationException Ausnahme aus, wenn die Sequenz leer ist, während andere Überladungen zurückgegeben werden null. Die Enumerable.SingleOrDefault Methode löst auch eine InvalidOperationException Ausnahme aus, wenn die Sequenz mehr als ein Element enthält.

Hinweis

Die meisten Methoden, die eine InvalidOperationException Ausnahme auslösen, sind Überladungen. Sie müssen das Verhalten der ausgewählten Überladung kennen.

Die folgende Tabelle listet die Ausnahmemeldungen der InvalidOperationException Ausnahmeobjekte auf, die durch Aufrufe einiger System.Linq.Enumerable Methoden ausgelöst werden.

Methode	Nachricht
Aggregate Average Last Max Min	Sequenz enthält keine Elemente.
First	Sequence enthält kein übereinstimmende Element.
Single SingleOrDefault	Sequence enthält mehrere übereinstimmende Elemente.

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 nach einer leeren Sequenz zu suchen, gehen Sie davon aus, dass die Sequenz nicht leer ist und dass eine leere Sequenz ein unerwartetes Vorkommen ist. In diesem Fall sollten Sie die Ausnahme abfangen oder erneut auslösen.

• Wenn die Überprüfung auf eine leere Sequenz versehentlich unterblieben ist, können Sie eine der Enumerable.Any Überladungen aufrufen, um festzustellen, ob eine Sequenz Elemente enthält.

  Tipp

  Das Aufrufen der Methode vor dem Enumerable.Any<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) 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 einen Standardwert anstelle eines Elements der Sequenz zurückgibt.

Die Beispiele enthalten 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 keine Werte aus dem ursprünglichen Array 4 überschreiten, 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, um zu bestimmen, ob die Sequenz Elemente enthält, bevor die Methode aufgerufen wird, die die Sequenz verarbeitet, wie 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: {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 ist und daher kein erstes Element aufweist, 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 {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 aufrufen, um einen angegebenen oder Standardwert zurückzugeben, anstelle von Enumerable.First. 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 Bezugstyp, 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 durch die Tatsache, dass 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 InvalidOperationException Ausnahme im vorherigen Beispiel 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 {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 Elemente in der Sequenz vorhanden sind oder mehrere Elemente 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 auszuwerfen, 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 der Enumerable.Single Und Enumerable.SingleOrDefault Methoden ausgelöst werden.

Methode	Nachricht
Single	Sequence enthält kein übereinstimmende Element.
Single SingleOrDefault	Sequence enthält mehrere übereinstimmende Elemente.

Im folgenden Beispiel löst der Aufruf der Enumerable.Single Methode eine InvalidOperationException Ausnahme aus, da die Sequenz nicht über ein Element größer als 4 verfügt.

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($"{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 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 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($"{singleObject} is the only value greater than 2");
        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 einem Ergebnis aus, aber nicht mehr. 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 erwarten, dass ungültige Bedingungen mit einer bestimmten Häufigkeit auftreten, sollten Sie die Verwendung einer anderen Enumerable Methode in Betracht ziehen, z FirstOrDefault . B. oder Where.

Dynamischer anwendungsübergreifender Domänenfeldzugriff

Die OpCodes.Ldflda Anweisung der Common Intermediate Language (CIL) wirft eine InvalidOperationException Ausnahme, wenn sich das Objekt, das das Feld enthält, dessen Adresse Sie abrufen möchten, nicht in der Anwendungsdomäne befindet, in der Ihr 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 aus irgendeinem Grund keinen bestimmten Methodenaufruf unterstützt. Das heißt, der Methodenaufruf ist unter bestimmten Umständen oder 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.