InvalidOperationException InvalidOperationException InvalidOperationException InvalidOperationException Class

Definition

Die Ausnahme, die ausgelöst wird, wenn der Aufruf einer Methode aufgrund des aktuellen Zustands des Objekts ungültig ist.The exception that is thrown when a method call is invalid for the object's current state.

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

Hinweise

InvalidOperationException ist in Fällen verwendet werden, wenn Fehler beim Aufrufen einer Methode, die nicht durch ungültige Argumente verursacht wird.InvalidOperationException is used in cases when the failure to invoke a method is caused by reasons other than invalid arguments. Es wird in der Regel ausgelöst, wenn der Zustand eines Objekts den Methodenaufruf nicht unterstützen kann.Typically, it is thrown when the state of an object cannot support the method call. Z. B. eine InvalidOperationException Ausnahme wird von Methoden wie z.B.:For example, an InvalidOperationException exception is thrown by methods such as:

Wichtig

Da die InvalidOperationException Ausnahme kann ausgelöst werden in einer Vielzahl von Situationen, es ist wichtig, lesen Sie die Ausnahmemeldung, die zurückgegeben werden, indem die Message Eigenschaft.Because the InvalidOperationException exception can be thrown in a wide variety of circumstances, it is important to read the exception message returned by the Message property.

In diesem AbschnittIn this section:

Einige häufige Ursachen für "InvalidOperationException"-Ausnahmen Some common causes of InvalidOperationException exceptions
Aktualisieren einen UI-Thread von einem nicht-UI-threadUpdating a UI thread from a non-UI thread
Ändern einer sammlungssatzkonfiguration beim Durchlaufen SieChanging a collection while iterating it
Sortieren von einem Array oder einer Auflistung, deren Objekte können nicht verglichen werdenSorting an array or collection whose objects cannot be compared
Ein Typ Nullable Umwandlung<T> , die null ist, um deren zugrunde liegender Typ Casting a Nullable<T> that is null to its underlying type
Eine System.Linq.Enumerable-Methode für eine leere Auflistung aufgerufenCalling a System.Linq.Enumerable method on an empty collection
Aufrufen von Enumerable.Single oder Enumerable.SingleOrDefault auf eine Sequenz ohne ein elementCalling Enumerable.Single or Enumerable.SingleOrDefault on a sequence without one element
Dynamische anwendungsdomänenübergreifender FeldzugriffDynamic cross-application domain field access
Auslösen einer InvalidOperationException-AusnahmeThrowing an InvalidOperationException exception
Verschiedene InformationenMiscellaneous information

Einige häufige Ursachen für "InvalidOperationException"-AusnahmenSome common causes of InvalidOperationException exceptions

Die folgenden Abschnitte zeigen, wie einige allgemeine in der in Fällen InvalidOperationException Ausnahme wird ausgelöst, in einer app.The following sections show how some common cases in which in InvalidOperationException exception is thrown in an app. Wie Sie das Problem behandeln, hängt von der besonderen Situation ab.How you handle the issue depends on the specific situation. In den meisten Fällen führt jedoch zu die Ausnahme vom Entwicklerfehler, und die InvalidOperationException Ausnahme erwartet und vermieden werden kann.Most commonly, however, the exception results from developer error, and the InvalidOperationException exception can be anticipated and avoided.

Aktualisieren einen UI-Thread von einem nicht-UI-threadUpdating a UI thread from a non-UI thread

Arbeitsthreads werden häufig verwendet, um einige Hintergrundarbeit auszuführen, die umfasst das Sammeln von Daten in der Benutzeroberfläche einer Anwendung angezeigt werden.Often, worker threads are used to perform some background work that involves gathering data to be displayed in an application's user interface. Jedoch.However. Die meisten GUI (grafische Benutzeroberfläche)-Anwendungsframeworks für .NET Framework, z. B. Windows Forms und Windows Presentation Foundation (WPF), können Sie Zugriff auf GUI-Objekte nur aus dem Thread, der erstellt und verwaltet die Benutzeroberfläche (der Hauptwarteschlange oder UI-Thread).most GUI (graphical user interface) application frameworks for the .NET Framework, such as Windows Forms and Windows Presentation Foundation (WPF), let you access GUI objects only from the thread that creates and manages the UI (the Main or UI thread). Ein InvalidOperationException wird ausgelöst, wenn Sie versuchen, ein Element der Benutzeroberfläche aus einem anderen Thread als dem UI-Thread zuzugreifen.An InvalidOperationException is thrown when you try to access a UI element from a thread other than the UI thread. Der Text der Ausnahmemeldung wird in der folgenden Tabelle angezeigt.The text of the exception message is shown in the following table.

