InvalidOperationException Sınıf

Tanım

Nesnenin geçerli durumu için bir yöntem çağrısı geçersiz olduğunda oluşturulan özel durum.The exception that is thrown when a method call is invalid for the object's current state.

public ref class InvalidOperationException : Exception
public ref class InvalidOperationException : SystemException
public class InvalidOperationException : Exception
public class InvalidOperationException : SystemException
[System.Serializable]
public class InvalidOperationException : SystemException
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class InvalidOperationException : SystemException
type InvalidOperationException = class
    inherit Exception
type InvalidOperationException = class
    inherit SystemException
[<System.Serializable>]
type InvalidOperationException = class
    inherit SystemException
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type InvalidOperationException = class
    inherit SystemException
Public Class InvalidOperationException
Inherits Exception
Public Class InvalidOperationException
Inherits SystemException
Devralma
InvalidOperationException
Devralma
InvalidOperationException
Türetilmiş
Öznitelikler

Açıklamalar

InvalidOperationException bir yöntemi çağırma hatası geçersiz bağımsız değişkenlerden kaynaklanan nedenlerden kaynaklanabilir.InvalidOperationException is used in cases when the failure to invoke a method is caused by reasons other than invalid arguments. Genellikle, bir nesnenin durumu yöntem çağrısını destekleyebilirse oluşturulur.Typically, it is thrown when the state of an object cannot support the method call. Örneğin, InvalidOperationException Şu yöntemlerle bir özel durum oluşur:For example, an InvalidOperationException exception is thrown by methods such as:

Önemli

InvalidOperationExceptionÖzel durum çok çeşitli koşullarda gerçekleştirilemediğinden, özelliği tarafından döndürülen özel durum iletisini okumak önemlidir 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.

Bu bölümdeki konular:In this section:

InvalidOperationException özel durumlarının bazı yaygın nedenleri Some common causes of InvalidOperationException exceptions
UI olmayan bir iş parçacığından kullanıcı arabirimi iş parçacığını güncelleştirmeUpdating a UI thread from a non-UI thread
Bir koleksiyonu yineleme sırasında değiştirmeChanging a collection while iterating it
Nesneleri karşılaştırılamadığından bir diziyi veya koleksiyonu sıralamaSorting an array or collection whose objects cannot be compared
< > Temel alınan türüne null olan Nullable bir T atama Casting a Nullable<T> that is null to its underlying type
Boş bir koleksiyonda System. LINQ. sıralanabilir yöntemi çağırmaCalling a System.Linq.Enumerable method on an empty collection
Tek bir öğe olmadan bir dizide sıralanabilir. Single veya sıralanabilir. SingleOrDefault çağrılıyorCalling Enumerable.Single or Enumerable.SingleOrDefault on a sequence without one element
Dinamik çapraz uygulama etki alanı erişimiDynamic cross-application domain field access
InvalidOperationException özel durumu oluşturuluyorThrowing an InvalidOperationException exception
Çeşitli bilgilerMiscellaneous information

InvalidOperationException özel durumlarının bazı yaygın nedenleriSome common causes of InvalidOperationException exceptions

Aşağıdaki bölümlerde, InvalidOperationException bir uygulamada özel durum içinde oluşturulan bazı ortak durumlar gösterilmektedir.The following sections show how some common cases in which in InvalidOperationException exception is thrown in an app. Sorunu nasıl işleyeceğinizi, belirli bir duruma bağlıdır.How you handle the issue depends on the specific situation. Ancak yaygın olarak, özel durum geliştirici hatasından kaynaklanır ve InvalidOperationException özel durum beklenen ve kaçınılabilir.Most commonly, however, the exception results from developer error, and the InvalidOperationException exception can be anticipated and avoided.

UI olmayan bir iş parçacığından kullanıcı arabirimi iş parçacığını güncelleştirmeUpdating a UI thread from a non-UI thread

