InvalidOperationException Klasa

Definicja

Wyjątek, który jest generowany, gdy wywołanie metody jest nieprawidłowe dla bieżącego stanu obiektu.The exception that is thrown when a method call is invalid for the object's current state.

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.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public class InvalidOperationException : SystemException
type InvalidOperationException = class
    inherit Exception
type InvalidOperationException = class
    inherit SystemException
Public Class InvalidOperationException
Inherits Exception
Public Class InvalidOperationException
Inherits SystemException
Dziedziczenie
InvalidOperationException
Dziedziczenie
InvalidOperationException
Pochodne
Atrybuty

Uwagi

InvalidOperationException jest używany w przypadkach, gdy błąd wywołania metody jest spowodowany przyczynami innymi niż nieprawidłowe argumenty.InvalidOperationException is used in cases when the failure to invoke a method is caused by reasons other than invalid arguments. Zwykle jest generowany, gdy stan obiektu nie może obsługiwać wywołania metody.Typically, it is thrown when the state of an object cannot support the method call. Na przykład wyjątek InvalidOperationException jest generowany przez metody takie jak:For example, an InvalidOperationException exception is thrown by methods such as:

  • IEnumerator.MoveNext, jeśli obiekty kolekcji są modyfikowane po utworzeniu modułu wyliczającego.IEnumerator.MoveNext if objects of a collection are modified after the enumerator is created. Aby uzyskać więcej informacji, zobacz Zmiana kolekcji podczas iteracji.For more information, see Changing a collection while iterating it.

  • ResourceSet.GetString, jeśli zestaw zasobów zostanie zamknięty przed wywołaniem metody.ResourceSet.GetString if the resource set is closed before the method call is made.

  • XContainer.Add, jeśli obiekt lub obiekty, które mają zostać dodane, spowodują niewłaściwy strukturalny dokument XML.XContainer.Add, if the object or objects to be added would result in an incorrectly structured XML document.

  • Metoda próbująca manipulować interfejsem użytkownika z wątku, który nie jest interfejsem głównym lub wątkiem interfejsu użytkownika.A method that attempts to manipulate the UI from a thread that is not the main or UI thread.

Ważne

Wyjątek InvalidOperationException może być zgłaszany w wielu sytuacjach, dlatego ważne jest, aby odczytać komunikat o wyjątku zwrócony przez właściwość Message.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.

W tej sekcji:In this section:

Niektóre typowe przyczyny wyjątków InvalidOperationException Some common causes of InvalidOperationException exceptions
Aktualizowanie wątku interfejsu użytkownika z wątku innego niż interfejs użytkownikaUpdating a UI thread from a non-UI thread
Zmiana kolekcji podczas iteracjiChanging a collection while iterating it
Sortowanie tablicy lub kolekcji, której nie można porównać obiektówSorting an array or collection whose objects cannot be compared
Rzutowanie wartości null<t>, która ma wartość null do jego typu podstawowego Casting a Nullable<T> that is null to its underlying type
Wywoływanie metody System. LINQ. wyliczalnej w pustej kolekcjiCalling a System.Linq.Enumerable method on an empty collection
Wywoływanie wyliczalnego elementu. Single lub wyliczalny. SingleOrDefault na sekwencji bez jednego elementuCalling Enumerable.Single or Enumerable.SingleOrDefault on a sequence without one element
Dynamiczny dostęp do pola domeny wielu aplikacjiDynamic cross-application domain field access
Zgłaszanie wyjątku InvalidOperationExceptionThrowing an InvalidOperationException exception
Różne informacjeMiscellaneous information

Niektóre typowe przyczyny wyjątków InvalidOperationExceptionSome common causes of InvalidOperationException exceptions