AnwendungstypApplication Type MeldungMessage
WPF-appWPF app Der aufrufende Thread kann nicht auf dieses Objekt zugreifen, da ein anderer Thread es besitzt.The calling thread cannot access this object because a different thread owns it.
UWP-appUWP app Die Anwendung, die eine Schnittstelle, die gemarshallt wurde für einen anderen Thread aufgerufen wird.The application called an interface that was marshaled for a different thread.
Windows Forms-appWindows Forms app Threadübergreifender Vorgang ungültig: Steuerelement "TextBox1" von einem anderen Thread als dem Thread zugegriffen, die es auf erstellt wurde.Cross-thread operation not valid: Control 'TextBox1' accessed from a thread other than the thread it was created on.

Benutzeroberflächen-Frameworks für .NET Framework implementieren eine Dispatcher Muster, umfasst eine Methode zum Überprüfen, ob ein Aufruf an ein Mitglied eines Benutzeroberflächenelements auf dem UI-Thread ausgeführt wird, und andere Methoden, um den Aufruf im UI-Thread zu planen:UI frameworks for the .NET Framework implement a dispatcher pattern that includes a method to check whether a call to a member of a UI element is being executed on the UI thread, and other methods to schedule the call on the UI thread:

  • In WPF-Anwendungen rufen die Dispatcher.CheckAccess Methode, um zu bestimmen, ob eine Methode in einem nicht-UI-Thread ausgeführt wird.In WPF apps, call the Dispatcher.CheckAccess method to determine if a method is running on a non-UI thread. Es gibt true , wenn die Methode in der UI-Thread ausgeführt wird und false andernfalls.It returns true if the method is running on the UI thread and false otherwise. Rufen Sie eine der Überladungen der Dispatcher.Invoke Methode, um den Anruf an den UI-Thread zu planen.Call one of the overloads of the Dispatcher.Invoke method to schedule the call on the UI thread.

  • Rufen Sie in der UWP-apps, die CoreDispatcher.HasThreadAccess Methode, um zu bestimmen, ob eine Methode in einem nicht-UI-Thread ausgeführt wird.In UWP apps, call the CoreDispatcher.HasThreadAccess method to determine if a method is running on a non-UI thread. Rufen Sie die CoreDispatcher.RunAsync Methode, die ein Delegat, der den UI-Thread aktualisiert.Call the CoreDispatcher.RunAsync method to execute a delegate that updates the UI thread. Verwenden Sie den BefehlUse the

  • In Windows Forms-Anwendungen verwenden die Control.InvokeRequired Eigenschaft, um zu bestimmen, ob eine Methode in einem nicht-UI-Thread ausgeführt wird.In Windows Forms apps, use the Control.InvokeRequired property to determine if a method is running on a non-UI thread. Rufen Sie eine der Überladungen der Control.Invoke Methode, die ein Delegat, der den UI-Thread aktualisiert.Call one of the overloads of the Control.Invoke method to execute a delegate that updates the UI thread.

Die folgenden Beispiele veranschaulichen die InvalidOperationException Ausnahme wird ausgelöst, wenn Sie versuchen, ein Element von einem anderen Thread als dem Thread der Benutzeroberfläche zu aktualisieren, die sie erstellt haben.The following examples illustrate the InvalidOperationException exception that is thrown when you attempt to update a UI element from a thread other than the thread that created it. Jedes Beispiel erfordert die Erstellung von zwei Steuerelemente:Each example requires that you create two controls:

  • Ein Textfeld-Steuerelement mit dem Namen textBox1.A text box control named textBox1. Sie sollten in einer Windows Forms-app Festlegen seiner Multiline Eigenschaft true.In a Windows Forms app, you should set its Multiline property to true.

  • Ein Schaltflächen-Steuerelement, das mit dem Namen threadExampleBtn.A button control named threadExampleBtn. Im Beispiel wird einen Ereignishandler ThreadsExampleBtn_Click, für der Schaltfläche " Click Ereignis.The example provides a handler, ThreadsExampleBtn_Click, for the button's Click event.

In jedem Fall die threadExampleBtn_Click -Ereignishandler ruft die DoSomeWork -Methode zweimal.In each case, the threadExampleBtn_Click event handler calls the DoSomeWork method twice. Der erste Aufruf synchron ausgeführt und erfolgreich abgeschlossen wird.The first call runs synchronously and succeeds. Aber der zweite Aufruf, da er auf einem Thread eines Threadpools, asynchron ausgeführt wird versucht, zur Aktualisierung der Benutzeroberfläche von einem nicht-UI-Thread.But the second call, because it runs asynchronously on a thread pool thread, attempts to update the UI from a non-UI thread. Dies führt zu einem InvalidOperationException Ausnahme.This results in a InvalidOperationException exception.