Genellikle, çalışan iş parçacıkları bir uygulamanın kullanıcı arabiriminde gösterilecek veri toplamayı içeren bazı arka plan işleri gerçekleştirmek için kullanılır.Often, worker threads are used to perform some background work that involves gathering data to be displayed in an application's user interface. Ancak.However. .NET Framework için Windows Forms ve Windows Presentation Foundation (WPF) gibi çoğu GUI (grafik kullanıcı arabirimi) uygulama çerçeveleri yalnızca, Kullanıcı arabirimini (ana veya Kullanıcı arabirimi iş parçacığı) oluşturan ve yöneten iş parçacığından yalnızca GUI nesnelerine erişmenizi sağlar.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). UI InvalidOperationException iş parçacığı dışında bir iş parçacığından BIR UI öğesine erişmeye çalıştığınızda bir oluşturulur.An InvalidOperationException is thrown when you try to access a UI element from a thread other than the UI thread. Özel durum iletisinin metni aşağıdaki tabloda gösterilmiştir.The text of the exception message is shown in the following table.

Uygulama TürüApplication Type İletiMessage
WPF uygulamasıWPF app Çağıran iş parçacığı, kendisine ait farklı bir iş parçacığı olduğundan bu nesneye erişemez.The calling thread cannot access this object because a different thread owns it.
UWP uygulamasıUWP app Uygulama, farklı bir iş parçacığı için sıralanmış bir arabirim çağırdı.The application called an interface that was marshaled for a different thread.
Windows Forms uygulamasıWindows Forms app Çapraz iş parçacığı işlemi geçerli değil: ' TextBox1 ' denetimine oluşturulduğu iş parçacığından farklı bir iş parçacığından erişildi.Cross-thread operation not valid: Control 'TextBox1' accessed from a thread other than the thread it was created on.

.NET Framework için Kullanıcı arabirimi çerçeveleri UI iş parçacığında bir UI öğesinin üyesine yönelik çağrının yürütülüp yürütülmediğini ve Kullanıcı arabirimi iş parçacığında çağrıyı zamanlamak için diğer yöntemleri içeren bir dağıtıcı kalıbı uygular: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 uygulamalarında, Dispatcher.CheckAccess bir yöntemin Kullanıcı arabirimi olmayan iş parçacığında çalışıp çalışmadığını belirleme yöntemini çağırın.In WPF apps, call the Dispatcher.CheckAccess method to determine if a method is running on a non-UI thread. Yöntem, true Kullanıcı arabirimi iş parçacığında çalışıyorsa ve false Aksi takdirde döndürür.It returns true if the method is running on the UI thread and false otherwise. Dispatcher.InvokeKullanıcı arabirimi iş parçacığında çağrıyı zamanlamak için yönteminin aşırı yüklemelerinin birini çağırın.Call one of the overloads of the Dispatcher.Invoke method to schedule the call on the UI thread.

  • UWP uygulamalarında, CoreDispatcher.HasThreadAccess bir yöntemin Kullanıcı arabirimi olmayan iş parçacığında çalışıp çalışmadığını öğrenmek için özelliği denetleyin.In UWP apps, check the CoreDispatcher.HasThreadAccess property to determine if a method is running on a non-UI thread. CoreDispatcher.RunAsyncUI iş parçacığını güncelleştiren bir temsilciyi yürütmek için yöntemini çağırın.Call the CoreDispatcher.RunAsync method to execute a delegate that updates the UI thread.

  • Windows Forms uygulamalarda, Control.InvokeRequired bir yöntemin Kullanıcı arabirimi olmayan iş parçacığında çalışıp çalışmadığını anlamak için özelliğini kullanın.In Windows Forms apps, use the Control.InvokeRequired property to determine if a method is running on a non-UI thread. Control.InvokeUI iş parçacığını güncelleştiren bir temsilciyi yürütmek için yönteminin aşırı yüklemelerinin birini çağırın.Call one of the overloads of the Control.Invoke method to execute a delegate that updates the UI thread.

Aşağıdaki örneklerde, InvalidOperationException BIR UI öğesini oluşturan iş parçacığından farklı bir iş parçacığından güncelleştirmeye çalıştığınızda oluşturulan özel durum gösterilmektedir.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. Her örnek iki denetim oluşturmanızı gerektirir:Each example requires that you create two controls:

  • Adlı metin kutusu denetimi textBox1 .A text box control named textBox1. Windows Forms uygulamasında Multiline özelliğini olarak ayarlamanız gerekir true .In a Windows Forms app, you should set its Multiline property to true.

  • Adlı bir düğme denetimi threadExampleBtn .A button control named threadExampleBtn. Örnek, ThreadsExampleBtn_Click düğme olayı için bir işleyici sağlar Click .The example provides a handler, ThreadsExampleBtn_Click, for the button's Click event.

