InvalidOperationException Třída

Definice

Výjimka, která je vyvolána, když je volání metody pro aktuální stav objektu neplatné.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
Dědičnost
InvalidOperationException
Odvozené
Atributy

Poznámky

InvalidOperationExceptionse používá v případech, kdy selhání při vyvolání metody je způsobeno jinými důvody než neplatnými argumenty.InvalidOperationException is used in cases when the failure to invoke a method is caused by reasons other than invalid arguments. Obvykle je vyvolána, pokud stav objektu nemůže podporovat volání metody.Typically, it is thrown when the state of an object cannot support the method call. Například InvalidOperationException výjimka je vyvolána metodami, jako například:For example, an InvalidOperationException exception is thrown by methods such as:

  • IEnumerator.MoveNextPokud jsou objekty kolekce upraveny po vytvoření čítače výčtu.IEnumerator.MoveNext if objects of a collection are modified after the enumerator is created. Další informace najdete v tématu Změna kolekce při jejich iteraci.For more information, see Changing a collection while iterating it.

  • ResourceSet.GetStringje-li sada prostředků zavřena před provedením volání metody.ResourceSet.GetString if the resource set is closed before the method call is made.

  • XContainer.Add, pokud objekt nebo objekty, které mají být přidány, by způsobily nesprávně strukturovaný dokument XML.XContainer.Add, if the object or objects to be added would result in an incorrectly structured XML document.

  • Metoda, která se pokusí pracovat s uživatelským rozhraním z vlákna, které není hlavním vláknem nebo vláknem uživatelského rozhraní.A method that attempts to manipulate the UI from a thread that is not the main or UI thread.

Důležité

Vzhledem k tomu, že Message výjimkamůžebýtvyvolánavnejrůznějšíchpřípadech,jedůležitépřečístzprávuovýjimcevrácenouvlastností.InvalidOperationExceptionBecause 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.

V této části:In this section:

Některé běžné příčiny výjimek InvalidOperationException Some common causes of InvalidOperationException exceptions
Aktualizace vlákna uživatelského rozhraní z vlákna bez uživatelského rozhraníUpdating a UI thread from a non-UI thread
Změna kolekce při iteraciChanging a collection while iterating it
Řazení pole nebo kolekce, jejichž objekty nelze porovnatSorting an array or collection whose objects cannot be compared
Přetypování hodnoty null> Tnasvůjnadřízenýtyp< Casting a Nullable<T> that is null to its underlying type
Volání metody System. Linq. vyčíslitelné v prázdné kolekciCalling a System.Linq.Enumerable method on an empty collection
Volání výčtu vyčíslitelné. Single nebo vyčíslitelné. SingleOrDefault u sekvence bez jednoho elementuCalling Enumerable.Single or Enumerable.SingleOrDefault on a sequence without one element
Dynamická přístup k poli domény mezi aplikacemiDynamic cross-application domain field access
Vyvolání výjimky InvalidOperationExceptionThrowing an InvalidOperationException exception
Různé informaceMiscellaneous information

Některé běžné příčiny výjimek InvalidOperationExceptionSome common causes of InvalidOperationException exceptions

V následujících částech se dozvíte, jak se v aplikaci InvalidOperationException vykazují některé běžné případy, ve kterých je výjimka vyvolána.The following sections show how some common cases in which in InvalidOperationException exception is thrown in an app. Způsob zpracování problému závisí na konkrétní situaci.How you handle the issue depends on the specific situation. Nejčastěji se ale výsledky výjimky z chyby vývojáře a InvalidOperationException výjimka můžou očekávat a vyhnout se.Most commonly, however, the exception results from developer error, and the InvalidOperationException exception can be anticipated and avoided.

Aktualizace vlákna uživatelského rozhraní z vlákna bez uživatelského rozhraníUpdating a UI thread from a non-UI thread