WPF und UWP-appsWPF and 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 keine Ausnahme in einer WPF-Anwendung.The following version of the DoSomeWork method eliminates the exception in a 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 keine Ausnahme in einer UWP-app.The following version of the DoSomeWork method eliminates the exception in a 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-AnwendungenWindows Forms apps

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 keine Ausnahme in einer Windows Forms-app.The following version of the DoSomeWork method eliminates the exception in a 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 sammlungssatzkonfiguration beim Durchlaufen SieChanging a collection while iterating it

Die foreach -Anweisung in c# oder For Each -Anweisung in Visual Basic wird verwendet, um der Member einer Auflistung durchlaufen und zu lesen oder ändern die einzelnen Elemente.The foreach statement in C# or For Each statement in Visual Basic is used to iterate the members of a collection and to read or modify its individual elements. Jedoch kann verwendet werden, hinzufügen oder Entfernen von Elementen aus der Auflistung.However, it can't be used to add or remove items from the collection. Dies löst dies eine InvalidOperationException -Ausnahme mit einer Nachricht, die ähnlich ist, ist "Auflistung wurde geändert; Enumerationsvorgang kann nicht ausgeführt werden. "Doing this throws an InvalidOperationException exception with a message that is similar to, "Collection was modified; enumeration operation may not execute."

Im folgenden Beispiel wird eine Auflistung von ganzen Zahlen der versucht, das Quadrat der jede ganze Zahl, die der Auflistung hinzugefügt.The following example iterates a collection of integers attempts to add the square of each integer to the collection. Löst das Beispiel einer InvalidOperationException mit dem ersten Aufruf der List<T>.Add Methode.The example throws an InvalidOperationException with the first call to the List<T>.Add method.

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()
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 in einem der zwei Möglichkeiten, je nach Anwendungslogik entfernen:You can eliminate the exception in one of two ways, depending on your application logic:

  • Wenn die Auflistung beim Durchlaufen sie Elemente hinzugefügt werden müssen, können Sie sie durchlaufen, Index mithilfe der for -Anweisung anstelle von foreach oder For Each.If elements must be added to the collection while iterating it, you can iterate it by index using the for statement instead of foreach or For Each. Im folgenden Beispiel wird die für die Anweisung, um das Quadrat der Zahlen in der Auflistung in der Auflistung hinzufügen.The following example uses the for statement to add the square of numbers in the collection to the collection.

    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
    
    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 herstellen müssen, vor dem Durchlaufen der Auflistung durch ein Indikator innerhalb der Schleife, die entsprechend die Schleife beendet wird, durch Iteration rückwärts, von Count – 1 auf 0 (null) oder, wie im Beispiel durch das Zuweisen der Zahl der Elemente im Array, an eine Variable, und verwenden, um die Obergrenze der Schleife herzustellen.Note that you must establish the number of iterations before iterating the collection either by using a counter inside the loop that will exit the loop appropriately, by iterating backward, from Count - 1 to 0, or, as the example does, by assigning the number of elements in the array to a variable and using it to establish the upper bound of the loop. Wenn ein Element der Auflistung bei jeder Iteration hinzugefügt wird, führt andernfalls eine Endlosschleife.Otherwise, if an element is added to the collection on every iteration, an endless loop results.

  • Ist dies nicht erforderlich, um die Auflistung beim Durchlaufen sie Elemente hinzuzufügen, können Sie speichern die Elemente in eine temporäre Sammlung hinzugefügt werden, die Sie hinzufügen, beim Durchlaufen der Auflistung abgeschlossen ist.If it is not necessary to add elements to the collection while iterating it, you can store the elements to be added in a temporary collection that you add when iterating the collection has finished. Im folgenden Beispiel wird dieser Ansatz, fügen das Quadrat der Zahlen in einer Auflistung in eine temporäre Sammlung zu, und klicken Sie dann auf die Sammlungen in ein einzelnes Array-Objekt zu kombinieren.The following example uses this approach to add the square of numbers in a collection to a temporary collection, and then to combine the collections into a single array object.

    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
    
    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 von einem Array oder einer Auflistung, deren Objekte können nicht verglichen werdenSorting an array or collection whose objects cannot be compared