Her durumda, threadExampleBtn_Click olay işleyicisi DoSomeWork yöntemi iki kez çağırır.In each case, the threadExampleBtn_Click event handler calls the DoSomeWork method twice. İlk çağrı zaman uyumlu olarak çalışır ve başarılı olur.The first call runs synchronously and succeeds. Ancak ikinci çağrı, iş parçacığı havuzu iş parçacığı üzerinde zaman uyumsuz olarak çalıştığından, Kullanıcı arabirimini Kullanıcı arabirimi olmayan bir iş parçacığından güncelleştirmeye çalışır.But the second call, because it runs asynchronously on a thread pool thread, attempts to update the UI from a non-UI thread. Bunun sonucunda InvalidOperationException özel durum oluşur.This results in a InvalidOperationException exception.

WPF ve UWP uygulamalarıWPF 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

Yönteminin aşağıdaki sürümü DoSomeWork BIR WPF uygulamasında özel durumu ortadan kaldırır.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

Yönteminin aşağıdaki sürümü DoSomeWork BIR UWP uygulamasındaki özel durumu ortadan kaldırır.The following version of the DoSomeWork method eliminates the exception in a UWP app.

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

    // Report completion.
    bool uiAccess = textBox1.Dispatcher.HasThreadAccess;
    String msg = String.Format("Some work completed in {0} ms. on {1}UI thread\n",
                               milliseconds, uiAccess ? String.Empty : "non-");
    if (uiAccess)
        textBox1.Text += msg;
    else
        await textBox1.Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () => { textBox1.Text += msg; });
}
Private Async Sub DoSomeWork(milliseconds As Integer)
    ' Simulate work.
    Await Task.Delay(milliseconds)

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

Windows Forms uygulamalarıWindows 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

Yönteminin aşağıdaki sürümü DoSomeWork bir Windows Forms uygulamasındaki özel durumu ortadan kaldırır.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

Bir koleksiyonu yineleme sırasında değiştirmeChanging a collection while iterating it

foreachC# veya For Each Visual Basic içindeki ifade, bir koleksiyonun üyelerini yinelemek ve bireysel öğelerini okumak ya da değiştirmek için kullanılır.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. Ancak, koleksiyona öğe eklemek veya koleksiyondan öğe kaldırmak için kullanılamaz.However, it can't be used to add or remove items from the collection. Bunun yapılması InvalidOperationException Şuna benzer bir ileti ile özel durum oluşturur, "koleksiyon değiştirildi; numaralandırma işlemi yürütülemeyebilir."Doing this throws an InvalidOperationException exception with a message that is similar to, "Collection was modified; enumeration operation may not execute."

Aşağıdaki örnek, her bir tamsayının karesini koleksiyona eklemek için bir tamsayılar koleksiyonunu yineler.The following example iterates a collection of integers attempts to add the square of each integer to the collection. Örnek, InvalidOperationException yöntemine ilk çağrı ile bir oluşturur 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()

Uygulama mantığınıza bağlı olarak, özel durumu iki şekilde ortadan kaldırabilirsiniz:You can eliminate the exception in one of two ways, depending on your application logic:

  • Yinelenirken öğelerin koleksiyona eklenmesi gerekiyorsa, for veya yerine ifadesini kullanarak dizini yineleyebilirsiniz 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. Aşağıdaki örnek, koleksiyon içindeki sayıların karesini koleksiyona eklemek için for ifadesini kullanır.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
    

    Döngüyü tekrardan,-1 ' den 0 ' a itererek Count ya da örneğin, dizideki öğelerin sayısını bir değişkene atayarak ve döngünün üst sınırını oluşturmak için kullanarak bir sayacı kullanarak yinelemeden önce yineleme sayısını oluşturmanız gerektiğine göz önünde aklınızda olursunuz.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. Aksi halde, her yinelemede koleksiyona bir öğe eklenirse, sonsuz bir döngü oluşur.Otherwise, if an element is added to the collection on every iteration, an endless loop results.

  • Yineleme sırasında koleksiyona öğe eklemek gerekli değilse, koleksiyonu yinelediğiniz sırada eklediğiniz geçici bir koleksiyonda eklenecek öğeleri saklayabilirsiniz ().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. Aşağıdaki örnek, bir koleksiyondaki sayıların karesini geçici bir koleksiyona eklemek ve ardından koleksiyonları tek bir dizi nesnesi halinde birleştirmek için bu yaklaşımı kullanır.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
    

