InvalidOperationException InvalidOperationException InvalidOperationException InvalidOperationException Class

Определение

Исключение, которое выдается при вызове метода, недопустимого для текущего состояния объекта.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
Наследование
InvalidOperationExceptionInvalidOperationExceptionInvalidOperationExceptionInvalidOperationException
Производный
Атрибуты

Комментарии

InvalidOperationException используется в случаях, когда возникает ошибка вызова метода по причинам, отличным от недопустимые аргументы.InvalidOperationException is used in cases when the failure to invoke a method is caused by reasons other than invalid arguments. Как правило она возникает, когда состояние объекта не поддерживает вызов метода.Typically, it is thrown when the state of an object cannot support the method call. Например InvalidOperationException исключение генерируется методами, такими как:For example, an InvalidOperationException exception is thrown by methods such as:

  • IEnumerator.MoveNext Если объекты коллекции изменяются после создания перечислителя.IEnumerator.MoveNext if objects of a collection are modified after the enumerator is created. Дополнительные сведения см. в разделе изменения коллекции во время итерации его.For more information, see Changing a collection while iterating it.

  • ResourceSet.GetString Если набор ресурсов был закрыт до вызов метода.ResourceSet.GetString if the resource set is closed before the method call is made.

  • XContainer.Add, если объект или объекты для добавления приведет к неправильно структурированных XML-документа.XContainer.Add, if the object or objects to be added would result in an incorrectly structured XML document.

  • Метод, который пытается обработать пользовательский Интерфейс из потока, не являющегося главным или потока пользовательского интерфейса.A method that attempts to manipulate the UI from a thread that is not the main or UI thread.

Важно!

Так как InvalidOperationException исключение может выдаваться в самых разнообразных ситуациях, очень важно прочитать сообщение об исключении, возвращенный 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.

СодержаниеIn this section:

Наиболее распространенные причины исключения InvalidOperationException Some common causes of InvalidOperationException exceptions
Обновление потока пользовательского интерфейса из потока без пользовательского интерфейсаUpdating a UI thread from a non-UI thread
Изменение коллекции при последовательном переходе егоChanging a collection while iterating it
Сортировка массива или коллекции нельзя сравнивать, объектыSorting an array or collection whose objects cannot be compared
Приведение Nullable<T> , значение равно null, если к его базовому типу Casting a Nullable<T> that is null to its underlying type
Вызов метода System.Linq.Enumerable для пустой коллекцииCalling a System.Linq.Enumerable method on an empty collection
Вызов Enumerable.Single или Enumerable.SingleOrDefault на последовательность без одного элементаCalling Enumerable.Single or Enumerable.SingleOrDefault on a sequence without one element
Доступ к полям динамического между доменами приложенийDynamic cross-application domain field access
Исключение InvalidOperationExceptionThrowing an InvalidOperationException exception
Прочие сведенияMiscellaneous information

Наиболее распространенные причины исключения InvalidOperationExceptionSome common causes of InvalidOperationException exceptions

В следующих разделах показано, как некоторые наиболее распространенные случаи, в котором в InvalidOperationException исключения в приложении.The following sections show how some common cases in which in InvalidOperationException exception is thrown in an app. Способ решения проблемы зависит от конкретной ситуации.How you handle the issue depends on the specific situation. Наиболее часто, однако исключение приводит к после ошибки разработчика и InvalidOperationException исключение может быть ожидали и избегать.Most commonly, however, the exception results from developer error, and the InvalidOperationException exception can be anticipated and avoided.

Обновление потока пользовательского интерфейса из потока без пользовательского интерфейсаUpdating a UI thread from a non-UI thread

Часто рабочие потоки используются для выполнения некоторых фоновой работы, который включает в себя сбор данных для отображения в пользовательском интерфейсе приложения.Often, worker threads are used to perform some background work that involves gathering data to be displayed in an application's user interface. Тем не менее.However. Большинство платформ приложений GUI (графический интерфейс пользователя) для .NET Framework, такие как Windows Forms и Windows Presentation Foundation (WPF) разрешают доступ к объектам графического интерфейса пользователя только из потока, который создает и управляет пользовательским Интерфейсом (поток Main или пользовательского интерфейса).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 Возникает исключение при попытке получить доступ к элементу пользовательского интерфейса из потока, отличного от потока пользовательского интерфейса.An InvalidOperationException is thrown when you try to access a UI element from a thread other than the UI thread. В следующей таблице показан текст сообщений об исключениях.The text of the exception message is shown in the following table.