W poniższych sekcjach pokazano, jak niektóre typowe przypadki, w których InvalidOperationException wyjątek, są zgłaszane w aplikacji.The following sections show how some common cases in which in InvalidOperationException exception is thrown in an app. Sposób obsługi problemu zależy od konkretnej sytuacji.How you handle the issue depends on the specific situation. Zwykle jednak wyjątek jest spowodowany błędem dewelopera, a wyjątek InvalidOperationException można oczekiwać i uniknąć.Most commonly, however, the exception results from developer error, and the InvalidOperationException exception can be anticipated and avoided.

Aktualizowanie wątku interfejsu użytkownika z wątku innego niż interfejs użytkownikaUpdating a UI thread from a non-UI thread

Często wątki robocze są używane do wykonywania niektórych zadań w tle, które obejmują gromadzenie danych do wyświetlania w interfejsie użytkownika aplikacji.Often, worker threads are used to perform some background work that involves gathering data to be displayed in an application's user interface. Ale.However. Najpopularniejsze struktury aplikacji (graficznego interfejsu użytkownika) dla .NET Framework, takie jak Windows Forms i Windows Presentation Foundation (WPF), umożliwiają dostęp do obiektów GUI tylko z wątku, który tworzy i zarządza interfejsem użytkownika (główny lub wątek interfejsu użytkownika).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). InvalidOperationException jest generowany podczas próby dostępu do elementu interfejsu użytkownika z wątku innego niż wątek interfejsu użytkownika.An InvalidOperationException is thrown when you try to access a UI element from a thread other than the UI thread. W poniższej tabeli przedstawiono tekst komunikatu o wyjątku.The text of the exception message is shown in the following table.

Typ aplikacjiApplication Type KomunikatMessage
Aplikacja WPFWPF app Wątek wywołujący nie może uzyskać dostępu do tego obiektu, ponieważ należy on do innego wątku.The calling thread cannot access this object because a different thread owns it.
Aplikacja platformy UWPUWP app Aplikacja nazywana interfejsem, który został zorganizowany dla innego wątku.The application called an interface that was marshaled for a different thread.
Aplikacja Windows FormsWindows Forms app Nieprawidłowa operacja między wątkami: do kontrolki "TextBox1" uzyskano dostęp z wątku innego niż wątek, w którym został utworzony.Cross-thread operation not valid: Control 'TextBox1' accessed from a thread other than the thread it was created on.

Struktury interfejsu użytkownika dla .NET Framework implementują wzorzec dyspozytora , który zawiera metodę do sprawdzenia, czy wywołanie elementu CZŁONKOWSKIEgo interfejsu użytkownika jest wykonywane w wątku interfejsu użytkownika, oraz inne metody zaplanowania wywołania w wątku interfejsu użytkownika: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:

  • W aplikacjach WPF Wywołaj metodę Dispatcher.CheckAccess, aby określić, czy metoda jest uruchomiona w wątku nie będącym interfejsem użytkownika.In WPF apps, call the Dispatcher.CheckAccess method to determine if a method is running on a non-UI thread. Zwraca true, jeśli metoda jest uruchomiona w wątku interfejsu użytkownika i false w inny sposób.It returns true if the method is running on the UI thread and false otherwise. Wywołaj jedno z przeciążeń metody Dispatcher.Invoke, aby zaplanować wywołanie w wątku interfejsu użytkownika.Call one of the overloads of the Dispatcher.Invoke method to schedule the call on the UI thread.

  • W aplikacjach platformy UWP Sprawdź Właściwość CoreDispatcher.HasThreadAccess, aby określić, czy metoda jest uruchomiona w wątku nie będącym interfejsem użytkownika.In UWP apps, check the CoreDispatcher.HasThreadAccess property to determine if a method is running on a non-UI thread. Wywołaj metodę CoreDispatcher.RunAsync, aby wykonać delegata, który zaktualizuje wątek interfejsu użytkownika.Call the CoreDispatcher.RunAsync method to execute a delegate that updates the UI thread.

  • W aplikacjach Windows Forms Użyj właściwości Control.InvokeRequired, aby określić, czy metoda jest uruchomiona w wątku nie będącym interfejsem użytkownika.In Windows Forms apps, use the Control.InvokeRequired property to determine if a method is running on a non-UI thread. Wywołaj jedno z przeciążeń metody Control.Invoke, aby wykonać delegata, który zaktualizuje wątek interfejsu użytkownika.Call one of the overloads of the Control.Invoke method to execute a delegate that updates the UI thread.