Nesneleri karşılaştırılamadığından bir diziyi veya koleksiyonu sıralamaSorting an array or collection whose objects cannot be compared

Yöntem veya yöntem gibi genel amaçlı sıralama yöntemleri, Array.Sort(Array) List<T>.Sort() genellikle sıralanacak nesnelerden en az birinin IComparable<T> veya arabirimin uygulanmasını gerektirir 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. Aksi takdirde, koleksiyon veya dizi sıralanamaz ve yöntem bir InvalidOperationException özel durum oluşturur.If not, the collection or array cannot be sorted, and the method throws an InvalidOperationException exception. Aşağıdaki örnek, bir Person sınıfı tanımlar, genel bir Person nesnede iki nesneyi depolar List<T> ve bunları sıralamayı dener.The following example defines a Person class, stores two Person objects in a generic List<T> object, and attempts to sort them. Örneğin çıkışının gösterdiği gibi yöntemine yapılan çağrı List<T>.Sort() bir oluşturur 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()

Özel durumu üç şekilde ortadan kaldırabilirsiniz:You can eliminate the exception in any of three ways:

  • Sıralamayı denediğiniz türe sahip olabilirsiniz (yani, kaynak kodunu denetlarsanız), veya arabirimini uygulayacak şekilde değiştirebilirsiniz 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. Bunun için ya da yöntemini uygulamanız gerekir IComparable<T>.CompareTo CompareTo .This requires that you implement either the IComparable<T>.CompareTo or the CompareTo method. Varolan bir türe arabirim uygulamasının eklenmesi, bir son değişiklik değildir.Adding an interface implementation to an existing type is not a breaking change.

    Aşağıdaki örnek, sınıfına bir uygulama sağlamak için bu yaklaşımı kullanır IComparable<T> Person .The following example uses this approach to provide an IComparable<T> implementation for the Person class. Koleksiyon veya dizinin Genel sıralama yöntemini çağırabilirsiniz ve örneğin çıkışının gösterdiği gibi, koleksiyon başarıyla sıralanır.You can still call the collection or array's general sorting method and, as the output from the example shows, the collection sorts successfully.

    using System;
    using System.Collections.Generic;
    
    public class Person : IComparable<Person>
    {
       public Person(String fName, String lName)
       {
          FirstName = fName;
          LastName = lName;
       }
    
       public String FirstName { get; set; }
       public String LastName { get; set; }
    
       public int CompareTo(Person other)
       {
          return String.Format("{0} {1}", LastName, FirstName).
                 CompareTo(String.Format("{0} {1}", other.LastName, other.FirstName));
       }
    }
    
    public class Example
    {
       public static void Main()
       {
          var people = new List<Person>();
    
          people.Add(new Person("John", "Doe"));
          people.Add(new Person("Jane", "Doe"));
          people.Sort();
          foreach (var person in people)
             Console.WriteLine("{0} {1}", person.FirstName, person.LastName);
       }
    }
    // The example displays the following output:
    //       Jane Doe
    //       John Doe
    
    Imports System.Collections.Generic
    
    Public Class Person : Implements IComparable(Of Person)
       Public Sub New(fName As String, lName As String)
          FirstName = fName
          LastName = lName
       End Sub
       
       Public Property FirstName As String
       Public Property LastName As String
       
       Public Function CompareTo(other As Person) As Integer _
              Implements IComparable(Of Person).CompareTo
          Return String.Format("{0} {1}", LastName, FirstName).
                CompareTo(String.Format("{0} {1}", other.LastName, other.FirstName))    
       End Function
    End Class
    
    Module Example
       Public Sub Main()
          Dim people As New List(Of Person)()
          
          people.Add(New Person("John", "Doe"))
          people.Add(New Person("Jane", "Doe"))
          people.Sort()
          For Each person In people
             Console.WriteLine("{0} {1}", person.FirstName, person.LastName)
          Next
       End Sub
    End Module
    ' The example displays the following output:
    '       Jane Doe
    '       John Doe
    
  • Sıralamayı denediğiniz tür için kaynak kodu değiştiremeyeceğiniz takdirde, arabirimini uygulayan özel amaçlı bir sıralama sınıfı tanımlayabilirsiniz 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. SortBir parametresi içeren yönteminin bir aşırı yüklemesini çağırabilirsiniz IComparer<T> .You can call an overload of the Sort method that includes an IComparer<T> parameter. Bu yaklaşım, nesneleri birden çok ölçüte göre sıralayan özel bir sıralama sınıfı geliştirmek istiyorsanız özellikle yararlıdır.This approach is especially useful if you want to develop a specialized sorting class that can sort objects based on multiple criteria.

    Aşağıdaki örnek, PersonComparer koleksiyonları sıralamak için kullanılan özel bir sınıf geliştirerek yaklaşımı kullanır Person .The following example uses the approach by developing a custom PersonComparer class that is used to sort Person collections. Daha sonra bu sınıfın bir örneğini List<T>.Sort(IComparer<T>) yöntemine geçirir.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
    
  • Sıralamayı gerçekleştirmeye çalıştığınız tür için kaynak kodu değiştiremeyeceğiniz takdirde, Comparison<T> sıralamayı gerçekleştirmek için bir temsilci oluşturabilirsiniz.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. Temsilci imzasıThe delegate signature is

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

    Aşağıdaki örnek, PersonComparison temsilci imzasıyla eşleşen bir yöntemi tanımlayarak yaklaşımı kullanır Comparison<T> .The following example uses the approach by defining a PersonComparison method that matches the Comparison<T> delegate signature. Daha sonra bu temsilciyi List<T>.Sort(Comparison<T>) yöntemine geçirir.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
    