Pracovní vlákna se často používají k provádění některých prací na pozadí, která zahrnují shromažďování dat, která se mají zobrazit v uživatelském rozhraní aplikace.Often, worker threads are used to perform some background work that involves gathering data to be displayed in an application's user interface. Naopak.However. Většina aplikačních architektur grafického uživatelského rozhraní (GUI) pro .NET Framework, jako je například model Windows Forms a Windows Presentation Foundation (WPF), umožňuje přístup k objektům grafického uživatelského rozhraní pouze z vlákna, které vytváří a spravuje uživatelské rozhraní (hlavní vlákno nebo vlákno uživatelského rozhraní).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). Výjimka InvalidOperationException je vyvolána, když se pokusíte o přístup k prvku uživatelského rozhraní z jiného vlákna než z vlákna uživatelského rozhraní.An InvalidOperationException is thrown when you try to access a UI element from a thread other than the UI thread. Text zprávy o výjimce je zobrazen v následující tabulce.The text of the exception message is shown in the following table.

Typ aplikaceApplication Type MessageMessage
Aplikace WPFWPF app Volající vlákno nemůže získat přístup k tomuto objektu, protože jej vlastní jiné vlákno.The calling thread cannot access this object because a different thread owns it.
Aplikace UWPUWP app Aplikace volala rozhraní, které bylo zařazování pro jiné vlákno.The application called an interface that was marshaled for a different thread.
Aplikace model Windows FormsWindows Forms app Operace mezi vlákny není platná: K ovládacímu prvku "TextBox1" přistupoval z jiného vlákna než z vlákna, ve kterém byl vytvořen.Cross-thread operation not valid: Control 'TextBox1' accessed from a thread other than the thread it was created on.

Architektury uživatelského rozhraní pro .NET Framework implementují model dispečera , který obsahuje metodu pro kontrolu toho, zda je volání člena prvku uživatelského rozhraní prováděno ve VLÁKNĚ uživatelského rozhraní a jiné metody naplánování volání ve VLÁKNĚ uživatelského rozhraní: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:

  • V aplikacích WPF volejte Dispatcher.CheckAccess metodu pro zjištění, zda je metoda spuštěna ve vlákně, které není v uživatelském rozhraní.In WPF apps, call the Dispatcher.CheckAccess method to determine if a method is running on a non-UI thread. Vrátí true , pokud je metoda spuštěna ve vlákně uživatelského rozhraní a false jinak.It returns true if the method is running on the UI thread and false otherwise. Zavolejte jedno z přetížení Dispatcher.Invoke metody pro naplánování volání vlákna uživatelského rozhraní.Call one of the overloads of the Dispatcher.Invoke method to schedule the call on the UI thread.

  • V aplikacích pro UWP zkontrolujte CoreDispatcher.HasThreadAccess vlastnost a určete, jestli je metoda spuštěná na vlákně, které není v uživatelském rozhraní.In UWP apps, check the CoreDispatcher.HasThreadAccess property to determine if a method is running on a non-UI thread. CoreDispatcher.RunAsync Zavolejte metodu pro provedení delegáta, který aktualizuje vlákno uživatelského rozhraní.Call the CoreDispatcher.RunAsync method to execute a delegate that updates the UI thread.

  • V model Windows Forms aplikace použijte Control.InvokeRequired vlastnost k určení, jestli je metoda spuštěná na vlákně, která není v uživatelském rozhraní.In Windows Forms apps, use the Control.InvokeRequired property to determine if a method is running on a non-UI thread. Chcete-li spustit delegáta, který aktualizuje Control.Invoke vlákno uživatelského rozhraní, zavolejte jedno z přetížení metody.Call one of the overloads of the Control.Invoke method to execute a delegate that updates the UI thread.

Následující příklady ilustrují InvalidOperationException výjimku, která je vyvolána při pokusu o aktualizaci prvku uživatelského rozhraní z jiného vlákna než z vlákna, které ho vytvořilo.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ždý příklad vyžaduje, abyste vytvořili dva ovládací prvky:Each example requires that you create two controls:

  • Ovládací prvek textové pole s textBox1názvem.A text box control named textBox1. V model Windows Forms aplikaci byste měli nastavit jeho Multiline vlastnost na. trueIn a Windows Forms app, you should set its Multiline property to true.

  • Ovládací prvek tlačítka s threadExampleBtnnázvem.A button control named threadExampleBtn. Příklad poskytuje obslužnou rutinu ThreadsExampleBtn_Clickpro Click událost tlačítka.The example provides a handler, ThreadsExampleBtn_Click, for the button's Click event.