Тип приложенияApplication Type СообщениеMessage
Приложения WPFWPF app Вызывающий поток не может доступе к этому объекту, так как им владеет другой поток.The calling thread cannot access this object because a different thread owns it.
Приложения универсальной платформы WindowsUWP app Приложение вызвало интерфейс, который был маршалирован для другого потока.The application called an interface that was marshalled for a different thread.
Приложение Windows FormsWindows Forms app Недопустимая операция в нескольких потоках: Элемент управления 'TextBox1' доступ из потока, отличного от потока, он был создан на.Cross-thread operation not valid: Control 'TextBox1' accessed from a thread other than the thread it was created on.

Платформы пользовательского интерфейса для платформы .NET Framework реализуют dispatcher шаблон, который содержит метод для проверки, выполняется ли вызов члена элемента пользовательского интерфейса в потоке пользовательского интерфейса, а также другие методы для планирования вызова в потоке пользовательского интерфейса: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:

  • В приложениях WPF, вызовите Dispatcher.CheckAccess метод, чтобы определить, выполняется ли метод в потоке без пользовательского интерфейса.In WPF apps, call the Dispatcher.CheckAccess method to determine if a method is running on a non-UI thread. Он возвращает true Если метод выполняется в потоке пользовательского интерфейса и false в противном случае.It returns true if the method is running on the UI thread and false otherwise. Вызовите одну из перегрузок Dispatcher.Invoke метод для планирования вызова в потоке пользовательского интерфейса.Call one of the overloads of the Dispatcher.Invoke method to schedule the call on the UI thread.

  • В приложениях UWP, вызовите CoreDispatcher.HasThreadAccess метод, чтобы определить, выполняется ли метод в потоке без пользовательского интерфейса.In UWP apps, call the CoreDispatcher.HasThreadAccess method to determine if a method is running on a non-UI thread. Вызовите CoreDispatcher.RunAsync методом для выполнения делегата, который обновляет поток пользовательского интерфейса.Call the CoreDispatcher.RunAsync method to execute a delegate that updates the UI thread. Используйте командуUse the

  • В приложениях Windows Forms, использовать Control.InvokeRequired свойства, чтобы определить, выполняется ли метод в потоке без пользовательского интерфейса.In Windows Forms apps, use the Control.InvokeRequired property to determine if a method is running on a non-UI thread. Вызовите одну из перегрузок Control.Invoke методом для выполнения делегата, который обновляет поток пользовательского интерфейса.Call one of the overloads of the Control.Invoke method to execute a delegate that updates the UI thread.

В следующих примерах показаны InvalidOperationException исключение, возникающее при попытке обновить элемент пользовательского интерфейса из потока, в потоке, создавшем его.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. Каждый пример необходимо создать два элемента управления:Each example requires that you create two controls:

  • Элемент управления текстовым полем с именем textBox1.A text box control named textBox1. В приложении Windows Forms, необходимо задать его Multiline свойства true.In a Windows Forms app, you should set its Multiline property to true.

  • Элемент управления кнопки с именем threadExampleBtn.A button control named threadExampleBtn. Пример содержит обработчик, ThreadsExampleBtn_Click, на кнопке Click событий.The example provides a handler, ThreadsExampleBtn_Click, for the button's Click event.

В каждом случае threadExampleBtn_Click вызовов обработчика событий DoSomeWork метод дважды.In each case, the threadExampleBtn_Click event handler calls the DoSomeWork method twice. Первый вызов выполняется синхронно и завершается успешно.The first call runs synchronously and succeeds. Но второй вызов, так как она выполняется асинхронно в потоке пула потоков, пытается обновить интерфейс пользователя из потока без пользовательского интерфейса.But the second call, because it runs asynchronously on a thread pool thread, attempts to update the UI from a non-UI thread. В результате InvalidOperationException исключение.This results in a InvalidOperationException exception.

Приложения WPF и 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

В следующей версии DoSomeWork метод позволяет избежать исключения в приложении 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

В следующей версии DoSomeWork метод позволяет избежать исключения в приложении 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

Приложения 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

В следующей версии DoSomeWork метод позволяет избежать исключения в приложении 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

Изменение коллекции при последовательном переходе егоChanging a collection while iterating it