<T>Temel alınan türüne null olan null değer atamaCasting a Nullable<T> that is null to its underlying type

Nullable<T>Temel alınan türüne bir değer atama girişimi null bir InvalidOperationException özel durum oluşturur ve hata iletisini görüntüler, "Nullable nesne bir değere sahip olmalıdır.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.

Aşağıdaki örnek, InvalidOperationException bir değeri içeren bir diziyi yinelemek istediğinde bir özel durum oluşturur 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()

Özel durumu engellemek için:To prevent the exception:

Aşağıdaki örnek, her ikisini de özel durumdan kaçınmak için yapar 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

Boş bir koleksiyonda System. LINQ. sıralanabilir yöntemi çağırmaCalling a System.Linq.Enumerable method on an empty collection

,,,,, Enumerable.Aggregate Enumerable.Average Enumerable.First Enumerable.Last Enumerable.Max Enumerable.Min , Enumerable.Single , Ve Enumerable.SingleOrDefault yöntemleri sırayla işlem gerçekleştirir ve tek bir sonuç döndürür.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. Bu yöntemlerin bazı aşırı yüklemeleri, InvalidOperationException dizi boş olduğunda, diğer aşırı yüklemeler dönirken bir özel durum oluşturur null .Some overloads of these methods throw an InvalidOperationException exception when the sequence is empty, while other overloads return null. Enumerable.SingleOrDefaultAyrıca, InvalidOperationException dizi birden fazla öğe içerdiğinde Yöntem bir özel durum oluşturur.The Enumerable.SingleOrDefault method also throws an InvalidOperationException exception when the sequence contains more than one element.

Not

Özel durum oluşturan yöntemlerin çoğu InvalidOperationException aşırı yüklerdir.Most of the methods that throw an InvalidOperationException exception are overloads. Seçtiğiniz aşırı yüklemenin davranışını anladığınızdan emin olun.Be sure that you understand the behavior of the overload that you choose.

