InvalidOperationException Klasse

Definition

Die Ausnahme, die ausgelöst wird, wenn der Aufruf einer Methode aufgrund des aktuellen Zustands des Objekts ungültig ist.

public ref class InvalidOperationException : Exception
public ref class InvalidOperationException : SystemException
public class InvalidOperationException : Exception
public class InvalidOperationException : SystemException
[System.Serializable]
public class InvalidOperationException : SystemException
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class InvalidOperationException : SystemException
type InvalidOperationException = class
    inherit Exception
type InvalidOperationException = class
    inherit SystemException
[<System.Serializable>]
type InvalidOperationException = class
    inherit SystemException
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type InvalidOperationException = class
    inherit SystemException
Public Class InvalidOperationException
Inherits Exception
Public Class InvalidOperationException
Inherits SystemException
Vererbung
InvalidOperationException
Vererbung
InvalidOperationException
Abgeleitet
Attribute

Hinweise

InvalidOperationException wird in Fällen verwendet, in dem der Fehler beim Aufrufen einer Methode durch andere Gründe als ungültige Argumente verursacht wird. Normalerweise wird es ausgelöst, wenn der Zustand eines Objekts den Methodenaufruf nicht unterstützen kann. Beispielsweise wird eine InvalidOperationException Ausnahme durch Methoden wie:

  • IEnumerator.MoveNext wenn Objekte einer Auflistung geändert werden, nachdem der Aufzählungsator erstellt wurde. Weitere Informationen finden Sie unter Ändern einer Auflistung beim Iterieren.

  • ResourceSet.GetString wenn der Ressourcensatz geschlossen wird, bevor der Methodenaufruf ausgeführt wird.

  • XContainer.Add, wenn das zu hinzufügende Objekt oder Objekte zu einem falsch strukturierten XML-Dokument führen würde.

  • Eine Methode, die versucht, die Benutzeroberfläche aus einem Thread zu bearbeiten, der nicht der Haupt- oder UI-Thread ist.

Wichtig

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

Inhalt dieses Abschnitts:

Einige häufige Ursachen von InvalidOperationException-Ausnahmen
Aktualisieren eines UI-Threads aus einem Nicht-UI-Thread
Ändern einer Auflistung beim Iterieren
Sortieren eines Arrays oder einer Auflistung, deren Objekte nicht verglichen werden können
Umwandeln eines Nullable<T> , der null für den zugrunde liegenden Typ ist
Aufrufen einer System.Linq.Enumerable-Methode auf einer leeren Auflistung
Aufrufen von Enumerable.Single oder Enumerable.SingleOrDefault auf einer Sequenz ohne ein Element
Dynamischer Anwendungsdomänenfeldzugriff
Auslösen einer InvalidOperationException-Ausnahme
Verschiedene Informationen

Einige häufige Ursachen von InvalidOperationException-Ausnahmen

In den folgenden Abschnitten wird gezeigt, wie einige häufig verwendete Fälle InvalidOperationException in einer App ausgelöst werden. Wie Sie das Problem behandeln, hängt von der spezifischen Situation ab. Die Ausnahme führt jedoch am häufigsten 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 Hintergrundarbeiten auszuführen, die das Sammeln von Daten umfassen, die in der Benutzeroberfläche einer Anwendung angezeigt werden. Das Aktivitätsprotokoll umfasst jedoch Die meisten GUI-Frameworks (grafische Benutzeroberfläche) für .NET, z. B. Windows Forms und Windows Presentation Foundation (WPF), ermöglichen Es Ihnen, nur auf GUI-Objekte zuzugreifen, die die Benutzeroberfläche erstellt und verwaltet (haupt- oder UI-Thread). Es InvalidOperationException wird ausgelöst, wenn Sie versuchen, auf ein UI-Element aus einem anderen Thread als dem UI-Thread 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 ruft eine Schnittstelle auf, die für einen anderen Thread gepostet wurde.
Windows Forms App Cross-Thread-Operation nicht gültig: Steuerelement 'TextBox1', auf den von einem anderen Thread als dem thread zugegriffen wurde, auf den es erstellt wurde.