Poniższe przykłady ilustrują wyjątek InvalidOperationException, który jest zgłaszany podczas próby zaktualizowania elementu interfejsu użytkownika z wątku innego niż wątek, który go utworzył.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. Każdy przykład wymaga utworzenia dwóch kontrolek:Each example requires that you create two controls:

  • Kontrolka pola tekstowego o nazwie textBox1.A text box control named textBox1. W aplikacji Windows Forms należy ustawić jej Właściwość Multiline na true.In a Windows Forms app, you should set its Multiline property to true.

  • Kontrolka przycisku o nazwie threadExampleBtn.A button control named threadExampleBtn. W przykładzie przedstawiono procedurę obsługi ThreadsExampleBtn_Clickdla zdarzenia Click przycisku.The example provides a handler, ThreadsExampleBtn_Click, for the button's Click event.

W każdym przypadku program obsługi zdarzeń threadExampleBtn_Click wywołuje metodę DoSomeWork dwa razy.In each case, the threadExampleBtn_Click event handler calls the DoSomeWork method twice. Pierwsze wywołanie przebiega synchronicznie i kończy się powodzeniem.The first call runs synchronously and succeeds. Ale drugie wywołanie, ponieważ działa asynchronicznie w wątku puli wątków, próbuje zaktualizować interfejs użytkownika z wątku innego niż interfejs użytkownika.But the second call, because it runs asynchronously on a thread pool thread, attempts to update the UI from a non-UI thread. Powoduje to wyjątek InvalidOperationException.This results in a InvalidOperationException exception.

Aplikacje WPF i platformy UWPWPF 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

Poniższa wersja metody DoSomeWork eliminuje wyjątek w aplikacji WPF.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

Następująca wersja metody DoSomeWork eliminuje wyjątek w aplikacji platformy UWP.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

Aplikacja Windows FormsWindows 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

Poniższa wersja metody DoSomeWork eliminuje wyjątek w aplikacji Windows Forms.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

Zmiana kolekcji podczas iteracjiChanging a collection while iterating it

Instrukcja foreach w C# instrukcji lub For Each w Visual Basic jest używana do iteracji elementów członkowskich kolekcji i odczytywania lub modyfikowania poszczególnych elementów.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. Nie można go jednak użyć do dodania lub usunięcia elementów z kolekcji.However, it can't be used to add or remove items from the collection. W ten sposób zgłaszany jest wyjątek InvalidOperationException z komunikatem podobnym do "Kolekcja została zmodyfikowana; nie można wykonać operacji wyliczania ".Doing this throws an InvalidOperationException exception with a message that is similar to, "Collection was modified; enumeration operation may not execute."

Poniższy przykład wykonuje iterację kolekcji liczb całkowitych próbuje dodać kwadrat każdej liczby całkowitej do kolekcji.The following example iterates a collection of integers attempts to add the square of each integer to the collection. Przykład generuje InvalidOperationException przy pierwszym wywołaniu metody List<T>.Add.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()