V každém případě threadExampleBtn_Click obslužná rutina události DoSomeWork volá metodu dvakrát.In each case, the threadExampleBtn_Click event handler calls the DoSomeWork method twice. První volání běží synchronně a je úspěšné.The first call runs synchronously and succeeds. Ale druhé volání, protože se asynchronně spouští ve vlákně fondu vláken, se pokusí aktualizovat uživatelské rozhraní z vlákna, které není v uživatelském rozhraní.But the second call, because it runs asynchronously on a thread pool thread, attempts to update the UI from a non-UI thread. Výsledkem je InvalidOperationException výjimka.This results in a InvalidOperationException exception.

Aplikace WPF a 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

Následující verze DoSomeWork metody eliminuje výjimku v aplikaci 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

Následující verze DoSomeWork metody eliminuje výjimku v aplikaci 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

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

Následující verze DoSomeWork metody eliminuje výjimku v model Windows Forms aplikaci.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

Změna kolekce při iteraciChanging a collection while iterating it

Příkaz v C# příkazu OR For Each v Visual Basic slouží k iteraci členů kolekce a ke čtení nebo úpravě jeho jednotlivých prvků. foreachThe 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. Nedá se ale použít k přidání nebo odebrání položek z kolekce.However, it can't be used to add or remove items from the collection. Ně vyvolá InvalidOperationException výjimku a zobrazí se zpráva, která je podobná "kolekce byla upravena. operace výčtu pravděpodobně nebude spuštěna."Doing this throws an InvalidOperationException exception with a message that is similar to, "Collection was modified; enumeration operation may not execute."

Následující příklad provede iteraci kolekce celých čísel, se pokusí přidat čtverc pro každé celé číslo do kolekce.The following example iterates a collection of integers attempts to add the square of each integer to the collection. Tento příklad vyvolá výjimku InvalidOperationException s prvním voláním List<T>.Add metody.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()

Výjimku můžete eliminovat jedním ze dvou způsobů v závislosti na logice aplikace:You can eliminate the exception in one of two ways, depending on your application logic:

  • Pokud prvky musí být přidány do kolekce při jejich iteraci, můžete je iterovat podle indexu pomocí for příkazu foreach namísto nebo 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. Následující příklad používá příkaz for k přidání čtverce čísel v kolekci do kolekce.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
    

    Všimněte si, že je nutné stanovit počet iterací před iterací kolekce, a to buď pomocí čítače uvnitř smyčky, která ukončí smyčku odpovídajícím způsobem, a to tak Count , že se vrátí zpět, od-1 do 0 nebo jako v příkladu přiřazením čísla. prvků v poli na proměnnou a jejím použitím k vytvoření horní meze smyčky.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. V opačném případě je v případě, že je do kolekce přidán prvek v každé iteraci, výsledkem nekonečné smyčky.Otherwise, if an element is added to the collection on every iteration, an endless loop results.

  • Pokud není nutné přidávat prvky do kolekce při jejich iteraci, můžete uložit prvky, které mají být přidány do dočasné kolekce, kterou přidáte po dokončení iterace kolekce.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. Následující příklad používá tento přístup k přidání čtverce čísel v kolekci do dočasné kolekce a poté pro kombinování kolekcí do jediného objektu 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
    

Řazení pole nebo kolekce, jejichž objekty nelze porovnatSorting an array or collection whose objects cannot be compared

Metody řazení pro obecné účely, jako Array.Sort(Array) je metoda List<T>.Sort() nebo metoda, obvykle vyžadují, aby alespoň jeden objekt, který IComparable<T> má být IComparable seřazen, implementoval rozhraní nebo.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. V takovém případě nemůže být kolekce nebo pole seřazena a metoda vyvolá InvalidOperationException výjimku.If not, the collection or array cannot be sorted, and the method throws an InvalidOperationException exception. Následující příklad definuje Person třídu, ukládá dva Person objekty do obecného List<T> objektu a pokusí se je seřadit.The following example defines a Person class, stores two Person objects in a generic List<T> object, and attempts to sort them. Jak výstup z příkladu ukazuje, volání List<T>.Sort() metody InvalidOperationExceptionvyvolá výjimku.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()