Aşağıdaki tabloda InvalidOperationException bazı yöntemlere çağrılar tarafından oluşturulan özel durum nesnelerinden alınan özel durum iletileri listelenmektedir System.Linq.Enumerable .The following table lists the exception messages from the InvalidOperationException exception objects thrown by calls to some System.Linq.Enumerable methods.

YöntemMethod İletiMessage
Aggregate
Average
Last
Max
Min
Dizi hiçbir öğe içermiyorSequence contains no elements
First Dizi eşleşen öğe içermiyorSequence contains no matching element
Single
SingleOrDefault
Sıra birden fazla eşleşen öğe içeriyorSequence contains more than one matching element

Özel durumu nasıl ortadan kaldıracağınız veya işlediğinize, uygulamanızın varsayımlarına ve çağırdığınız belirli yönteme göre değişir.How you eliminate or handle the exception depends on your application's assumptions and on the particular method you call.

Örnekler ek ayrıntı sağlar.The examples provide additional detail.

Aşağıdaki örnek, Enumerable.Average değerleri 4 ' ten büyük olan bir dizinin ortalamasını hesaplamak için yöntemini kullanır.The following example uses the Enumerable.Average method to compute the average of a sequence whose values are greater than 4. Özgün diziden hiçbir değer 4 ' ü aştığından, diziye hiçbir değer eklenmez ve yöntem bir InvalidOperationException özel durum oluşturur.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()

AnyAşağıdaki örnekte gösterildiği gibi, sıranın, diziyi işleyen yöntemi çağırmadan önce herhangi bir öğe içerip içermediğini anlamak için yöntemi çağırarak bu özel durum ortadan kaldırılabilir.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.FirstYöntemi bir dizideki ilk öğeyi veya belirli bir koşulu karşılayan bir dizideki ilk öğeyi döndürür.The Enumerable.First method returns the first item in a sequence or the first element in a sequence that satisfies a specified condition. Sıra boşsa ve bu nedenle bir ilk öğesi yoksa, bir InvalidOperationException özel durum oluşturur.If the sequence is empty and therefore does not have a first element, it throws an InvalidOperationException exception.

Aşağıdaki örnekte, Enumerable.First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) InvalidOperationException dbQueryResults dizisi 4 ' ten büyük bir öğe içermediğinden Yöntem bir özel durum oluşturur.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 Belirtilen veya varsayılan bir değer döndürmek için yerine yöntemini çağırabilirsiniz.You can call the Enumerable.FirstOrDefault method instead of Enumerable.First to return a specified or default value. Yöntem dizide ilk bir öğe bulamazsa, bu veri türü için varsayılan değeri döndürür.If the method does not find a first element in the sequence, it returns the default value for that data type. Varsayılan değer, null bir başvuru türü için, sayısal veri türü için sıfır ve DateTime.MinValue DateTime tür için.The default value is null for a reference type, zero for a numeric data type, and DateTime.MinValue for the DateTime type.

Not

Yöntemin döndürdüğü değerin yorumlanması Enumerable.FirstOrDefault genellikle türün varsayılan değerinin dizide geçerli bir değer olması durumunda karmaşıktır.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. Bu durumda, Enumerable.Any metodu çağırmadan önce sıranın geçerli üyelere sahip olup olmadığını belirleme yöntemini çağırmanız gerekir 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.

Aşağıdaki örnek, Enumerable.FirstOrDefault<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) InvalidOperationException Önceki örnekte oluşturulan özel durumu engellemek için yöntemini çağırır.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.

Tek bir öğe olmadan bir dizide sıralanabilir. Single veya sıralanabilir. SingleOrDefault çağrılıyorCalling Enumerable.Single or Enumerable.SingleOrDefault on a sequence without one element

Enumerable.SingleYöntemi, bir sıranın tek bir öğesini veya belirtilen koşulu karşılayan bir dizinin tek öğesini döndürür.The Enumerable.Single method returns the only element of a sequence, or the only element of a sequence that meets a specified condition. Dizide hiç öğe yoksa veya birden fazla öğe varsa, yöntem bir InvalidOperationException özel durum oluşturur.If there are no elements in the sequence, or if there is more than one element , the method throws an InvalidOperationException exception.