Allgemeine Methoden, wie z. B. Sortieren der Array.Sort(Array) Methode oder die List<T>.Sort() -Methode in der Regel erforderlich, mindestens eine der zu sortierenden Objekte implementieren die IComparable<T> oder IComparable Schnittstelle.General-purpose sorting methods, such as the Array.Sort(Array) method or the List<T>.Sort() method, usually require that at least one of the objects to be sorted implement the IComparable<T> or the IComparable interface. Wenn nicht der Fall, der Sammlung oder des Arrays kann nicht sortiert werden, und die Methode löst eine InvalidOperationException Ausnahme.If not, the collection or array cannot be sorted, and the method throws an InvalidOperationException exception. Das folgende Beispiel definiert eine Person -Klasse speichert zwei Person Objekte in einem generischen List<T> -Objekt, und versucht, sie zu sortieren.The following example defines a Person class, stores two Person objects in a generic List<T> object, and attempts to sort them. Wie die Ausgabe des Beispiels zeigt, wird durch den Aufruf der List<T>.Sort() -Methode löst eine InvalidOperationException.As the output from the example shows, the call to the List<T>.Sort() method throws an 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()
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 in einem von drei Arten vermeiden:You can eliminate the exception in any of three ways:

  • Wenn Sie den Typ, die Sie sortieren besitzen können (d.h., wenn Sie Quellcode steuern) möchten, können Sie ändern, implementiert die IComparable<T> oder IComparable Schnittstelle.If you can own the type that you are trying to sort (that is, if you control its source code), you can modify it to implement the IComparable<T> or the IComparable interface. Dies erfordert, dass Sie implementieren die IComparable<T>.CompareTo oder CompareTo Methode.This requires that you implement either the IComparable<T>.CompareTo or the CompareTo method. Hinzufügen einer schnittstellenimplementierung zu einem vorhandenen Typ ist keine unterbrechende Änderung.Adding an interface implementation to an existing type is not a breaking change.

    Im folgenden Beispiel wird dieser Ansatz zu einem IComparable<T> Implementierung für die Person Klasse.The following example uses this approach to provide an IComparable<T> implementation for the Person class. Können Sie weiterhin die Auflistung oder allgemeine Sortieren des Arrays-Methode aufrufen und wie die Ausgabe des Beispiels zeigt, wird die Sammlung erfolgreich sortiert.You can still call the collection or array's general sorting method and, as the output from the example shows, the collection sorts successfully.

    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}", LastName, 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
    
    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}", LastName, 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, die für Sie sortieren möchten ändern können, können Sie definieren, dass eine spezielle Sortierung-Klasse, implementiert die IComparer<T> Schnittstelle.If you cannot modify the source code for the type you are trying to sort, you can define a special-purpose sorting class that implements the IComparer<T> interface. Sie können eine Überladung von Aufrufen der Sort Methode, enthält ein IComparer<T> Parameter.You can call an overload of the Sort method that includes an IComparer<T> parameter. Dieser Ansatz ist besonders nützlich, wenn Sie eine spezialisierte Klasse für die Sortierung zu entwickeln, die Objekte, die auf der Grundlage mehrerer Kriterien sortieren möchten.This approach is especially useful if you want to develop a specialized sorting class that can sort objects based on multiple criteria.

    Im folgenden Beispiel wird den Ansatz von Entwickeln eines benutzerdefinierten PersonComparer -Klasse, die zum Sortieren verwendet wird Person Sammlungen.The following example uses the approach by developing a custom PersonComparer class that is used to sort Person collections. Anschließend übergibt eine Instanz dieser Klasse, die List<T>.Sort(IComparer<T>) Methode.It then passes an instance of this class to the List<T>.Sort(IComparer<T>) method.

    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
    
    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 ändern, können Sie sortieren möchten, können Sie erstellen eine Comparison<T> Delegat, der die Sortierung.If you cannot modify the source code for the type you are trying to sort, you can create a Comparison<T> delegate to perform the sorting. Die Signatur des Delegaten ist.The delegate signature is

    Function Comparison(Of T)(x As T, y As T) As Integer  
    
    int Comparison<T>(T x, T y)  
    

    Im folgenden Beispiel wird die Vorgehensweise, durch die Definition einer PersonComparison Methode, entspricht die Comparison<T> Signatur des Delegaten.The following example uses the approach by defining a PersonComparison method that matches the Comparison<T> delegate signature. Anschließend übergibt es dieses Delegaten, um die List<T>.Sort(Comparison<T>) Methode.It then passes this delegate to the List<T>.Sort(Comparison<T>) method.

    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
    
    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
    

Ein Typ Nullable Umwandlung<T >, die null ist, um deren zugrunde liegender TypCasting a Nullable<T> that is null to its underlying type

Umwandeln möchten eine Nullable<T> Wert, der null in den zugrunde liegenden Typ löst eine InvalidOperationException Ausnahme und zeigt die Fehlermeldung "auf NULL festlegbare Objekt muss einen Wert aufweisen.Attempting to cast a Nullable<T> value that is null to its underlying type throws an InvalidOperationException exception and displays the error message, "Nullable object must have a value.