Výjimku můžete eliminovat některým ze tří způsobů:You can eliminate the exception in any of three ways:

  • Pokud lze vlastní typ, který se pokoušíte seřadit (tj. Pokud ovládáte jeho zdrojový kód), můžete jej upravit pro implementaci IComparable<T> IComparable rozhraní nebo.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. K IComparable<T>.CompareTo tomu je nutné implementovat buď CompareTo metodu, nebo.This requires that you implement either the IComparable<T>.CompareTo or the CompareTo method. Přidání implementace rozhraní do existujícího typu není zásadní změna.Adding an interface implementation to an existing type is not a breaking change.

    Následující příklad používá tento přístup k poskytnutí IComparable<T> implementace Person pro třídu.The following example uses this approach to provide an IComparable<T> implementation for the Person class. Stále můžete zavolat metodu obecného řazení kolekce nebo pole a, jak výstup z příkladu ukazuje, kolekce se úspěšně seřadí.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
    
  • Pokud nemůžete změnit zdrojový kód pro typ, který se pokoušíte seřadit, můžete definovat speciální třídu řazení, která implementuje IComparer<T> rozhraní.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. Můžete zavolat přetížení Sort metody, která IComparer<T> obsahuje parametr.You can call an overload of the Sort method that includes an IComparer<T> parameter. Tento přístup je užitečný hlavně v případě, že chcete vytvořit specializované třídy řazení, které mohou řadit objekty na základě více kritérií.This approach is especially useful if you want to develop a specialized sorting class that can sort objects based on multiple criteria.

    Následující příklad používá přístup pomocí vývoje vlastní PersonComparer třídy, která se používá k řazení Person kolekcí.The following example uses the approach by developing a custom PersonComparer class that is used to sort Person collections. Poté předá instanci této třídy List<T>.Sort(IComparer<T>) metodě.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
    
  • Pokud nemůžete změnit zdrojový kód pro typ, který se pokoušíte seřadit, můžete vytvořit Comparison<T> delegáta k provedení řazení.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. Signatura delegáta jeThe delegate signature is

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

    Následující příklad používá přístup definováním PersonComparison metody, která Comparison<T> odpovídá signatuře delegáta.The following example uses the approach by defining a PersonComparison method that matches the Comparison<T> delegate signature. Potom tento delegát List<T>.Sort(Comparison<T>) předá metodě.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
    

Přetypování hodnoty null T >, která má hodnotu null, na svůj nadřízený typ<Casting a Nullable<T> that is null to its underlying type

Pokus o přetypování Nullable<T> hodnoty, která má null InvalidOperationException svůj nadřízený typ, vyvolá výjimku a zobrazí chybovou zprávu "objekt smožnou hodnotou null musí mít hodnotu.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.

Následující příklad vyvolá InvalidOperationException výjimku při pokusu o iteraci pole, které Nullable(Of Integer) obsahuje hodnotu.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()

Zabránění výjimce:To prevent the exception:

Následující příklad vyloučí InvalidOperationException výjimku.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

Volání metody System. Linq. vyčíslitelné v prázdné kolekciCalling a System.Linq.Enumerable method on an empty collection

Metody,Enumerable.Average, ,,Enumerable.Last, ,Enumerable.Singleaprovádějíoperace v sekvenci a vracejí jeden výsledek. Enumerable.Min Enumerable.First Enumerable.Max Enumerable.Aggregate Enumerable.SingleOrDefaultThe 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. Některá přetížení těchto metod vyvolávají InvalidOperationException výjimku, pokud je sekvence prázdná, zatímco jiné přetížení vrátí. nullSome overloads of these methods throw an InvalidOperationException exception when the sequence is empty, while other overloads return null. Enumerable.SingleOrDefault Metoda takéInvalidOperationException vyvolá výjimku, pokud sekvence obsahuje více než jeden prvek.The Enumerable.SingleOrDefault method also throws an InvalidOperationException exception when the sequence contains more than one element.