foreach Инструкции на языке C# или For Each в Visual Basic используется для итерации элементов коллекции, а также считывать или изменять его отдельные элементы.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. Тем не менее он не может использоваться для добавления или удаления элементов из коллекции.However, it can't be used to add or remove items from the collection. В этом случае создается это InvalidOperationException исключение с сообщением об ошибке, "коллекция была изменена; Невозможно выполнить операцию перечисления. "Doing this throws an InvalidOperationException exception with a message that is similar to, "Collection was modified; enumeration operation may not execute."

Приведенный ниже пример проходит попыток коллекцию целых чисел, добавляемый в коллекцию квадрат каждого целого числа.The following example iterates a collection of integers attempts to add the square of each integer to the collection. В примере создается исключение InvalidOperationException с первого вызова 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()

В зависимости от логики приложения, то можно исключить исключение в одном из двух способов:You can eliminate the exception in one of two ways, depending on your application logic:

  • Элементы должны быть добавлены в коллекцию при последовательном переходе его, вы можете переключаться с помощью индекса for инструкции, а не foreach или 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. В следующем примере используется оператор добавить квадрат чисел из коллекции в коллекцию.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
    

    Обратите внимание, что число итераций, которые необходимо установить до начала итерации коллекции, либо с помощью счетчика в цикле для выхода из цикла соответствующим образом, путем итерации назад, из Count - 1 к 0, или, как пример, назначив номер элементов в массиве переменной и его использованию для установления верхняя граница цикла.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. В противном случае если элемент добавляется в коллекцию для каждой итерации, результаты бесконечного цикла.Otherwise, if an element is added to the collection on every iteration, an endless loop results.

  • Если нет необходимости добавлять элементы в коллекцию при последовательном переходе его, вы можете хранить элементов для добавления в временную коллекцию, можно добавить после завершения итерации коллекции.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. В следующем примере используется этот подход для добавления квадрат чисел из в коллекции временную коллекцию, а затем объединить коллекций в один объект массива.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
    

Сортировка массива или коллекции нельзя сравнивать, объектыSorting an array or collection whose objects cannot be compared

Общего назначения, методы, такие как сортировки Array.Sort(Array) метод или List<T>.Sort() метод, обычно требуется реализовать, по крайней мере один из объектов должны быть отсортированы IComparable<T> или 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. Если нет, коллекции или массива нельзя отсортировать, и метод вызывает InvalidOperationException исключение.If not, the collection or array cannot be sorted, and the method throws an InvalidOperationException exception. В следующем примере определяется Person класса хранилищ двумя Person объекты в универсальной List<T> объекта и пытается их сортировки.The following example defines a Person class, stores two Person objects in a generic List<T> object, and attempts to sort them. Как видно в результатах показано в примере, вызов List<T>.Sort() вызывает метод 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()

Можно устранить исключение в любом из трех способов:You can eliminate the exception in any of three ways:

  • Если у вас может есть тип, который вы пытаетесь сортировки (то есть, если вы его исходный код для элементов управления), можно изменить его, чтобы реализовать IComparable<T> или 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. Для этого требуется реализуют либо IComparable<T>.CompareTo или CompareTo метод.This requires that you implement either the IComparable<T>.CompareTo or the CompareTo method. Добавление в существующий тип в реализации интерфейса не является критическим изменением.Adding an interface implementation to an existing type is not a breaking change.

    В следующем примере используется этот подход для предоставления IComparable<T> внедрению Person класса.The following example uses this approach to provide an IComparable<T> implementation for the Person class. Можно по-прежнему вызывать коллекции или массива общий способ сортировки, и, как видно из примера, коллекции сортирует успешно.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
    
  • Если не удается изменить исходный код для типа, который вы пытаетесь сортировки, можно определить специальные сортировки класс, реализующий 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. Можно вызвать перегрузку Sort метод, который включает в себя IComparer<T> параметра.You can call an overload of the Sort method that includes an IComparer<T> parameter. Этот подход особенно полезен в тех случаях, если вы хотите разрабатывать специализированный класс сортировки, можно сортировать объекты, на основе нескольких критериев.This approach is especially useful if you want to develop a specialized sorting class that can sort objects based on multiple criteria.

    В следующем примере используется метод путем разработки пользовательского PersonComparer класс, используемый для сортировки Person коллекций.The following example uses the approach by developing a custom PersonComparer class that is used to sort Person collections. Затем он передает экземпляр этого класса 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
    
  • Если не удается изменить исходный код для типа необходимо отсортировать, можно создать Comparison<T> делегат для выполнения сортировки.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. Сигнатура делегатаThe delegate signature is

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

    В следующем примере используется подход, определив PersonComparison метод, который соответствует Comparison<T> сигнатуре делегата.The following example uses the approach by defining a PersonComparison method that matches the Comparison<T> delegate signature. Затем он передает этот делегат для 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
    