Das folgende Beispiel löst eine InvalidOperationException Ausnahme aus, wenn versucht wird, durchlaufen Sie ein Array, umfasst eine Nullable(Of Integer) Wert.The following example throws an InvalidOperationException exception when it attempts to iterate an array that includes a Nullable(Of Integer) value.

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()
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()

Um die Ausnahme zu verhindern:To prevent the exception:

Im folgende Beispiel wird sowohl zum Vermeiden der InvalidOperationException Ausnahme.The following example does both to avoid the InvalidOperationException exception.

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
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

Eine System.Linq.Enumerable-Methode für eine leere Auflistung aufgerufenCalling a System.Linq.Enumerable method on an empty collection

Die Enumerable.Aggregate, Enumerable.Average, Enumerable.First, Enumerable.Last, Enumerable.Max, Enumerable.Min, Enumerable.Single, und Enumerable.SingleOrDefault Methoden führen Vorgänge für eine Sequenz, und geben ein Einzelergebnis zurück.The Enumerable.Aggregate, Enumerable.Average, Enumerable.First, Enumerable.Last, Enumerable.Max, Enumerable.Min, Enumerable.Single, and Enumerable.SingleOrDefault methods perform operations on a sequence and return a single result. Einige Überladungen dieser Methoden lösen eine InvalidOperationException Ausnahme aus, wenn die Sequenz leer ist, während andere Überladungen geben Folgendes zurück null.Some overloads of these methods throw an InvalidOperationException exception when the sequence is empty, while other overloads return null. Die Enumerable.SingleOrDefault Methode löst auch aus einer InvalidOperationException Ausnahme aus, wenn die Sequenz mehr als ein Element enthält.The Enumerable.SingleOrDefault method also throws an InvalidOperationException exception when the sequence contains more than one element.

Hinweis

Die meisten Methoden, die Auslösen einer InvalidOperationException Ausnahme sind Überladungen.Most of the methods that throw an InvalidOperationException exception are overloads. Achten Sie darauf, dass Sie das Verhalten der Überladung verstehen, die Sie auswählen.Be sure that you understand the behavior of the overload that you choose.

Die folgende Tabelle enthält die ausnahmemeldungen, die von der InvalidOperationException Exception-Objekte, die durch Aufrufe von einige ausgelöst System.Linq.Enumerable Methoden.The following table lists the exception messages from the InvalidOperationException exception objects thrown by calls to some System.Linq.Enumerable methods.

MethodeMethod MeldungMessage
Aggregate
Average
Last
Max
Min
Sequenz enthält keine ElementeSequence contains no elements
First Die Sequenz enthält kein übereinstimmendes elementSequence contains no matching element
Single
SingleOrDefault
Sequenz enthält mehrere übereinstimmende ElementeSequence contains more than one matching element

Wie Sie beseitigen oder die Ausnahme behandeln hängt von Ihrer Anwendung Annahmen und für die bestimmte Methode, die Sie aufrufen.How you eliminate or handle the exception depends on your application's assumptions and on the particular method you call.

  • Wenn Sie absichtlich eine der folgenden Methoden aufrufen, ohne eine Überprüfung auf eine leere Sequenz, werden Sie davon aus, dass die Sequenz nicht leer ist und eine leere Sequenz ein unerwartetes Ereignis ist.When you deliberately call one of these methods without checking for an empty sequence, you are assuming that the sequence is not empty, and that an empty sequence is an unexpected occurrence. In diesem Fall eignet sich das Abfangen oder Auslösen der Ausnahme.In this case, catching or rethrowing the exception is appropriate .

  • Wenn dem Fehler zu prüfen, eine leere Sequenz unbeabsichtigten war, können Sie eine der Überladungen der Aufrufen der Enumerable.Any -Überladung verwenden, um zu bestimmen, ob eine Sequenz Elemente enthält.If your failure to check for an empty sequence was inadvertent, you can call one of the overloads of the Enumerable.Any overload to determine whether a sequence contains any elements.

    Tipp

    Aufrufen der Enumerable.Any<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) Methode vor Erstellung einer Sequenz kann die Leistung verbessern, wenn die zu verarbeitenden Daten möglicherweise eine große Anzahl von Elementen enthält oder enthalten Wenn die Operation, die die Sequenz generiert, teuer ist.Calling the Enumerable.Any<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) method before generating a sequence can improve performance if the data to be processed might contain a large number of elements or if operation that generates the sequence is expensive.

  • Wenn Sie z. B. eine Methode aufgerufen haben Enumerable.First, Enumerable.Last, oder Enumerable.Single, können Sie eine alternative Methode, wie z. B. ersetzen Enumerable.FirstOrDefault, Enumerable.LastOrDefault, oder Enumerable.SingleOrDefault, einen Standardwert, anstatt ein Element der Sequenz zurückgibt.If you've called a method such as Enumerable.First, Enumerable.Last, or Enumerable.Single, you can substitute an alternate method, such as Enumerable.FirstOrDefault, Enumerable.LastOrDefault, or Enumerable.SingleOrDefault, that returns a default value instead of a member of the sequence.