Poznámka

Většina metod, které vyvolávají InvalidOperationException výjimku, je přetížení.Most of the methods that throw an InvalidOperationException exception are overloads. Ujistěte se, že rozumíte chování přetížení, které jste si zvolili.Be sure that you understand the behavior of the overload that you choose.

V následující tabulce jsou uvedeny zprávy výjimek z InvalidOperationException objektů výjimek vyvolaných voláním některých System.Linq.Enumerable metod.The following table lists the exception messages from the InvalidOperationException exception objects thrown by calls to some System.Linq.Enumerable methods.

MetodaMethod MessageMessage
Aggregate
Average
Last
Max
Min
Sekvence neobsahuje žádné elementy.Sequence contains no elements
First Sekvence neobsahuje žádný vyhovující element.Sequence contains no matching element
Single
SingleOrDefault
Sekvence obsahuje víc než jeden shodný element.Sequence contains more than one matching element

Způsob eliminace nebo zpracování výjimky závisí na předpokladech vaší aplikace a na konkrétní volané metodě.How you eliminate or handle the exception depends on your application's assumptions and on the particular method you call.

Příklady poskytují další podrobnosti.The examples provide additional detail.

Následující příklad používá Enumerable.Average metodu pro výpočet průměru sekvence, jejichž hodnoty jsou větší než 4.The following example uses the Enumerable.Average method to compute the average of a sequence whose values are greater than 4. Vzhledem k tomu, že žádné hodnoty z původního pole nepřekročí 4, nejsou v sekvenci zahrnuty žádné hodnoty a metoda InvalidOperationException vyvolá výjimku.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()

Výjimku lze eliminovat voláním Any metody pro určení, zda sekvence obsahuje nějaké prvky před voláním metody, která sekvenci zpracovává, jak ukazuje následující příklad.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 Metoda vrátí první položku v sekvenci nebo první prvek v sekvenci, která splňuje zadanou podmínku.The Enumerable.First method returns the first item in a sequence or the first element in a sequence that satisfies a specified condition. Pokud je sekvence prázdná, a proto nemá první prvek, vyvolá InvalidOperationException výjimku.If the sequence is empty and therefore does not have a first element, it throws an InvalidOperationException exception.

V následujícím příkladu Enumerable.First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) metoda InvalidOperationException vyvolá výjimku, protože pole dbQueryResults neobsahuje element větší než 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()

Můžete zavolat Enumerable.FirstOrDefault metodu Enumerable.First namísto vrácení zadané nebo výchozí hodnoty.You can call the Enumerable.FirstOrDefault method instead of Enumerable.First to return a specified or default value. Pokud metoda nenalezne první prvek v sekvenci, vrátí výchozí hodnotu pro tento datový typ.If the method does not find a first element in the sequence, it returns the default value for that data type. Výchozí hodnota je null pro typ odkazu, nula pro číselný datový typ a DateTime.MinValue pro DateTime typ.The default value is null for a reference type, zero for a numeric data type, and DateTime.MinValue for the DateTime type.

Poznámka

Interpretace hodnoty vrácené Enumerable.FirstOrDefault metodou je často složitá faktem, že výchozí hodnota typu může být v sekvenci platnou hodnotou.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. V tomto případě voláním Enumerable.Any metody určíte, zda má sekvence platné členy před Enumerable.First voláním metody.In this case, you an call the Enumerable.Any method to determine whether the sequence has valid members before calling the Enumerable.First method.

V následujícím příkladu je volána Enumerable.FirstOrDefault<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) metoda, aby se InvalidOperationException zabránilo výjimce vyvolané v předchozím příkladu.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.

Volání výčtu vyčíslitelné. Single nebo vyčíslitelné. SingleOrDefault u sekvence bez jednoho elementuCalling Enumerable.Single or Enumerable.SingleOrDefault on a sequence without one element