UI-Frameworks für .NET implementieren ein Dispatchermuster , das eine Methode enthält, um zu überprüfen, ob ein Aufruf an ein Element eines UI-Elements im UI-Thread ausgeführt wird, und andere Methoden zum Planen des Aufrufs auf dem UI-Thread:

  • Rufen Sie in WPF-Apps die Dispatcher.CheckAccess Methode auf, um festzustellen, ob eine Methode auf einem Nicht-UI-Thread ausgeführt wird. Es gibt zurück true , 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 UI-Thread zu planen.

  • Überprüfen Sie in UWP-Apps die CoreDispatcher.HasThreadAccess Eigenschaft, um festzustellen, ob eine Methode auf einem Nicht-UI-Thread ausgeführt wird. Rufen Sie die CoreDispatcher.RunAsync Methode auf, um einen Stellvertretung auszuführen, der den UI-Thread aktualisiert.

  • Verwenden Sie in Windows Forms-Apps die Control.InvokeRequired Eigenschaft, um festzustellen, ob eine Methode auf einem Nicht-UI-Thread ausgeführt wird. Rufen Sie eine der Überladungen der Control.Invoke Methode auf, um einen Stellvertretung auszuführen, der den UI-Thread aktualisiert.

Die folgenden Beispiele veranschaulichen die Ausnahme, die InvalidOperationException ausgelöst wird, wenn Sie versuchen, ein UI-Element 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 auf truefestlegen.

  • Ein Schaltflächensteuerelement mit dem Namen threadExampleBtn". Das Beispiel stellt einen Handler, einen Handler für ThreadsExampleBtn_Clickdas Ereignis der Schaltfläche Click bereit.

In jedem Fall ruft der threadExampleBtn_Click Ereignishandler die DoSomeWork Methode zweimal auf. Der erste Aufruf wird synchron ausgeführt und erfolgreich. Der zweite Aufruf, da er asynchron auf einem Threadpoolthread ausgeführt wird, versucht jedoch, die Benutzeroberfläche aus einem Nicht-UI-Thread zu aktualisieren. Dies führt zu einer InvalidOperationException Ausnahme.

WPF- und UWP-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;
}
Private Async Sub threadExampleBtn_Click(sender As Object, e As RoutedEventArgs) Handles threadExampleBtn.Click
    textBox1.Text = String.Empty

    textBox1.Text = "Simulating work on UI thread." + vbCrLf
    DoSomeWork(20)
    textBox1.Text += "Work completed..." + vbCrLf

    textBox1.Text += "Simulating work on non-UI thread." + vbCrLf
    Await Task.Factory.StartNew(Sub()
                                    DoSomeWork(1000)
                                End Sub)
    textBox1.Text += "Work completed..." + vbCrLf
End Sub

Private Async Sub DoSomeWork(milliseconds As Integer)
    ' Simulate work.
    Await Task.Delay(milliseconds)

    ' Report completion.
    Dim msg = String.Format("Some work completed in {0} ms.", milliseconds) + vbCrLf
    textBox1.Text += msg
End Sub

Die folgende Version der DoSomeWork Methode entfernt 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; });
}
Private Async Sub DoSomeWork(milliseconds As Integer)
    ' Simulate work.
    Await Task.Delay(milliseconds)

    ' Report completion.
    Dim uiAccess As Boolean = textBox1.Dispatcher.CheckAccess()
    Dim msg As String = String.Format("Some work completed in {0} ms. on {1}UI thread",
                                      milliseconds, If(uiAccess, String.Empty, "non-")) + 
                                      vbCrLf 
    If uiAccess Then
        textBox1.Text += msg
    Else
        textBox1.Dispatcher.Invoke( Sub() textBox1.Text += msg)
    End If
End Sub