Die Beispiele enthalten zusätzliche Details.The examples provide additional detail.

Im folgenden Beispiel wird die Enumerable.Average Methode, um den Durchschnitt einer Sequenz zu berechnen, deren Werte größer als 4 sind.The following example uses the Enumerable.Average method to compute the average of a sequence whose values are greater than 4. Da keine Werte aus dem ursprünglichen Array nicht, 4 überschreiten, sind keine Werte in der Sequenz enthalten ist und die Methode löst eine InvalidOperationException Ausnahme.Since no values from the original array exceed 4, no values are included in the sequence, and the method throws an InvalidOperationException exception.

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()
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 behoben werden, durch den Aufruf der Any Methode, um zu bestimmen, ob die Sequenz Elemente enthält, bevor die Sequenz, wie im folgenden Beispiel gezeigt Aufrufen der Methode, die verarbeitet werden.The exception can be eliminated by calling the Any method to determine whether the sequence contains any elements before calling the method that processes the sequence, as the following example shows.

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.
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 eine Sequenz, die eine angegebene Bedingung erfüllt.The Enumerable.First method returns the first item in a sequence or the first element in a sequence that satisfies a specified condition. Wenn die Sequenz leer ist, und verfügt daher nicht über ein erstes Element, löst eine InvalidOperationException Ausnahme.If the sequence is empty and therefore does not have a first element, it throws an InvalidOperationException exception.

Im folgenden Beispiel die Enumerable.First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) -Methode löst eine InvalidOperationException Ausnahme, da das DbQueryResults Array kein Element größer als 4 enthält.In the following example, the Enumerable.First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) method throws an InvalidOperationException exception because the dbQueryResults array doesn't contain an element greater than 4.

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()
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()

Rufen Sie die Enumerable.FirstOrDefault Methode anstelle von Enumerable.First zum Zurückgeben eines angegebenen Werts oder Standardwerts.You can call the Enumerable.FirstOrDefault method instead of Enumerable.First to return a specified or default value. Wenn die Methode ein erstes Element in der Sequenz nicht gefunden wird, wird der Standardwert für diesen Datentyp zurückgegeben.If the method does not find a first element in the sequence, it returns the default value for that data type. Der Standardwert ist null für einen Verweistyp Null für einen numerischen Datentyp aufweisen, und DateTime.MinValue für die DateTime Typ.The default value is null for a reference type, zero for a numeric data type, and DateTime.MinValue for the DateTime type.

Hinweis

Interpretieren von zurückgegebenen Wert die Enumerable.FirstOrDefault Methode wird häufig dadurch erschwert, dass der Standardwert des Typs einen gültigen Wert in der Sequenz sein kann.Interpreting the value returned by the Enumerable.FirstOrDefault method is often complicated by the fact that the default value of the type can be a valid value in the sequence. In diesem Fall Sie einen Aufruf der Enumerable.Any Methode, um zu bestimmen, ob die Sequenz gültige Member vor dem Aufruf verfügt der Enumerable.First Methode.In this case, you an call the Enumerable.Any method to determine whether the sequence has valid members before calling the Enumerable.First method.

Im folgenden Beispiel wird die Enumerable.FirstOrDefault<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) Methode, um zu verhindern, dass die InvalidOperationException Ausnahme, die im vorherigen Beispiel.The following example calls the Enumerable.FirstOrDefault<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) method to prevent the InvalidOperationException exception thrown in the previous example.

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.
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 auf eine Sequenz ohne ein elementCalling Enumerable.Single or Enumerable.SingleOrDefault on a sequence without one element

Die Enumerable.Single Methode gibt das einzige Element einer Sequenz, das einzige Element einer Sequenz, die eine angegebene Bedingung erfüllen.The Enumerable.Single method returns the only element of a sequence, or the only element of a sequence that meets a specified condition. Wenn keine Elemente in der Sequenz vorhanden sind, oder wenn mehr als ein Element vorhanden ist, die Methode löst eine InvalidOperationException Ausnahme.If there are no elements in the sequence, or if there is more than one element , the method throws an InvalidOperationException exception.

Sie können die Enumerable.SingleOrDefault -Methode zur Rückgabe eines Standardwert, anstatt eine Ausnahme auszulösen, wenn die Sequenz keine Elemente enthält.You can use the Enumerable.SingleOrDefault method to return a default value instead of throwing an exception when the sequence contains no elements. Allerdings die Enumerable.SingleOrDefault Methode löst immer noch aus einem InvalidOperationException Ausnahme aus, wenn die Sequenz mehr als ein Element enthält.However, the Enumerable.SingleOrDefault method still throws an InvalidOperationException exception when the sequence contains more than one element.