Enumerable.Single Metoda vrátí jediný prvek sekvence nebo jediný prvek sekvence, který splňuje zadanou podmínku.The Enumerable.Single method returns the only element of a sequence, or the only element of a sequence that meets a specified condition. Pokud v sekvenci nejsou žádné prvky, nebo pokud existuje více než jeden prvek, vyvolá InvalidOperationException metoda výjimku.If there are no elements in the sequence, or if there is more than one element , the method throws an InvalidOperationException exception.

Enumerable.SingleOrDefault Metodu lze použít k vrácení výchozí hodnoty namísto vyvolání výjimky, pokud sekvence neobsahuje žádné prvky.You can use the Enumerable.SingleOrDefault method to return a default value instead of throwing an exception when the sequence contains no elements. Metoda však stále InvalidOperationException vyvolá výjimku, pokud sekvence obsahuje více než jeden prvek. Enumerable.SingleOrDefaultHowever, the Enumerable.SingleOrDefault method still throws an InvalidOperationException exception when the sequence contains more than one element.

V následující tabulce jsou uvedeny zprávy o výjimkách InvalidOperationException z objektů výjimek vyvolaných voláním Enumerable.SingleOrDefault Enumerable.Single metody a.The following table lists the exception messages from the InvalidOperationException exception objects thrown by calls to the Enumerable.Single and Enumerable.SingleOrDefault methods.

MetodaMethod MessageMessage
Single Sekvence neobsahuje žádný vyhovující element.Sequence contains no matching element
Single
SingleOrDefault
Sekvence obsahuje víc než jeden shodný element.Sequence contains more than one matching element

V následujícím příkladu volání Enumerable.Single metody InvalidOperationException vyvolá výjimku, protože sekvence nemá element větší než 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()

Následující příklad se pokusí zabránit InvalidOperationException výjimce vyvolané při prázdné sekvenci namísto Enumerable.SingleOrDefault volání metody.The following example attempts to prevent the InvalidOperationException exception thrown when a sequence is empty by instead calling the Enumerable.SingleOrDefault method. Vzhledem k InvalidOperationException tomu, že tato sekvence vrátí více prvků, jejichž hodnota je větší než 2, vyvolá také výjimku.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 Volání metody předpokládá, že sekvence nebo sekvence, které splňují zadaná kritéria, obsahují pouze jeden prvek.Calling the Enumerable.Single method assumes that either a sequence or the sequence that meets specified criteria contains only one element. Enumerable.SingleOrDefaultpředpokládá sekvenci s žádným nebo jedním výsledkem, ale ne další.Enumerable.SingleOrDefault assumes a sequence with zero or one result, but no more. Pokud je tento předpoklad záměrně záměrné a tyto podmínky nejsou splněné, InvalidOperationException je vhodné ho znovu vyvolat nebo zachytit.If this assumption is a deliberate one on your part and these conditions are not met, rethrowing or catching the resulting InvalidOperationException is appropriate. V opačném případě nebo pokud očekáváte, že dojde k neplatným podmínkám s určitou frekvencí, měli Enumerable byste zvážit použití jiné FirstOrDefault metody Where, například nebo.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.

Dynamická přístup k poli domény mezi aplikacemiDynamic cross-application domain field access

Instrukce jazyka MSIL ( InvalidOperationException MicrosoftIntermediateLanguage)vyvolávýjimku,pokudobjektobsahujícípole,jehožadresasepokoušítenačíst,nenívdoméněaplikace,vekteréjeváškódspuštěn.OpCodes.LdfldaThe 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. Adresa pole je k dispozici pouze z domény aplikace, ve které se nachází.The address of a field can only be accessed from the application domain in which it resides.

Vyvolání výjimky InvalidOperationExceptionThrowing an InvalidOperationException exception

InvalidOperationException Výjimku byste měli vyvolat pouze v případě, že stav objektu z nějakého důvodu nepodporuje konkrétní volání metody.You should throw an InvalidOperationException exception only when the state of your object for some reason does not support a particular method call. To znamená, že volání metody je platné v některých případech nebo kontextech, ale je neplatné v jiných.That is, the method call is valid in some circumstances or contexts, but is invalid in others.