Wyjątek można wyeliminować na jeden z dwóch sposobów, w zależności od logiki aplikacji:You can eliminate the exception in one of two ways, depending on your application logic:

  • Jeśli elementy należy dodać do kolekcji podczas iteracji, można wykonać iterację przez indeks przy użyciu instrukcji for zamiast foreach lub 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. Poniższy przykład używa instrukcji for, aby dodać do kolekcji kwadrat numerów z kolekcji.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
    

    Należy pamiętać, że przed iteracją kolekcji należy określić liczbę iteracji, przy użyciu licznika wewnątrz pętli, która odpowiednio zamyka pętlę, zwracając do tyłu, od Count-1 do 0, lub, jak na przykład, przypisując liczbę elementów w tablicy do zmiennej i używając jej do ustanowienia górnej granicy pętli.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. W przeciwnym razie, jeśli element zostanie dodany do kolekcji dla każdej iteracji, powstaje nieskończona pętla.Otherwise, if an element is added to the collection on every iteration, an endless loop results.

  • Jeśli nie jest konieczne dodawanie elementów do kolekcji podczas iteracji, można zapisać elementy do dodania w tymczasowej kolekcji dodawanej podczas iteracji kolekcji.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. Poniższy przykład używa tego podejścia do dodawania kwadratów liczb w kolekcji do tymczasowej kolekcji, a następnie do łączenia kolekcji w jeden obiekt Array.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
    

Sortowanie tablicy lub kolekcji, której nie można porównać obiektówSorting an array or collection whose objects cannot be compared

Metody sortowania ogólnego przeznaczenia, takie jak Metoda Array.Sort(Array) lub metoda List<T>.Sort(), zwykle wymagają, aby co najmniej jeden z obiektów do posortowania implementuje interfejs IComparable<T> lub IComparable.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. W przeciwnym razie kolekcja lub tablica nie może być posortowana, a metoda zgłasza wyjątek InvalidOperationException.If not, the collection or array cannot be sorted, and the method throws an InvalidOperationException exception. W poniższym przykładzie zdefiniowano klasę Person, są przechowywane dwa obiekty Person w ogólnym obiekcie List<T> i próby posortowania.The following example defines a Person class, stores two Person objects in a generic List<T> object, and attempts to sort them. Ponieważ dane wyjściowe z przykładu pokazują, wywołanie metody List<T>.Sort() zgłasza 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()

Wyjątek można wyeliminować na jeden z trzech sposobów:You can eliminate the exception in any of three ways:

  • Jeśli możesz określić typ, który ma zostać posortowany (to oznacza, że jeśli kontrolujesz swój kod źródłowy), możesz go zmodyfikować, aby zaimplementować IComparable<T> lub interfejs IComparable.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. Wymaga to zaimplementowania metody IComparable<T>.CompareTo lub CompareTo.This requires that you implement either the IComparable<T>.CompareTo or the CompareTo method. Dodawanie implementacji interfejsu do istniejącego typu nie jest istotną zmianą.Adding an interface implementation to an existing type is not a breaking change.

    Poniższy przykład używa tego podejścia, aby zapewnić implementację IComparable<T> dla klasy Person.The following example uses this approach to provide an IComparable<T> implementation for the Person class. Nadal można wywołać ogólną metodę sortowania kolekcji lub tablicy oraz, jak dane wyjściowe z przykładu pokazują, kolekcja zostanie posortowana pomyślnie.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}", 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
    
    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
    
  • Jeśli nie można zmodyfikować kodu źródłowego dla typu, który próbujesz sortować, można zdefiniować klasy sortowania specjalnego przeznaczenia implementującej interfejs IComparer<T>.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. Można wywołać Przeciążenie metody Sort, która zawiera parametr IComparer<T>.You can call an overload of the Sort method that includes an IComparer<T> parameter. Takie podejście jest szczególnie przydatne, jeśli chcesz opracować wyspecjalizowaną klasę sortowania, która może sortować obiekty na podstawie wielu kryteriów.This approach is especially useful if you want to develop a specialized sorting class that can sort objects based on multiple criteria.

    W poniższym przykładzie użyto podejścia, tworząc niestandardową klasę PersonComparer, która jest używana do sortowania Person kolekcje.The following example uses the approach by developing a custom PersonComparer class that is used to sort Person collections. Następnie przekazuje wystąpienie tej klasy do metody List<T>.Sort(IComparer<T>).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
    
  • Jeśli nie możesz zmodyfikować kodu źródłowego dla typu, który chcesz posortować, możesz utworzyć delegata Comparison<T>, aby wykonać sortowanie.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. Podpis delegata toThe delegate signature is

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

    Poniższy przykład używa podejścia przez zdefiniowanie metody PersonComparison, która pasuje do Comparison<T> sygnatury delegata.The following example uses the approach by defining a PersonComparison method that matches the Comparison<T> delegate signature. Następnie przekazuje tego delegata do metody List<T>.Sort(Comparison<T>).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
    