Die folgende Tabelle enthält die ausnahmemeldungen, die von der InvalidOperationException Exception-Objekte, die ausgelöst wird, durch Aufrufe der Enumerable.Single und Enumerable.SingleOrDefault Methoden.The following table lists the exception messages from the InvalidOperationException exception objects thrown by calls to the Enumerable.Single and Enumerable.SingleOrDefault methods.

MethodeMethod MeldungMessage
Single Die Sequenz enthält kein übereinstimmendes elementSequence contains no matching element
Single
SingleOrDefault
Sequenz enthält mehrere übereinstimmende ElementeSequence contains more than one matching element

Im folgenden Beispiel der Aufruf der Enumerable.Single -Methode löst eine InvalidOperationException Ausnahme, da die Sequenz nicht über ein Element größer als 4 verfügt.In the following example, the call to the Enumerable.Single method throws an InvalidOperationException exception because the sequence doesn't have an element greater than 4.

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()
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, um zu verhindern, dass die InvalidOperationException Ausnahme wird ausgelöst, wenn eine Sequenz leer ist, indem Sie stattdessen Aufrufen der Enumerable.SingleOrDefault Methode.The following example attempts to prevent the InvalidOperationException exception thrown when a sequence is empty by instead calling the Enumerable.SingleOrDefault method. Aber da dieser Sequenz mehrere Elemente zurückgibt, deren Wert größer als 2 ist, außerdem löst eine InvalidOperationException Ausnahme.However, because this sequence returns multiple elements whose value is greater than 2, it also throws an InvalidOperationException exception.

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()
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()

Aufrufen der Enumerable.Single Methode wird davon ausgegangen, dass entweder eine Sequenz oder die Sequenz, die angegebenen Kriterien erfüllt nur ein einziges Element enthält.Calling the Enumerable.Single method assumes that either a sequence or the sequence that meets specified criteria contains only one element. Enumerable.SingleOrDefault geht davon aus einer Sequenz mit keinem oder einem Ergebnis, aber nicht mehr.Enumerable.SingleOrDefault assumes a sequence with zero or one result, but no more. Wenn diese Annahme eine bewusste ihrerseits ist aus, und diese Bedingungen nicht erfüllt, auslösen oder abfangen, die resultierende InvalidOperationException eignet.If this assumption is a deliberate one on your part and these conditions are not met, rethrowing or catching the resulting InvalidOperationException is appropriate. Andernfalls, oder wenn Sie erwarten, dass ungültige Bedingungen häufig auftritt, sollten Sie erwägen, mithilfe eines anderen Enumerable -Methode, wie z. B. FirstOrDefault oder Where.Otherwise, or if you expect that invalid conditions will occur with some frequency, you should consider using some other Enumerable method, such as FirstOrDefault or Where.

Dynamische anwendungsdomänenübergreifender FeldzugriffDynamic cross-application domain field access

Die OpCodes.Ldflda Microsoft intermediate Language (MSIL)-Anweisung löst einen InvalidOperationException -Ausnahme aus, wenn das Objekt, das mit dem Feld, dessen Adresse Sie abrufen möchten, nicht innerhalb der Anwendungsdomäne ist in der Ihr Code ausgeführt wird.The OpCodes.Ldflda Microsoft intermediate language (MSIL) instruction throws an InvalidOperationException exception if the object containing the field whose address you are trying to retrieve is not within the application domain in which your code is executing. Die Adresse eines Felds kann nur von der Anwendungsdomäne zugegriffen werden, in dem er sich befindet.The address of a field can only be accessed from the application domain in which it resides.

Auslösen einer InvalidOperationException-AusnahmeThrowing an InvalidOperationException exception

Lösen Sie eine InvalidOperationException Ausnahme nur, wenn der Zustand des Objekts aus irgendeinem Grund nicht mit einen bestimmten Methodenaufruf unterstützt.You should throw an InvalidOperationException exception only when the state of your object for some reason does not support a particular method call. D. h. Aufruf der Methode in einigen Fällen oder Kontexten gültig ist, ist jedoch ungültig in anderen.That is, the method call is valid in some circumstances or contexts, but is invalid in others.

Wenn der Methodenaufruf aufgrund von ungültigen Argumenten ist ArgumentException oder eine der davon abgeleiteten Klassen, ArgumentNullException oder ArgumentOutOfRangeException, stattdessen ausgelöst werden soll.If the method invocation failure is due to invalid arguments, then ArgumentException or one of its derived classes, ArgumentNullException or ArgumentOutOfRangeException, should be thrown instead.