Enumerable.SingleOrDefaultDizi hiçbir öğe içerdiğinde özel durum oluşturmak yerine varsayılan bir değer döndürmek için yöntemini kullanabilirsiniz.You can use the Enumerable.SingleOrDefault method to return a default value instead of throwing an exception when the sequence contains no elements. Ancak, Enumerable.SingleOrDefault dizi birden fazla öğe içerdiğinde yöntem yine de bir InvalidOperationException özel durum oluşturur.However, the Enumerable.SingleOrDefault method still throws an InvalidOperationException exception when the sequence contains more than one element.

Aşağıdaki tabloda InvalidOperationException , ve yöntemlerine yapılan çağrılar tarafından oluşturulan özel durum nesnelerinden alınan özel durum iletileri Enumerable.Single listelenmektedir 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.

YöntemMethod İletiMessage
Single Dizi eşleşen öğe içermiyorSequence contains no matching element
Single
SingleOrDefault
Sıra birden fazla eşleşen öğe içeriyorSequence contains more than one matching element

Aşağıdaki örnekte, Enumerable.Single InvalidOperationException dizi 4 ' ten büyük bir öğe içermediğinden yöntemine yapılan çağrı bir özel durum oluşturur.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()

Aşağıdaki örnek, InvalidOperationException yöntemi çağırmak yerine bir dizi boş olduğunda oluşturulan özel durumu engellemeye çalışır Enumerable.SingleOrDefault .The following example attempts to prevent the InvalidOperationException exception thrown when a sequence is empty by instead calling the Enumerable.SingleOrDefault method. Ancak, bu sıra değeri 2 ' den büyük olan birden çok öğe döndürdüğünden, ayrıca bir InvalidOperationException özel durum oluşturur.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()

Yöntemi çağırmak, Enumerable.Single belirtilen ölçütlere uyan bir sıranın veya dizinin yalnızca bir öğe içerdiğini varsayar.Calling the Enumerable.Single method assumes that either a sequence or the sequence that meets specified criteria contains only one element. Enumerable.SingleOrDefault sıfır veya bir sonuçla bir sıra olduğunu varsayar, ancak daha fazla.Enumerable.SingleOrDefault assumes a sequence with zero or one result, but no more. Bu varsayıma, sizin bölüminizdeki bir bilinçli ve bu koşullar karşılanmazsa, ortaya çıkan işlemi yeniden oluşturmak veya yakalamak InvalidOperationException uygun olur.If this assumption is a deliberate one on your part and these conditions are not met, rethrowing or catching the resulting InvalidOperationException is appropriate. Aksi takdirde veya geçersiz koşulların belirli bir sıklıkta gerçekleşeceğini düşünüyorsanız, veya gibi başka bir yöntem kullanmayı göz önünde bulundurmanız gerekir 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.

Dinamik çapraz uygulama etki alanı erişimiDynamic cross-application domain field access

OpCodes.LdfldaMicrosoft ara dili (MSIL) yönergesi, InvalidOperationException adresini almaya çalıştığınız alan nesne, kodunuzun yürütüldüğü uygulama etki alanında değilse bir özel durum oluşturur.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. Bir alanın adresine yalnızca bulunduğu uygulama etki alanından erişilebilir.The address of a field can only be accessed from the application domain in which it resides.

InvalidOperationException özel durumu oluşturuluyorThrowing an InvalidOperationException exception

InvalidOperationExceptionYalnızca bir nedenden dolayı nesnenizin durumu belirli bir yöntem çağrısını desteklemiyorsa bir özel durum oluşturmanız gerekir.You should throw an InvalidOperationException exception only when the state of your object for some reason does not support a particular method call. Diğer bir deyişle, yöntem çağrısı bazı koşullarda veya bağlamlarda geçerlidir, ancak başkaları içinde geçersizdir.That is, the method call is valid in some circumstances or contexts, but is invalid in others.

Yöntem çağırma hatasının nedeni geçersiz bağımsız değişkenlerden, daha sonra ArgumentException veya türetilmiş sınıflarından biri veya ArgumentNullException ya da ArgumentOutOfRangeException bunun yerine oluşturulmalıdır.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.

Çeşitli bilgilerMiscellaneous information