Rzutowanie wartości null<T >, która ma wartość null do jego typu podstawowegoCasting a Nullable<T> that is null to its underlying type

Próba rzutowania wartości Nullable<T>, która jest null do jego typu podstawowego zgłasza wyjątek InvalidOperationException i wyświetla komunikat o błędzie, "obiekt nullable musi mieć wartość.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.

Poniższy przykład zgłasza wyjątek InvalidOperationException, gdy próbuje wykonać iterację tablicy, która zawiera wartość Nullable(Of Integer).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()

Aby zapobiec wyjątku:To prevent the exception:

Poniższy przykład ma na celu uniknięcie wyjątku InvalidOperationException.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

Wywoływanie metody System. LINQ. wyliczalnej w pustej kolekcjiCalling a System.Linq.Enumerable method on an empty collection

Metody Enumerable.Aggregate, Enumerable.Average, Enumerable.First, Enumerable.Last, Enumerable.Max, Enumerable.Min, Enumerable.Singlei Enumerable.SingleOrDefault wykonują operacje na sekwencji i zwracają jeden wynik.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. Niektóre przeciążenia tych metod zgłaszają wyjątek InvalidOperationException, gdy sekwencja jest pusta, podczas gdy inne przeciążenia zwracają null.Some overloads of these methods throw an InvalidOperationException exception when the sequence is empty, while other overloads return null. Metoda Enumerable.SingleOrDefault generuje również wyjątek InvalidOperationException, gdy sekwencja zawiera więcej niż jeden element.The Enumerable.SingleOrDefault method also throws an InvalidOperationException exception when the sequence contains more than one element.

Uwaga

Większość metod, które generują wyjątek InvalidOperationException są przeciążeniami.Most of the methods that throw an InvalidOperationException exception are overloads. Upewnij się, że rozumiesz zachowanie wybranego przeciążenia.Be sure that you understand the behavior of the overload that you choose.

W poniższej tabeli wymieniono komunikaty o wyjątkach z obiektów wyjątków InvalidOperationException zgłoszonych przez wywołania niektórych metod System.Linq.Enumerable.The following table lists the exception messages from the InvalidOperationException exception objects thrown by calls to some System.Linq.Enumerable methods.

MetodaMethod KomunikatMessage
Aggregate
Average
Last
Max
Min
Sekwencja nie zawiera żadnych elementówSequence contains no elements
First Sekwencja nie zawiera pasującego elementuSequence contains no matching element
Single
SingleOrDefault
Sekwencja zawiera więcej niż jeden pasujący elementSequence contains more than one matching element

Sposób eliminacji lub obsługi wyjątku zależy od założeń aplikacji oraz od konkretnej metody wywołania.How you eliminate or handle the exception depends on your application's assumptions and on the particular method you call.

  • W przypadku świadomego wywołania jednej z tych metod bez sprawdzania pustej sekwencji zakłada się, że sekwencja nie jest pusta i że pusta sekwencja jest nieoczekiwanym wystąpieniem.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. W takim przypadku należy przechwycić lub ponownie zgłosić wyjątek.In this case, catching or rethrowing the exception is appropriate .

  • Jeśli niepowodzenie sprawdzania pustej sekwencji zostało przypadkowo, można wywołać jeden z przeciążeń przeciążenia Enumerable.Any, aby określić, czy sekwencja zawiera jakiekolwiek elementy.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.

    Porada

    Wywołanie metody Enumerable.Any<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) przed wygenerowaniem sekwencji może zwiększyć wydajność, jeśli dane do przetworzenia mogą zawierać dużą liczbę elementów lub jeśli operacja, która generuje sekwencję, jest kosztowna.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.

  • Jeśli wywoływana jest metoda, taka jak Enumerable.First, Enumerable.Lastlub Enumerable.Single, można zastąpić alternatywną metodę, taką jak Enumerable.FirstOrDefault, Enumerable.LastOrDefaultlub Enumerable.SingleOrDefault, która zwraca wartość domyślną zamiast elementu członkowskiego sekwencji.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.