Pokud dojde k selhání volání metody z důvodu neplatných argumentů, ArgumentException potom nebo jedné z jeho odvozených ArgumentNullException tříd ArgumentOutOfRangeException, nebo, by mělo být místo toho vyvolána.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ůzné informaceMiscellaneous information

InvalidOperationExceptionpoužívá HRESULT COR_E_INVALIDOPERATION, který má hodnotu 0x80131509.InvalidOperationException uses the HRESULT COR_E_INVALIDOPERATION, which has the value 0x80131509.

Seznam počáteční hodnoty vlastností pro instanci InvalidOperationException, najdete v článku InvalidOperationException konstruktory.For a list of initial property values for an instance of InvalidOperationException, see the InvalidOperationException constructors.

Konstruktory

InvalidOperationException()

Inicializuje novou instanci třídy InvalidOperationException třídy.Initializes a new instance of the InvalidOperationException class.

InvalidOperationException(SerializationInfo, StreamingContext)

Inicializuje novou instanci třídy InvalidOperationException třídy se serializovanými daty.Initializes a new instance of the InvalidOperationException class with serialized data.

InvalidOperationException(String)

Inicializuje novou instanci třídy InvalidOperationException třídy pomocí zadané chybové zprávy.Initializes a new instance of the InvalidOperationException class with a specified error message.

InvalidOperationException(String, Exception)

Inicializuje novou instanci třídy InvalidOperationException třídy pomocí zadané chybové zprávy a odkazu na vnitřní výjimku, která je příčinou této výjimky.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.

Vlastnosti

Data

Získá kolekci párů klíč/hodnota, které poskytují další uživatelsky definované informace o výjimce.Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Zděděno od Exception)
HelpLink

Získá nebo nastaví odkaz na soubor s nápovědě spojený s touto výjimkou.Gets or sets a link to the help file associated with this exception.

(Zděděno od Exception)
HResult

Získá nebo nastaví hodnotu HRESULT, kódované číselné hodnoty, která je přiřazena konkrétní výjimce.Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Zděděno od Exception)
InnerException

Získá instanci Exception, která způsobila aktuální výjimku.Gets the Exception instance that caused the current exception.

(Zděděno od Exception)
Message

Získá zprávu s popisem aktuální výjimky.Gets a message that describes the current exception.

(Zděděno od Exception)
Source

Získá nebo nastaví název aplikace nebo objektu, který způsobuje chybu.Gets or sets the name of the application or the object that causes the error.

(Zděděno od Exception)
StackTrace

Načte řetězcovou reprezentaci okamžitých snímků v zásobníku volání.Gets a string representation of the immediate frames on the call stack.

(Zděděno od Exception)
TargetSite

Získá metodu, která vyvolá aktuální výjimku.Gets the method that throws the current exception.

(Zděděno od Exception)

Metody

Equals(Object)

Určuje, zda se zadaný objekt rovná aktuálnímu objektu.Determines whether the specified object is equal to the current object.

(Zděděno od Object)
GetBaseException()

Při přepsání v odvozené třídě vrátí Exception, který je hlavní příčinou jedné nebo více následných výjimek.When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(Zděděno od Exception)
GetHashCode()

Slouží jako výchozí funkce hash.Serves as the default hash function.

(Zděděno od Object)
GetObjectData(SerializationInfo, StreamingContext)

Při přepsání v odvozené třídě nastaví SerializationInfo s informacemi o výjimce.When overridden in a derived class, sets the SerializationInfo with information about the exception.

(Zděděno od Exception)
GetType()

Získá typ modulu runtime aktuální instance.Gets the runtime type of the current instance.

(Zděděno od Exception)
MemberwiseClone()

Vytvoří kopii aktuálního Objectbez podstruktury.Creates a shallow copy of the current Object.

(Zděděno od Object)
ToString()

Vytvoří a vrátí řetězcovou reprezentaci aktuální výjimky.Creates and returns a string representation of the current exception.

(Zděděno od Exception)

Události

SerializeObjectState

Nastane, pokud je serializovaná výjimka pro vytvoření objektu stavu výjimky, který obsahuje Serializovaná data o výjimce.Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Zděděno od Exception)

Platí pro

Viz také