Приведение Nullable<T >, значение равно null, если к его базовому типуCasting a Nullable<T> that is null to its underlying type

Попытка приведения Nullable<T> значение, которое является null к его базовому типу вызывает InvalidOperationException исключения и отображает сообщение об ошибке "объектов со значениями NULL должен иметь значение.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.

В следующем примере возникает исключение InvalidOperationException исключение при попытке итерация массива, которая включает 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()

Чтобы предотвратить это исключение:To prevent the exception:

  • Используйте Nullable<T>.HasValue свойство, чтобы выбрать только те элементы, которые не являются null.Use the Nullable<T>.HasValue property to select only those elements that are not null.

  • Вызовите один из Nullable<T>.GetValueOrDefault перегрузок, чтобы предоставить значение по умолчанию для null значение.Call one of the Nullable<T>.GetValueOrDefault overloads to provide a default value for a null value.

В следующем примере выполняются оба во избежание 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

Вызов метода System.Linq.Enumerable для пустой коллекцииCalling a System.Linq.Enumerable method on an empty collection

Enumerable.Aggregate, Enumerable.Average, Enumerable.First, Enumerable.Last, Enumerable.Max, Enumerable.Min, Enumerable.Single, И Enumerable.SingleOrDefault методы выполняют операции над последовательностью и возвращают один результат.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. Некоторые перегрузки этих методов throw InvalidOperationException исключение, если последовательность пуста, пока другие перегрузки возвращают null.Some overloads of these methods throw an InvalidOperationException exception when the sequence is empty, while other overloads return null. Enumerable.SingleOrDefault Метод также выдает InvalidOperationException исключение, если последовательность содержит более одного элемента.The Enumerable.SingleOrDefault method also throws an InvalidOperationException exception when the sequence contains more than one element.

Примечание

Большинство методов, которые выдают InvalidOperationException исключения являются перегрузками.Most of the methods that throw an InvalidOperationException exception are overloads. Убедитесь, что вы понимаете поведение выбираемой перегрузки.Be sure that you understand the behavior of the overload that you choose.

В следующей таблице перечислены сообщения об исключениях из InvalidOperationException объектов исключений, вызванных вызовы некоторых System.Linq.Enumerable методы.The following table lists the exception messages from the InvalidOperationException exception objects thrown by calls to some System.Linq.Enumerable methods.

МетодMethod СообщениеMessage
Aggregate
Average
Last
Max
Min
Последовательность не содержит элементовSequence contains no elements
First Последовательность не содержит соответствующий элементSequence contains no matching element
Single
SingleOrDefault
Последовательность содержит более одного соответствующего элементаSequence contains more than one matching element

Как исключить или обработать исключение зависит от приложения предположения и конкретного метода, который вы вызываете.How you eliminate or handle the exception depends on your application's assumptions and on the particular method you call.

  • Когда вы намеренно вызовите один из этих методов без проверки для пустой последовательности, предполагается, что последовательность не пуста, и что пустая последовательностью не ожидается.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 this case, catching or rethrowing the exception is appropriate .

  • В случае непреднамеренного невыполнение проверяемый для пустой последовательности вы можете вызвать один из перегруженных версий Enumerable.Any перегрузки, чтобы определить, содержит ли последовательность какие-либо элементы.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.

    Совет

    Вызов Enumerable.Any<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) метод перед созданием последовательности может повысить производительность, если данные для обработки может содержать большое количество элементов или если операция, создающая последовательность дорого.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.

  • Если вызван метод, такие как Enumerable.First, Enumerable.Last, или Enumerable.Single, можно заменить альтернативного метода, такие как Enumerable.FirstOrDefault, Enumerable.LastOrDefault, или Enumerable.SingleOrDefault, возвращает значение по умолчанию, а не членом последовательности.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.

Примеры приведены дополнительные сведения.The examples provide additional detail.

В следующем примере используется Enumerable.Average метод, чтобы подсчитывать среднее для последовательности, значения которых больше 4.The following example uses the Enumerable.Average method to compute the average of a sequence whose values are greater than 4. Так как значения из исходного массива не должна превышать 4, значения не включаются в последовательности и вызывает метод 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()

Исключение, можно устранить путем вызова Any метод, чтобы определить, содержит ли последовательность какие-либо элементы, до вызова метода, который обрабатывает последовательности, как показано в следующем примере.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.