Verschiedene InformationenMiscellaneous information

InvalidOperationException wird verwendet, mit dem Wert 0 x 80131509 HRESULT COR_E_INVALIDOPERATION.InvalidOperationException uses the HRESULT COR_E_INVALIDOPERATION, which has the value 0x80131509.

Eine Liste der anfänglichen Eigenschaftswerte für eine Instanz von InvalidOperationException, finden Sie unter den InvalidOperationException Konstruktoren.For a list of initial property values for an instance of InvalidOperationException, see the InvalidOperationException constructors.

Konstruktoren

InvalidOperationException() InvalidOperationException() InvalidOperationException() InvalidOperationException()

Initialisiert eine neue Instanz der InvalidOperationException-Klasse.Initializes a new instance of the InvalidOperationException class.

InvalidOperationException(SerializationInfo, StreamingContext) InvalidOperationException(SerializationInfo, StreamingContext) InvalidOperationException(SerializationInfo, StreamingContext) InvalidOperationException(SerializationInfo, StreamingContext)

Initialisiert eine neue Instanz der InvalidOperationException-Klasse mit serialisierten Daten.Initializes a new instance of the InvalidOperationException class with serialized data.

InvalidOperationException(String) InvalidOperationException(String) InvalidOperationException(String) InvalidOperationException(String)

Initialisiert eine neue Instanz der InvalidOperationException-Klasse mit einer angegebenen Fehlermeldung.Initializes a new instance of the InvalidOperationException class with a specified error message.

InvalidOperationException(String, Exception) InvalidOperationException(String, Exception) InvalidOperationException(String, Exception) 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.Initializes a new instance of the InvalidOperationException class with a specified error message and a reference to the inner exception that is the cause of this exception.

Eigenschaften

Data Data Data Data

Ruft eine Auflistung von Schlüssel-Wert-Paaren ab, die zusätzliche benutzerdefinierte Informationen über die Ausnahme bereitstellen.Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Inherited from Exception)
HelpLink HelpLink HelpLink HelpLink

Ruft einen Link zur Hilfedatei ab, die dieser Ausnahme zugeordnet ist, oder legt einen Link fest.Gets or sets a link to the help file associated with this exception.

(Inherited from Exception)
HResult HResult HResult HResult

Ruft HRESULT ab oder legt HRESULT fest. Dies ist ein codierter Wert, der einer bestimmten Ausnahme zugeordnet ist.Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Inherited from Exception)
InnerException InnerException InnerException InnerException

Ruft die Exception-Instanz ab, die die aktuelle Ausnahme verursacht hat.Gets the Exception instance that caused the current exception.

(Inherited from Exception)
Message Message Message Message

Ruft eine Meldung ab, die die aktuelle Ausnahme beschreibt.Gets a message that describes the current exception.

(Inherited from Exception)
Source Source Source Source

Gibt den Namen der Anwendung oder des Objekts zurück, die bzw. das den Fehler verursacht hat, oder legt diesen fest.Gets or sets the name of the application or the object that causes the error.

(Inherited from Exception)
StackTrace StackTrace StackTrace StackTrace

Ruft eine Zeichenfolgendarstellung der unmittelbaren Frames in der Aufrufliste ab.Gets a string representation of the immediate frames on the call stack.

(Inherited from Exception)
TargetSite TargetSite TargetSite TargetSite

Ruft die Methode ab, die die aktuelle Ausnahme auslöst.Gets the method that throws the current exception.

(Inherited from Exception)

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetBaseException() GetBaseException() GetBaseException() GetBaseException()

Gibt beim Überschreiben in einer abgeleiteten Klasse eine Exception zurück, die die ursprüngliche Ursache für eine oder mehrere nachfolgende Ausnahmen ist.When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(Inherited from Exception)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext)

Legt beim Überschreiben in einer abgeleiteten Klasse die SerializationInfo mit Informationen über die Ausnahme fest.When overridden in a derived class, sets the SerializationInfo with information about the exception.

(Inherited from Exception)
GetType() GetType() GetType() GetType()

Ruft den Laufzeittyp der aktuellen Instanz ab.Gets the runtime type of the current instance.

(Inherited from Exception)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Erstellt eine Zeichenfolgendarstellung der aktuellen Ausnahme und gibt diese zurück.Creates and returns a string representation of the current exception.

(Inherited from Exception)

Ereignisse

SerializeObjectState SerializeObjectState SerializeObjectState SerializeObjectState

Tritt auf, wenn eine Ausnahme serialisiert wird, um ein Ausnahmezustandsobjekt mit serialisierten Daten über die Ausnahme zu erstellen.Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Inherited from Exception)

Gilt für:

Siehe auch