Die folgende Version der DoSomeWork Methode entfernt die Ausnahme in einer UWP-App.

private async void DoSomeWork(int milliseconds)
{
    // Simulate work.
    await Task.Delay(milliseconds);

    // Report completion.
    bool uiAccess = textBox1.Dispatcher.HasThreadAccess;
    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
        await textBox1.Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () => { textBox1.Text += msg; });
}
Private Async Sub DoSomeWork(milliseconds As Integer)
    ' Simulate work.
    Await Task.Delay(milliseconds)

    ' Report completion.
    Dim uiAccess As Boolean = textBox1.Dispatcher.HasThreadAccess
    Dim msg As String = String.Format("Some work completed in {0} ms. on {1}UI thread" + vbCrLf,
                                      milliseconds, If(uiAccess, String.Empty, "non-"))
    If (uiAccess) Then
        textBox1.Text += msg
    Else
        Await textBox1.Dispatcher.RunAsync(CoreDispatcherPriority.Normal, Sub() textBox1.Text += msg)
    End If
End Sub

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 threadExampleBtn.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 entfernt 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 Auflistung beim Iterieren

Die foreach Anweisung in C#, for...in in F#oder anweisung in Visual Basic wird verwendet, um die Elemente einer Auflistung zu iterieren und ihre einzelnen Elemente zu lesen oder For Each zu ändern. Sie kann jedoch nicht verwendet werden, um Elemente aus der Auflistung hinzuzufügen oder zu entfernen. Dadurch wird eine InvalidOperationException Ausnahme mit einer Nachricht ausgelöst, die ähnlich ist, "Auflistung wurde geändert; Aufzählungsvorgang wird möglicherweise nicht ausgeführt."

Im folgenden Beispiel wird eine Auflistung von ganzzahligen Versuchen ausgeführt, die Quadrate jeder ganzzahligen Auflistung hinzuzufügen. Das Beispiel löst einen InvalidOperationException ersten Aufruf der List<T>.Add Methode aus.

using System;
using System.Collections.Generic;

public class Example
{
   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 Example
   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()

Sie können die Ausnahme auf zwei Arten entfernen, je nach Anwendungslogik:

  • Wenn Elemente während des Iterierens der Auflistung hinzugefügt werden müssen, können Sie sie mithilfe der Indizierung mithilfe der for``for..to (in F#)-Anweisung anstelle von foreach, for...inoder .For Each Im folgenden Beispiel wird die For-Anweisung verwendet, um das Quadrat der Zahlen in der Auflistung zu der Auflistung hinzuzufügen.

    using System;
    using System.Collections.Generic;
    
    public class Example
    {
       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 Example
       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 entweder mithilfe eines Zählers innerhalb der Schleife erstellen, die die Schleife entsprechend beenden wird, indem Sie abwärts, von Count - 1 bis 0 oder wie das Beispiel, die Anzahl der Elemente im Array einer Variable zuweisen und sie verwenden, um die obere Grenze der Schleife festzulegen. Andernfalls wird der Auflistung auf jeder Iteration ein Element hinzugefügt, führt eine endlose Schleife aus.

  • Wenn es nicht notwendig ist, die Auflistung beim Iterieren von Elementen hinzuzufügen, können Sie die Elemente speichern, die in einer temporären Auflistung hinzugefügt werden, die Sie hinzufügen, wenn die 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 ein einzelnes Arrayobjekt zu kombinieren.

    using System;
    using System.Collections.Generic;
    
    public class Example
    {
       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 Example
       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, z. B. die Array.Sort(Array) Methode oder die List<T>.Sort() Methode, erfordern in der Regel, dass mindestens eine der Objekte sortiert werden muss, die die IComparable IComparable<T> Schnittstelle implementieren. Wenn nicht, 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 gezeigt wird, löst der Aufruf der List<T>.Sort() Methode eine InvalidOperationException.

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 Example
{
   public static void Main()
   {
      var people = new List<Person>();

      people.Add(new Person("John", "Doe"));
      people.Add(new Person("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 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
End Class

Module Example
   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:
'    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 entfernen:

  • Wenn Sie den Typ besitzen können, den Sie sortieren möchten (das heißt, wenn Sie den Quellcode steuern), können Sie sie ändern, um die IComparable<T> IComparable Schnittstelle zu implementieren. Dies erfordert, dass Sie entweder die Methode oder die IComparable<T>.CompareTo CompareTo Methode implementieren. Das Hinzufügen einer Schnittstellenimplementierung zu einem vorhandenen Typ ist keine unterbrechungsende Änderung.

    Im folgenden Beispiel wird dieser Ansatz verwendet, um eine IComparable<T> Implementierung für die Person Klasse bereitzustellen. Sie können die allgemeine Sortiermethode oder die allgemeine Sortiermethode des Arrays weiterhin aufrufen, da die Ausgabe aus dem Beispiel zeigt, die Auflistung erfolgreich sortiert wird.

    using System;
    using System.Collections.Generic;
    
    public class Person : IComparable<Person>
    {
       public Person(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 Example
    {
       public static void Main()
       {
          var people = new List<Person>();
    
          people.Add(new Person("John", "Doe"));
          people.Add(new Person("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 Example
       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 nützlich, wenn Sie eine spezialisierte Sortierklasse entwickeln möchten, die Objekte basierend auf mehreren Kriterien sortieren kann.

    Im folgenden Beispiel wird der Ansatz verwendet, indem eine benutzerdefinierte PersonComparer Klasse entwickelt wird, die zum Sortieren Person von Auflistungen 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 Person
    {
       public Person(String fName, String lName)
       {
          FirstName = fName;
          LastName = lName;
       }
    
       public String FirstName { get; set; }
       public String LastName { get; set; }
    }
    
    public class PersonComparer : IComparer<Person>
    {
       public int Compare(Person x, Person y)
       {
          return String.Format("{0} {1}", x.LastName, x.FirstName).
                 CompareTo(String.Format("{0} {1}", y.LastName, y.FirstName));
       }
    }
    
    public class Example
    {
       public static void Main()
       {
          var people = new List<Person>();
    
          people.Add(new Person("John", "Doe"));
          people.Add(new Person("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 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
    End Class
    
    Public Class PersonComparer : Implements IComparer(Of Person)
       Public Function Compare(x As Person, y As Person) As Integer _
              Implements IComparer(Of Person).Compare
          Return String.Format("{0} {1}", x.LastName, x.FirstName).
                 CompareTo(String.Format("{0} {1}", y.LastName, y.FirstName))    
       End Function       
    End Class
    
    Module Example
       Public Sub Main()
          Dim people As New List(Of Person)()
          
          people.Add(New Person("John", "Doe"))
          people.Add(New Person("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 auszuführen. Die Stellvertretungssignatur 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 Comparison<T> Stellvertretungssignatur entspricht. Anschließend wird diese Stellvertretung 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 Example
    {
       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 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
    End Class
    
    Module Example
       Public Sub Main()
          Dim people As New List(Of Person)()
          
          people.Add(New Person("John", "Doe"))
          people.Add(New Person("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 Person, y As Person) 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 einer Nullable<T> , die null für den zugrunde liegenden Typ ist

Beim Versuch, einen Nullable<T> Wert zu casten, der dem zugrunde liegenden Typ entspricht, null wird eine InvalidOperationException Ausnahme ausgelöst und die Fehlermeldung angezeigt: "Nullable-Objekt muss einen Wert aufweisen.

Im folgenden Beispiel wird eine Ausnahme ausgelöst, wenn versucht wird, ein InvalidOperationException Array zu iterieren, das einen Nullable(Of Integer) Wert enthält.

using System;
using System.Linq;

public class Example
{
   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 Example
   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 diese 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.

Im folgenden Beispiel wird die Ausnahme vermieden InvalidOperationException .

using System;
using System.Linq;

public class Example
{
   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 Example
   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 Auflistung

Die Enumerable.Aggregate, Enumerable.Average, Enumerable.First, Enumerable.LastEnumerable.SingleEnumerable.MaxEnumerable.Minund Enumerable.SingleOrDefault Methoden führen Vorgänge in einer 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 mehrere Elemente enthält.

Hinweis

Die meisten Methoden, die eine InvalidOperationException Ausnahme auslösen, sind Überladungen. Achten Sie darauf, dass Sie das Verhalten der von Ihnen ausgewählten Überladung verstehen.

In der folgenden Tabelle sind die Ausnahmemeldungen aus den Ausnahmeobjekten aufgeführt, die InvalidOperationException 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 mehr als ein übereinstimmende 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 absichtlich eine dieser Methoden 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 ist es angemessen, die Ausnahme zu fangen oder zu drosseln.

  • Wenn ihr Fehler bei der Überprüfung auf eine leere Sequenz versehentlich aufgetreten ist, 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.Lastoder Enumerable.Single" aufgerufen haben, können Sie eine alternative Methode, z Enumerable.FirstOrDefault. B. , Enumerable.LastOrDefaultoder , ersetzen Enumerable.SingleOrDefault, die anstelle eines Elements der Sequenz einen Standardwert 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, werden 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 beseitigt werden, indem Sie die Any Methode aufrufen, um zu bestimmen, ob die Sequenz Elemente enthält, bevor Sie die Methode aufrufen, die die Sequenz verarbeitet, wie das folgende Beispiel zeigt.

using System;
using System.Linq;

public class Example
{
   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 Example
   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, die 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 Example
{
   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 Example
   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, anstatt Enumerable.First einen angegebenen oder Standardwert zurückzugeben. Wenn die Methode kein erstes Element in der Sequenz findet, gibt sie den Standardwert für diesen Datentyp zurück. 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 gültige Member hat, bevor Sie die Enumerable.First Methode aufrufen.

Im folgenden Beispiel wird die Enumerable.FirstOrDefault<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) Methode aufgerufen, um die InvalidOperationException im vorherigen Beispiel ausgelöste Ausnahme zu verhindern.

using System;
using System.Linq;

public class Example
{
   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 Example
   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 für eine Sequenz ohne ein Element

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 in der Sequenz keine Elemente 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 zu auslösen, wenn die Sequenz keine Elemente enthält. Die Enumerable.SingleOrDefault Methode löst jedoch weiterhin eine InvalidOperationException Ausnahme aus, wenn die Sequenz mehrere Elemente enthält.

In der folgenden Tabelle sind die Ausnahmemeldungen aus den Ausnahmeobjekten aufgeführt, die InvalidOperationException durch Aufrufe der Enumerable.Single und Enumerable.SingleOrDefault Methoden ausgelöst werden.

Methode Nachricht
Single Sequence enthält kein übereinstimmende Element
Single
SingleOrDefault
Sequence enthält mehr als ein übereinstimmende 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 hat.

using System;
using System.Linq;

public class Example
{
   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 Example
   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 Example
{
   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 Example
   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 angegebene Kriterien erfüllt, nur ein Element enthält. Enumerable.SingleOrDefault geht davon aus, dass eine Sequenz mit null oder einem Ergebnis, aber nicht mehr. Wenn diese Annahme ein bewusster Grund ist, und diese Bedingungen nicht erfüllt sind, ist das Redrosseln oder Abfangen der daraus resultierenden Bedingungen InvalidOperationException angemessen. Andernfalls oder wenn Sie erwarten, dass ungültige Bedingungen mit einer häufigkeit auftreten, sollten Sie eine andere Enumerable Methode wie z FirstOrDefault . B. oder Where.

Dynamischer domänenübergreifender Domänenzugriff

Die OpCodes.Ldflda MSIL-Anweisung (Microsoft Intermediate Language) löst eine InvalidOperationException Ausnahme aus, wenn das Objekt, das das Feld enthält, dessen Adresse Sie abrufen möchten, nicht in der Anwendungsdomäne enthalten ist, 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 Ihres Objekts aus irgendeinem Grund keinen bestimmten Methodenaufruf unterstützt. Das heißt, der Methodenaufruf ist in einigen Umständen oder Kontexten gültig, ist aber in anderen ungültig.

Wenn der Aufruf der Methode auf ungültige Argumente zurückzuführen ist, sollte stattdessen ArgumentException eine der abgeleiteten Klassen ArgumentNullException oder ArgumentOutOfRangeExceptionstattdessen ausgelöst werden.

Verschiedene Informationen

InvalidOperationException verwendet die HRESULT-COR_E_INVALIDOPERATION, die den Wert 0x80131509 hat.

Eine Liste der anfänglichen Eigenschaftswerte für eine Instanz von InvalidOperationException, finden Sie unter den InvalidOperationException Konstruktoren.

Konstruktoren

InvalidOperationException()

Initialisiert eine neue Instanz der InvalidOperationException-Klasse.

InvalidOperationException(SerializationInfo, StreamingContext)

Initialisiert eine neue Instanz der InvalidOperationException-Klasse mit serialisierten Daten.

InvalidOperationException(String)

Initialisiert eine neue Instanz der InvalidOperationException-Klasse mit einer angegebenen Fehlermeldung.

InvalidOperationException(String, Exception)

Initialisiert eine neue Instanz der InvalidOperationException-Klasse mit einer angegebenen Fehlermeldung und einem Verweis auf die innere Ausnahme, die diese Ausnahme ausgelöst hat.

Eigenschaften

Data

Ruft eine Auflistung von Schlüssel-Wert-Paaren ab, die zusätzliche benutzerdefinierte Informationen zur Ausnahme bereitstellen.

(Geerbt von Exception)
HelpLink

Ruft einen Link zur Hilfedatei ab, die dieser Ausnahme zugeordnet ist, oder legt einen Link fest.

(Geerbt von Exception)
HResult

Ruft HRESULT ab oder legt HRESULT fest. Dies ist ein codierter Wert, der einer bestimmten Ausnahme zugeordnet ist.

(Geerbt von Exception)
InnerException

Ruft die Exception-Instanz ab, die die aktuelle Ausnahme verursacht hat.

(Geerbt von Exception)
Message

Ruft eine Meldung ab, mit der die aktuelle Ausnahme beschrieben wird.

(Geerbt von Exception)
Source

Gibt den Namen der Anwendung oder des Objekts zurück, die bzw. das den Fehler verursacht hat, oder legt diesen fest.

(Geerbt von Exception)
StackTrace

Ruft eine Zeichenfolgendarstellung der unmittelbaren Frames in der Aufrufliste ab.

(Geerbt von Exception)
TargetSite

Ruft die Methode ab, die die aktuelle Ausnahme auslöst.

(Geerbt von Exception)

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetBaseException()

Gibt beim Überschreiben in einer abgeleiteten Klasse eine Exception zurück, die die Grundursache für eine oder mehrere nachfolgende Ausnahmen ist.

(Geerbt von Exception)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetObjectData(SerializationInfo, StreamingContext)

Legt beim Überschreiben in einer abgeleiteten Klasse die SerializationInfo mit Informationen über die Ausnahme fest.

(Geerbt von Exception)
GetType()

Ruft den Laufzeittyp der aktuellen Instanz ab.

(Geerbt von Exception)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Erstellt eine Zeichenfolgendarstellung der aktuellen Ausnahme und gibt diese zurück.

(Geerbt von Exception)

Ereignisse

SerializeObjectState
Veraltet.

Tritt auf, wenn eine Ausnahme serialisiert wird, um ein Ausnahmezustandsobjekt mit serialisierten Daten über die Ausnahme zu erstellen.

(Geerbt von Exception)

Gilt für:

Siehe auch