Enumerable.First Метод возвращает первый элемент в последовательности или первый элемент в последовательности, удовлетворяющий указанному условию.The Enumerable.First method returns the first item in a sequence or the first element in a sequence that satisfies a specified condition. Если последовательность пуста и не имеющая первым элементом, он выдает InvalidOperationException исключение.If the sequence is empty and therefore does not have a first element, it throws an InvalidOperationException exception.

В следующем примере Enumerable.First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) вызывает метод InvalidOperationException исключения так, как dbQueryResults массив не содержит ни одного элемента больше 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()

Можно вызвать Enumerable.FirstOrDefault вместо метода Enumerable.First для возвращения заданного значения или значение по умолчанию.You can call the Enumerable.FirstOrDefault method instead of Enumerable.First to return a specified or default value. Если метод не находит первый элемент в последовательности, возвращается значение по умолчанию для этого типа данных.If the method does not find a first element in the sequence, it returns the default value for that data type. Значение по умолчанию — null для ссылочного типа, нуль для числовой тип данных, и DateTime.MinValue для DateTime типа.The default value is null for a reference type, zero for a numeric data type, and DateTime.MinValue for the DateTime type.

Примечание

Интерпретация значения, возвращенного Enumerable.FirstOrDefault метод часто усложняется тем фактом, что значение по умолчанию типа может быть допустимое значение в последовательности.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. В этом случае вы вызов Enumerable.Any метод, чтобы определить, имеет ли последовательность допустимых членов, перед вызовом 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.

В следующем примере вызывается Enumerable.FirstOrDefault<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) метод, чтобы запретить InvalidOperationException исключение, возникшее в предыдущем примере.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.

Вызов Enumerable.Single или Enumerable.SingleOrDefault на последовательность без одного элементаCalling Enumerable.Single or Enumerable.SingleOrDefault on a sequence without one element

Enumerable.Single Метод возвращает единственный элемент последовательности или единственный элемент последовательности, который удовлетворяет заданному условию.The Enumerable.Single method returns the only element of a sequence, or the only element of a sequence that meets a specified condition. Если в последовательности нет элементов, или если имеется более одного элемента, метод вызывает InvalidOperationException исключение.If there are no elements in the sequence, or if there is more than one element , the method throws an InvalidOperationException exception.

Можно использовать Enumerable.SingleOrDefault метод вернет значение по умолчанию, а не вызывает исключение, если последовательность не содержит элементов.You can use the Enumerable.SingleOrDefault method to return a default value instead of throwing an exception when the sequence contains no elements. Тем не менее Enumerable.SingleOrDefault метод по-прежнему вызывает InvalidOperationException исключение, если последовательность содержит более одного элемента.However, the Enumerable.SingleOrDefault method still throws an InvalidOperationException exception when the sequence contains more than one element.

В следующей таблице перечислены сообщения об исключениях из InvalidOperationException объектов исключений, вызванных вызовы Enumerable.Single и 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.

МетодMethod СообщениеMessage
Single Последовательность не содержит соответствующий элементSequence contains no matching element
Single
SingleOrDefault
Последовательность содержит более одного соответствующего элементаSequence contains more than one matching element

В следующем примере вызов Enumerable.Single вызывает метод InvalidOperationException исключение поскольку последовательность не имеет элемент больше 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()

В следующем примере предпринимается во избежание InvalidOperationException исключение, возникающее, когда последовательность пуста, вместо вызова Enumerable.SingleOrDefault метод.The following example attempts to prevent the InvalidOperationException exception thrown when a sequence is empty by instead calling the Enumerable.SingleOrDefault method. Тем не менее, поскольку эта последовательность возвращает несколько элементов, значение которого больше 2, он также создает исключение 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()

Вызов Enumerable.Single метод предполагает, что последовательности или последовательности, которая отвечает указанным критериям содержит только один элемент.Calling the Enumerable.Single method assumes that either a sequence or the sequence that meets specified criteria contains only one element. Enumerable.SingleOrDefault предполагается, что последовательность с помощью ноль или один результат, но не более.Enumerable.SingleOrDefault assumes a sequence with zero or one result, but no more. Если это предположение является намеренным со стороны пользователя, и эти условия не выполняются, повторное создание или перехват итоговый InvalidOperationException подходит.If this assumption is a deliberate one on your part and these conditions are not met, rethrowing or catching the resulting InvalidOperationException is appropriate. В противном случае или если предполагается, что недопустимые условия будут происходить с некоторой частотой, можно использовать другой Enumerable метод, такой как FirstOrDefault или 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.