Przykłady zapewniają dodatkowe szczegóły.The examples provide additional detail.

W poniższym przykładzie zastosowano metodę Enumerable.Average, aby obliczyć średnią sekwencję, której wartości są większe niż 4.The following example uses the Enumerable.Average method to compute the average of a sequence whose values are greater than 4. Ponieważ żadne wartości z oryginalnej tablicy nie przekraczają 4, żadne wartości nie są uwzględniane w sekwencji, a metoda zgłasza wyjątek InvalidOperationException.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()

Wyjątek można wyeliminować, wywołując metodę Any, aby określić, czy sekwencja zawiera jakiekolwiek elementy przed wywołaniem metody, która przetwarza sekwencję, jak pokazano w poniższym przykładzie.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.

Metoda Enumerable.First zwraca pierwszy element w sekwencji lub pierwszy element w sekwencji, który spełnia określony warunek.The Enumerable.First method returns the first item in a sequence or the first element in a sequence that satisfies a specified condition. Jeśli sekwencja jest pusta i w związku z tym nie ma pierwszego elementu, zgłasza wyjątek InvalidOperationException.If the sequence is empty and therefore does not have a first element, it throws an InvalidOperationException exception.

W poniższym przykładzie metoda Enumerable.First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) zgłasza wyjątek InvalidOperationException, ponieważ tablica dbQueryResults nie zawiera elementu większego niż 4.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()

Można wywołać metodę Enumerable.FirstOrDefault zamiast Enumerable.First do zwrócenia wartości określonej lub domyślnej.You can call the Enumerable.FirstOrDefault method instead of Enumerable.First to return a specified or default value. Jeśli metoda nie odnajdzie pierwszego elementu w sekwencji, zwraca wartość domyślną dla tego typu danych.If the method does not find a first element in the sequence, it returns the default value for that data type. Wartość domyślna to null dla typu referencyjnego zero dla typu danych liczbowych i DateTime.MinValue dla typu DateTime.The default value is null for a reference type, zero for a numeric data type, and DateTime.MinValue for the DateTime type.

Uwaga

Interpretacja wartości zwracanej przez metodę Enumerable.FirstOrDefault jest często skomplikowany przez fakt, że wartość domyślna typu może być prawidłową wartością w sekwencji.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. W takim przypadku należy wywołać metodę Enumerable.Any, aby określić, czy sekwencja ma prawidłowych elementów członkowskich przed wywołaniem metody Enumerable.First.In this case, you an call the Enumerable.Any method to determine whether the sequence has valid members before calling the Enumerable.First method.

Poniższy przykład wywołuje metodę Enumerable.FirstOrDefault<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>), aby zapobiec występowaniu wyjątku InvalidOperationException w poprzednim przykładzie.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.

Wywoływanie wyliczalnego elementu. Single lub wyliczalny. SingleOrDefault na sekwencji bez jednego elementuCalling Enumerable.Single or Enumerable.SingleOrDefault on a sequence without one element

Metoda Enumerable.Single zwraca jedyny element sekwencji lub jedyny element sekwencji, która spełnia określony warunek.The Enumerable.Single method returns the only element of a sequence, or the only element of a sequence that meets a specified condition. Jeśli nie ma żadnych elementów w sekwencji lub jeśli występuje więcej niż jeden element, metoda zgłasza wyjątek InvalidOperationException.If there are no elements in the sequence, or if there is more than one element , the method throws an InvalidOperationException exception.