InvalidOperationException 0x80131509 değerine sahip HRESULT COR_E_INVALIDOPERATION kullanır.InvalidOperationException uses the HRESULT COR_E_INVALIDOPERATION, which has the value 0x80131509.

Bir örneğinin ilk özellik değerlerinin listesi için InvalidOperationException , InvalidOperationException oluşturuculara bakın.For a list of initial property values for an instance of InvalidOperationException, see the InvalidOperationException constructors.

Oluşturucular

InvalidOperationException()

InvalidOperationException sınıfının yeni bir örneğini başlatır.Initializes a new instance of the InvalidOperationException class.

InvalidOperationException(SerializationInfo, StreamingContext)

InvalidOperationException sınıfının yeni bir örneğini serileştirilmiş verilerle başlatır.Initializes a new instance of the InvalidOperationException class with serialized data.

InvalidOperationException(String)

Belirtilen bir hata iletisiyle sınıfın yeni bir örneğini başlatır InvalidOperationException .Initializes a new instance of the InvalidOperationException class with a specified error message.

InvalidOperationException(String, Exception)

InvalidOperationExceptionBelirtilen bir hata iletisiyle sınıfın yeni bir örneğini ve bu özel durumun nedeni olan iç özel duruma bir başvuruyu başlatır.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.

Özellikler

Data

Özel durum hakkında ek kullanıcı tanımlı bilgiler sağlayan anahtar/değer çiftleri koleksiyonunu alır.Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Devralındığı yer: Exception)
HelpLink

Bu özel durumla ilişkili Yardım dosyasının bağlantısını alır veya ayarlar.Gets or sets a link to the help file associated with this exception.

(Devralındığı yer: Exception)
HResult

Belirli bir özel duruma atanan kodlanmış bir sayısal değer olan HRESULT 'yi alır veya ayarlar.Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Devralındığı yer: Exception)
InnerException

ExceptionGeçerli özel duruma neden olan örneği alır.Gets the Exception instance that caused the current exception.

(Devralındığı yer: Exception)
Message

Geçerli özel durumu açıklayan bir ileti alır.Gets a message that describes the current exception.

(Devralındığı yer: Exception)
Source

Uygulamanın veya hataya neden olan nesnenin adını alır veya ayarlar.Gets or sets the name of the application or the object that causes the error.

(Devralındığı yer: Exception)
StackTrace

Çağrı yığınında anlık çerçevelerin dize gösterimini alır.Gets a string representation of the immediate frames on the call stack.

(Devralındığı yer: Exception)
TargetSite

Geçerli özel durumu oluşturan yöntemi alır.Gets the method that throws the current exception.

(Devralındığı yer: Exception)

Yöntemler

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.Determines whether the specified object is equal to the current object.

(Devralındığı yer: Object)
GetBaseException()

Türetilmiş bir sınıfta geçersiz kılınırsa, Exception bir veya daha fazla sonraki özel durumun kök nedeni olan öğesini döndürür.When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(Devralındığı yer: Exception)
GetHashCode()

Varsayılan karma işlevi olarak işlev görür.Serves as the default hash function.

(Devralındığı yer: Object)
GetObjectData(SerializationInfo, StreamingContext)

Türetilmiş bir sınıfta geçersiz kılınırsa, SerializationInfo özel durum hakkındaki bilgileri ayarlar.When overridden in a derived class, sets the SerializationInfo with information about the exception.

(Devralındığı yer: Exception)
GetType()

Geçerli örneğin çalışma zamanı türünü alır.Gets the runtime type of the current instance.

(Devralındığı yer: Exception)
MemberwiseClone()

Geçerli bir basit kopyasını oluşturur Object .Creates a shallow copy of the current Object.

(Devralındığı yer: Object)
ToString()

Geçerli özel durumun dize gösterimini oluşturur ve döndürür.Creates and returns a string representation of the current exception.

(Devralındığı yer: Exception)

Ekinlikler

SerializeObjectState

Özel durum hakkında serileştirilmiş veri içeren bir özel durum nesnesi oluşturmak için bir özel durum serileştirildiğinde gerçekleşir.Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Devralındığı yer: Exception)

Şunlara uygulanır

Ayrıca bkz.