Доступ к полям динамического между доменами приложенийDynamic cross-application domain field access

OpCodes.Ldflda Microsoft, выдает инструкции промежуточного языка (MSIL) InvalidOperationException исключение, если объект, содержащий поле, адрес которого вы пытаетесь получить находится за пределами домена приложения, в котором выполняется код.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. Адрес поля может осуществляться только из домена приложения, в котором он находится.The address of a field can only be accessed from the application domain in which it resides.

Исключение InvalidOperationExceptionThrowing an InvalidOperationException exception

Необходимо вызвать исключение InvalidOperationException только в том случае, если состояние объекта для какой-либо причине не поддерживает вызов конкретного метода.You should throw an InvalidOperationException exception only when the state of your object for some reason does not support a particular method call. То есть вызов метода является допустимым в некоторых обстоятельствах или контекстов, но является недопустимым в других.That is, the method call is valid in some circumstances or contexts, but is invalid in others.

В случае сбоя вызова метода из-за недопустимых аргументов, затем ArgumentException или одного из его производных классов ArgumentNullException или ArgumentOutOfRangeException, должны быть выданы.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.

Прочие сведенияMiscellaneous information

InvalidOperationException использует значением COR_E_INVALIDOPERATION HRESULT, которое имеет значение 0x80131509.InvalidOperationException uses the HRESULT COR_E_INVALIDOPERATION, which has the value 0x80131509.

Список начальных значений свойств для экземпляра InvalidOperationException, см. в разделе InvalidOperationException конструкторы.For a list of initial property values for an instance of InvalidOperationException, see the InvalidOperationException constructors.

Конструкторы

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

Инициализирует новый экземпляр класса InvalidOperationException.Initializes a new instance of the InvalidOperationException class.

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

Инициализирует новый экземпляр класса InvalidOperationException с сериализованными данными.Initializes a new instance of the InvalidOperationException class with serialized data.

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

Инициализирует новый экземпляр класса InvalidOperationException с указанным сообщением об ошибке.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)

Инициализирует новый экземпляр класса InvalidOperationException указанным сообщением об ошибке и ссылкой на внутреннее исключение, вызвавшее данное исключение.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.

Свойства

Data Data Data Data

Возвращает коллекцию пар "ключ-значение", предоставляющих дополнительную заданную пользователем информацию об исключении.Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Inherited from Exception)
HelpLink HelpLink HelpLink HelpLink

Возвращает или задает ссылку на файл справки, связанный с этим исключением.Gets or sets a link to the help file associated with this exception.

(Inherited from Exception)
HResult HResult HResult HResult

Возвращает или задает HRESULT — кодированное числовое значение, присвоенное определенному исключению.Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Inherited from Exception)
InnerException InnerException InnerException InnerException

Возвращает экземпляр объекта Exception, который вызвал текущее исключение.Gets the Exception instance that caused the current exception.

(Inherited from Exception)
Message Message Message Message

Возвращает сообщение, описывающее текущее исключение.Gets a message that describes the current exception.

(Inherited from Exception)
Source Source Source Source

Возвращает или задает имя приложения или объекта, вызывавшего ошибку.Gets or sets the name of the application or the object that causes the error.

(Inherited from Exception)
StackTrace StackTrace StackTrace StackTrace

Получает строковое представление непосредственных кадров в стеке вызова.Gets a string representation of the immediate frames on the call stack.

(Inherited from Exception)
TargetSite TargetSite TargetSite TargetSite

Возвращает метод, создавший текущее исключение.Gets the method that throws the current exception.

(Inherited from Exception)

Методы

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

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

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

При переопределении в производном классе возвращает исключение Exception, которое является корневой причиной одного или нескольких последующих исключений.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()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

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

При переопределении в производном классе задает сведения об исключении для SerializationInfo.When overridden in a derived class, sets the SerializationInfo with information about the exception.

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

Возвращает тип текущего экземпляра в среде выполнения.Gets the runtime type of the current instance.

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

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

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

Создает и возвращает строковое представление текущего исключения.Creates and returns a string representation of the current exception.

(Inherited from Exception)

События

SerializeObjectState SerializeObjectState SerializeObjectState SerializeObjectState

Возникает, когда исключение сериализовано для создания объекта состояния исключения, содержащего сериализованные данные об исключении.Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Inherited from Exception)

Применяется к

Дополнительно