Za pomocą metody Enumerable.SingleOrDefault można zwrócić wartość domyślną zamiast zgłaszania wyjątku, gdy sekwencja nie zawiera żadnych elementów.You can use the Enumerable.SingleOrDefault method to return a default value instead of throwing an exception when the sequence contains no elements. Jednak Metoda Enumerable.SingleOrDefault nadal zgłasza wyjątek InvalidOperationException, gdy sekwencja zawiera więcej niż jeden element.However, the Enumerable.SingleOrDefault method still throws an InvalidOperationException exception when the sequence contains more than one element.

W poniższej tabeli wymieniono komunikaty o wyjątkach z obiektów wyjątków InvalidOperationException zgłoszonych przez wywołania metod Enumerable.Single i Enumerable.SingleOrDefault.The following table lists the exception messages from the InvalidOperationException exception objects thrown by calls to the Enumerable.Single and Enumerable.SingleOrDefault methods.

MetodaMethod KomunikatMessage
Single Sekwencja nie zawiera pasującego elementuSequence contains no matching element
Single
SingleOrDefault
Sekwencja zawiera więcej niż jeden pasujący elementSequence contains more than one matching element

W poniższym przykładzie wywołanie metody Enumerable.Single zgłasza wyjątek InvalidOperationException, ponieważ sekwencja nie ma elementu większego niż 4.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()

Poniższy przykład próbuje zapobiec występowaniu wyjątku InvalidOperationException, gdy sekwencja jest pusta przez wywołanie metody Enumerable.SingleOrDefault.The following example attempts to prevent the InvalidOperationException exception thrown when a sequence is empty by instead calling the Enumerable.SingleOrDefault method. Jednak ponieważ ta sekwencja zwraca wiele elementów, których wartość jest większa niż 2, zgłasza również wyjątek InvalidOperationException.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()

Wywołanie metody Enumerable.Single zakłada, że sekwencję lub sekwencję spełniającą określone kryteria zawierają tylko jeden element.Calling the Enumerable.Single method assumes that either a sequence or the sequence that meets specified criteria contains only one element. Enumerable.SingleOrDefault przyjmuje sekwencję z zerem lub jednym wynikiem, ale nie więcej.Enumerable.SingleOrDefault assumes a sequence with zero or one result, but no more. Jeśli to założenie jest zamierzone w danej części, a te warunki nie są spełnione, ponowne zgłoszenie lub przechwycenie wyniku InvalidOperationException jest odpowiednie.If this assumption is a deliberate one on your part and these conditions are not met, rethrowing or catching the resulting InvalidOperationException is appropriate. W przeciwnym razie, Jeśli spodziewasz się, że nieprawidłowe warunki wystąpią z pewnymi częstotliwościami, należy rozważyć użycie innej metody Enumerable, takiej jak FirstOrDefault lub 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.

Dynamiczny dostęp do pola domeny wielu aplikacjiDynamic cross-application domain field access

Instrukcja OpCodes.Ldflda języka pośredniego firmy Microsoft (MSIL) zgłasza wyjątek InvalidOperationException, jeśli obiekt zawierający pole, którego adres próbujesz pobrać, nie znajduje się w domenie aplikacji, w której wykonywany jest kod.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. Do adresu pola można uzyskać dostęp tylko z domeny aplikacji, w której znajduje się.The address of a field can only be accessed from the application domain in which it resides.

Zgłaszanie wyjątku InvalidOperationExceptionThrowing an InvalidOperationException exception

Wyjątek InvalidOperationException należy zgłosić tylko wtedy, gdy stan obiektu z jakiegoś powodu nie obsługuje określonego wywołania metody.You should throw an InvalidOperationException exception only when the state of your object for some reason does not support a particular method call. Oznacza to, że wywołanie metody jest prawidłowe w pewnych okolicznościach lub kontekstach, ale jest nieprawidłowe w innych.That is, the method call is valid in some circumstances or contexts, but is invalid in others.

Jeśli błąd wywołania metody jest spowodowany nieprawidłowymi argumentami, a następnie ArgumentException lub jedną z klas pochodnych, ArgumentNullException lub ArgumentOutOfRangeException, należy zamiast tego zostać zgłoszone.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.

Różne informacjeMiscellaneous information

InvalidOperationException używa COR_E_INVALIDOPERATION HRESULT, który ma wartość 0x80131509.InvalidOperationException uses the HRESULT COR_E_INVALIDOPERATION, which has the value 0x80131509.

Aby uzyskać listę początkowych wartości właściwości dla wystąpienia InvalidOperationException, zobacz konstruktory InvalidOperationException.For a list of initial property values for an instance of InvalidOperationException, see the InvalidOperationException constructors.

Konstruktory

InvalidOperationException()

Inicjuje nowe wystąpienie klasy InvalidOperationException.Initializes a new instance of the InvalidOperationException class.

InvalidOperationException(SerializationInfo, StreamingContext)

Inicjuje nowe wystąpienie klasy InvalidOperationException z zserializowanymi danymi.Initializes a new instance of the InvalidOperationException class with serialized data.

InvalidOperationException(String)

Inicjuje nowe wystąpienie klasy InvalidOperationException z określonym komunikatem o błędzie.Initializes a new instance of the InvalidOperationException class with a specified error message.

InvalidOperationException(String, Exception)

Inicjuje nowe wystąpienie klasy InvalidOperationException z określonym komunikatem o błędzie i odwołaniem do wyjątku wewnętrznego, który jest przyczyną tego wyjątku.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.

Właściwości

Data

Pobiera kolekcję par klucz/wartość, które zawierają dodatkowe informacje zdefiniowane przez użytkownika dotyczące wyjątku.Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Odziedziczone po Exception)
HelpLink

Pobiera lub ustawia link do pliku pomocy skojarzonego z tym wyjątkiem.Gets or sets a link to the help file associated with this exception.

(Odziedziczone po Exception)
HResult

Pobiera lub ustawia wartość HRESULT, kodowane wartości liczbowe przypisane do określonego wyjątku.Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Odziedziczone po Exception)
InnerException

Pobiera wystąpienie Exception, które spowodowało wyjątek bieżący.Gets the Exception instance that caused the current exception.

(Odziedziczone po Exception)
Message

Pobiera komunikat, który opisuje bieżący wyjątek.Gets a message that describes the current exception.

(Odziedziczone po Exception)
Source

Pobiera lub ustawia nazwę aplikacji lub obiekt, który powoduje błąd.Gets or sets the name of the application or the object that causes the error.

(Odziedziczone po Exception)
StackTrace

Pobiera ciąg reprezentujący bezpośrednie ramki w stosie wywołań.Gets a string representation of the immediate frames on the call stack.

(Odziedziczone po Exception)
TargetSite

Pobiera metodę, która zgłasza bieżący wyjątek.Gets the method that throws the current exception.

(Odziedziczone po Exception)

Metody

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetBaseException()

Gdy jest zastępowany w klasie pochodnej, zwraca Exception, który jest główną przyczyną jednego lub kilku kolejnych wyjątków.When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(Odziedziczone po Exception)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetObjectData(SerializationInfo, StreamingContext)

Gdy jest zastępowany w klasie pochodnej, ustawia SerializationInfo z informacjami o wyjątku.When overridden in a derived class, sets the SerializationInfo with information about the exception.

(Odziedziczone po Exception)
GetType()

Pobiera typ środowiska uruchomieniowego bieżącego wystąpienia.Gets the runtime type of the current instance.

(Odziedziczone po Exception)
MemberwiseClone()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
ToString()

Tworzy i zwraca reprezentację ciągu bieżącego wyjątku.Creates and returns a string representation of the current exception.

(Odziedziczone po Exception)

Zdarzenia

SerializeObjectState

Występuje, gdy wyjątek jest serializowany w celu utworzenia obiektu stanu wyjątku, który zawiera serializowane dane dotyczące wyjątku.Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Odziedziczone po Exception)

Dotyczy

Zobacz też