System.InvalidOperationException sınıfı

Bu makale, bu API'nin başvuru belgelerine ek açıklamalar sağlar.

InvalidOperationException , bir yöntemi çağırma hatasının geçersiz bağımsız değişkenler dışındaki nedenlerden kaynaklandığında kullanılır. Genellikle, bir nesnenin durumu yöntem çağrısını destekleyemiyorsa oluşturulur. Örneğin, aşağıdakiler gibi yöntemler tarafından bir InvalidOperationException özel durum oluşturulur:

• IEnumerator.MoveNext bir koleksiyonun nesneleri numaralandırıcı oluşturulduktan sonra değiştirilirse. Daha fazla bilgi için bkz . Koleksiyonu yinelerken değiştirme.
• ResourceSet.GetString yöntem çağrısı yapılmadan önce kaynak kümesi kapatılırsa.
• XContainer.Add, eklenecek nesne veya nesneler yanlış yapılandırılmış bir XML belgesine neden olacaksa.
• Kullanıcı arabirimini ana veya ui iş parçacığı olmayan bir iş parçacığından işlemeye çalışan bir yöntem.

InvalidOperationException , 0x80131509 değerine sahip HRESULT COR_E_INVALIDOPERATIONkullanır.

örneğinin ilk özellik değerlerinin InvalidOperationExceptionlistesi için oluşturuculara InvalidOperationException bakın.

InvalidOperationException özel durumlarının yaygın nedenleri

Aşağıdaki bölümlerde, bir uygulamada özel durumdaki bazı yaygın durumların InvalidOperationException nasıl oluşturulduğu gösterilmektedir. Sorunu nasıl ele alacağınız belirli bir duruma bağlıdır. Ancak en yaygın olarak özel durum geliştirici hatasından kaynaklanır ve InvalidOperationException özel durum tahmin edilebilir ve önlenebilir.

Ui olmayan bir iş parçacığından ui iş parçacığını güncelleştirme

Genellikle çalışan iş parçacıkları, bir uygulamanın kullanıcı arabiriminde görüntülenecek veri toplamayı içeren bazı arka plan işleri gerçekleştirmek için kullanılır. Ancak. Windows Forms ve Windows Presentation Foundation (WPF) gibi .NET için çoğu GUI (grafik kullanıcı arabirimi) uygulama çerçeveleri, GUI nesnelerine yalnızca kullanıcı arabirimini oluşturan ve yöneten iş parçacığından (Ana veya UI iş parçacığı) erişmenizi sağlar. kullanıcı InvalidOperationException arabirimi iş parçacığı dışında bir iş parçacığından ui öğesine erişmeye çalıştığınızda oluşturulur. Özel durum iletisinin metni aşağıdaki tabloda gösterilmiştir.

.NET için UI çerçeveleri, ui öğesinin bir üyesine yapılan çağrının UI iş parçacığında yürütüldüğünü ve ui iş parçacığında çağrıyı zamanlamak için diğer yöntemleri denetlemeye yönelik bir yöntem içeren bir dağıtıcı deseni uygular:

• WPF uygulamalarında, ui olmayan bir iş parçacığında bir yöntemin çalışıp çalışmadığını belirlemek için yöntemini çağırın Dispatcher.CheckAccess . Yöntemin ui iş parçacığında çalışıp çalışmadığını ve false aksi takdirde döndürürtrue. Ui iş parçacığında çağrıyı Dispatcher.Invoke zamanlamak için yönteminin aşırı yüklemelerinden birini çağırın.
• UWP uygulamalarında, ui olmayan bir iş parçacığında bir yöntemin CoreDispatcher.HasThreadAccess çalışıp çalışmadığını belirlemek için özelliğini denetleyin. Ui iş parçacığını CoreDispatcher.RunAsync güncelleştiren bir temsilci yürütmek için yöntemini çağırın.
• Windows Forms uygulamalarında, ui olmayan bir iş parçacığında bir yöntemin çalışıp çalışmadığını belirlemek için özelliğini kullanın Control.InvokeRequired . Ui iş parçacığını güncelleştiren bir temsilci yürütmek için yönteminin aşırı yüklemelerinden Control.Invoke birini çağırın.

Aşağıdaki örneklerde, ui öğesini oluşturan iş parçacığı dışında bir iş parçacığından güncelleştirmeye çalıştığınızda oluşan özel durum gösterilmektedir InvalidOperationException . Her örnek için iki denetim oluşturmanız gerekir:

• adlı textBox1bir metin kutusu denetimi. Bir Windows Forms uygulamasında, özelliğini Multiline olarak trueayarlamanız gerekir.
• adlı threadExampleBtnbir düğme denetimi. Örnek, ThreadsExampleBtn_Clickdüğmenin Click olayı için bir işleyici sağlar.

Her durumda, threadExampleBtn_Click olay işleyicisi yöntemini iki kez çağırır DoSomeWork . İlk çağrı zaman uyumlu olarak çalışır ve başarılı olur. Ancak ikinci çağrı, iş parçacığı havuzu iş parçacığında zaman uyumsuz olarak çalıştığından kullanıcı arabirimi olmayan bir iş parçacığından kullanıcı arabirimini güncelleştirmeye çalışır. Bu bir InvalidOperationException özel durumla sonuç alır.

WPF uygulamaları

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

Yöntemin DoSomeWork aşağıdaki sürümü WPF uygulamasındaki özel durumu ortadan kaldırır.

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; });
}

Windows Forms uygulamaları

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

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 yinelenirken değiştirme

foreach C# dilindeki, for...in F# dilindeki veya For Each Visual Basic'teki deyimi, bir koleksiyonun üyelerini yinelemek ve tek tek öğelerini okumak veya değiştirmek için kullanılır. Ancak, koleksiyona öğe eklemek veya koleksiyondan öğe kaldırmak için kullanılamaz. Bunu yaptığınızda şuna benzer bir iletiyle bir InvalidOperationException özel durum oluşturulur: "Koleksiyon değiştirildi; numaralandırma işlemi yürütülmeyebilir."

Aşağıdaki örnek, her tamsayı karesini toplamaya eklemeye çalışan bir tamsayı koleksiyonunu yineler. Örnek, yöntemine ilk çağrı List<T>.Add ile bir InvalidOperationException oluşturur.

using System;
using System.Collections.Generic;

public class IteratingEx1
{
    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()

open System

let numbers = ResizeArray [| 1; 2; 3; 4; 5 |]
for number in numbers do
    let square = Math.Pow(number, 2) |> int
    printfn $"{number}^{square}"
    printfn $"Adding {square} to the collection...\n"
    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 <StartupCode$fs>.main()

Imports System.Collections.Generic

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

Özel durumu, uygulama mantığınıza bağlı olarak iki yoldan biriyle ortadan kaldırabilirsiniz:

• Öğeler yinelenirken koleksiyona eklenmesi gerekiyorsa, , veya For Eachyerine for...inforeach(for..to F#'ta) deyimini for kullanarak dizinle yineleyebilirsiniz. Aşağıdaki örnek, koleksiyondaki sayıların karesini koleksiyona eklemek için for deyimini kullanır.

  using System;
  using System.Collections.Generic;
  
  public class IteratingEx2
  {
      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
  

  open System
  open System.Collections.Generic
  
  let numbers = ResizeArray [| 1; 2; 3; 4; 5 |]
  
  let upperBound = numbers.Count - 1
  for i = 0 to upperBound do
      let square = Math.Pow(numbers[i], 2) |> int
      printfn $"{numbers[i]}^{square}"
      printfn $"Adding {square} to the collection...\n"
      numbers.Add square
  
  printfn "Elements now in the collection: "
  for number in numbers do
      printf $"{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 Example7
      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
  

  Koleksiyonu yinelemeden önce yineleme sayısını, döngünün içinde uygun şekilde döngüden çıkacak bir sayaç kullanarak, - 1'den Count 0'a kadar geriye doğru yineleyerek veya örnekte olduğu gibi dizideki öğe sayısını bir değişkene atayarak ve döngünün üst sınırlarını oluşturmak için kullanarak yineleme sayısını oluşturmanız gerektiğini unutmayın. Aksi takdirde, her yinelemede koleksiyona bir öğe eklenirse sonsuz bir döngü sonuçlanır.

• Yinelenirken koleksiyona öğe eklenmesi gerekmiyorsa, koleksiyonu yinelerken eklediğiniz geçici bir koleksiyona eklenecek öğeleri depolayabilirsiniz. Aşağıdaki örnek, bir koleksiyondaki sayıların karesini geçici bir koleksiyona eklemek ve ardından koleksiyonları tek bir dizi nesnesinde birleştirmek için bu yaklaşımı kullanır.

  using System;
  using System.Collections.Generic;
  
  public class IteratingEx3
  {
      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
  

  open System
  open System.Collections.Generic
  
  let numbers = ResizeArray [| 1; 2; 3; 4; 5 |]
  let temp = ResizeArray()
  
  // Square each number and store it in a temporary collection.
  for number in numbers do
      let square = Math.Pow(number, 2) |> int
      temp.Add square
  
  // Combine the numbers into a single array.
  let combined = Array.zeroCreate<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.
  for value in combined do
      printf $"{value}    "
  // The example displays the following output:
  //       1    2    3    4    5    1    4    9    16    25
  

  Imports System.Collections.Generic
  
  Module Example8
      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ılamayan bir diziyi veya koleksiyonu sıralama

Yöntem veya List<T>.Sort() yöntem gibi Array.Sort(Array) genel amaçlı sıralama yöntemleri genellikle sıralanacak nesnelerden en az birinin veya arabirimini IComparable<T>IComparable uygulamasını gerektirir. Değilse, koleksiyon veya dizi sıralanamaz ve yöntemi bir InvalidOperationException özel durum oluşturur. Aşağıdaki örnek bir Person sınıfı tanımlar, iki Person nesneyi genel List<T> bir nesnede depolar ve bunları sıralamaya çalışır. Örnekteki çıktıda gösterildiği gibi yöntemine List<T>.Sort() yapılan çağrı bir InvalidOperationExceptionoluşturur.

using System;
using System.Collections.Generic;

public class Person1
{
    public Person1(string fName, string lName)
    {
        FirstName = fName;
        LastName = lName;
    }

    public string FirstName { get; set; }
    public string LastName { get; set; }
}

public class ListSortEx1
{
    public static void Main()
    {
        var people = new List<Person1>();

        people.Add(new Person1("John", "Doe"));
        people.Add(new Person1("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()

type Person(firstName: string, lastName: string) =
    member val FirstName = firstName with get, set
    member val LastName = lastName with get, set

let people = ResizeArray()

people.Add(Person("John", "Doe"))
people.Add(Person("Jane", "Doe"))
people.Sort()
for person in people do
    printfn $"{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 <StartupCode$fs>.main()

Imports System.Collections.Generic

Public Class Person9
    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 Example9
    Public Sub Main()
        Dim people As New List(Of Person9)()

        people.Add(New Person9("John", "Doe"))
        people.Add(New Person9("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 üç yoldan herhangi biriyle ortadan kaldırabilirsiniz:

• Sıralamaya çalıştığınız türe sahipseniz (kaynak kodunu denetlerseniz), veya IComparable arabirimini uygulamak IComparable<T> için değiştirebilirsiniz. Bunun için veya CompareTo yöntemini uygulamanız IComparable<T>.CompareTo gerekir. Var olan bir türe arabirim uygulaması eklemek hataya neden olan bir değişiklik değildir.

  Aşağıdaki örnek, sınıfı için bir IComparable<T> uygulama sağlamak için Person bu yaklaşımı kullanır. Yine de koleksiyonun veya dizinin genel sıralama yöntemini çağırabilirsiniz ve örnekte gösterildiği gibi koleksiyon başarıyla sıralanır.

  using System;
  using System.Collections.Generic;
  
  public class Person2 : IComparable<Person>
  {
      public Person2(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 ListSortEx2
  {
      public static void Main()
      {
          var people = new List<Person2>();
  
          people.Add(new Person2("John", "Doe"));
          people.Add(new Person2("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
  

  open System
  
  type Person(firstName: string, lastName: string) =
      member val FirstName = firstName with get, set
      member val LastName = lastName with get, set
      
      interface IComparable<Person> with
          member this.CompareTo(other) =
              compare $"{this.LastName} {this.FirstName}" $"{other.LastName} {other.FirstName}"
  
  let people = ResizeArray()
  
  people.Add(new Person("John", "Doe"))
  people.Add(new Person("Jane", "Doe"))
  people.Sort()
  for person in people do
      printfn $"{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 Example10
      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ıralamaya çalıştığınız türün kaynak kodunu değiştiremiyorsanız, arabirimini uygulayan IComparer<T> özel amaçlı bir sıralama sınıfı tanımlayabilirsiniz. Bir parametre içeren IComparer<T> yöntemin aşırı yüklemesini Sort çağırabilirsiniz. Bu yaklaşım özellikle nesneleri birden çok ölçüte göre sıralayan özel bir sıralama sınıfı geliştirmek istiyorsanız kullanışlıdır.

  Aşağıdaki örnek, koleksiyonları sıralamak Person için kullanılan özel PersonComparer bir sınıf geliştirerek yaklaşımını kullanır. Ardından bu sınıfın bir örneğini yöntemine List<T>.Sort(IComparer<T>) geçirir.

  using System;
  using System.Collections.Generic;
  
  public class Person3
  {
      public Person3(String fName, String lName)
      {
          FirstName = fName;
          LastName = lName;
      }
  
      public String FirstName { get; set; }
      public String LastName { get; set; }
  }
  
  public class PersonComparer : IComparer<Person3>
  {
      public int Compare(Person3 x, Person3 y)
      {
          return String.Format("{0} {1}", x.LastName, x.FirstName).
                 CompareTo(String.Format("{0} {1}", y.LastName, y.FirstName));
      }
  }
  
  public class ListSortEx3
  {
      public static void Main()
      {
          var people = new List<Person3>();
  
          people.Add(new Person3("John", "Doe"));
          people.Add(new Person3("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
  

  open System
  open System.Collections.Generic
  
  type Person(firstName, lastName) =
      member val FirstName = firstName with get, set
      member val LastName = lastName with get, set
  
  type PersonComparer() =
      interface IComparer<Person> with
          member _.Compare(x: Person, y: Person) =
              $"{x.LastName} {x.FirstName}".CompareTo $"{y.LastName} {y.FirstName}"
  
  let people = ResizeArray()
  
  people.Add(Person("John", "Doe"))
  people.Add(Person("Jane", "Doe"))
  people.Sort(PersonComparer())
  for person in people do
      printfn $"{person.FirstName} {person.LastName}"
  // The example displays the following output:
  //       Jane Doe
  //       John Doe
  

  Imports System.Collections.Generic
  
  Public Class Person11
      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 Person11)
      Public Function Compare(x As Person11, y As Person11) As Integer _
            Implements IComparer(Of Person11).Compare
          Return String.Format("{0} {1}", x.LastName, x.FirstName).
               CompareTo(String.Format("{0} {1}", y.LastName, y.FirstName))
      End Function
  End Class
  
  Module Example11
      Public Sub Main()
          Dim people As New List(Of Person11)()
  
          people.Add(New Person11("John", "Doe"))
          people.Add(New Person11("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ıralamaya çalıştığınız türün kaynak kodunu değiştiremiyorsanız, sıralamayı gerçekleştirmek için bir Comparison<T> temsilci oluşturabilirsiniz. Temsilci imzası

  Function Comparison(Of T)(x As T, y As T) As Integer
  

  int Comparison<T>(T x, T y)
  

  Aşağıdaki örnek, temsilci imzası ile eşleşen Comparison<T> bir PersonComparison yöntem tanımlayarak yaklaşımını kullanır. Ardından bu temsilciyi yöntemine List<T>.Sort(Comparison<T>) geçirir.

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

  open System
  open System.Collections.Generic
  
  type Person(firstName, lastName) =
      member val FirstName = firstName with get, set
      member val LastName = lastName with get, set
  
  let personComparison (x: Person) (y: Person) =
      $"{x.LastName} {x.FirstName}".CompareTo $"{y.LastName} {y.FirstName}"
  
  let people = ResizeArray()
  
  people.Add(Person("John", "Doe"))
  people.Add(Person("Jane", "Doe"))
  people.Sort personComparison
  for person in people do
      printfn $"{person.FirstName} {person.LastName}"
  
  // The example displays the following output:
  //       Jane Doe
  //       John Doe
  

  Imports System.Collections.Generic
  
  Public Class Person12
      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 Example12
      Public Sub Main()
          Dim people As New List(Of Person12)()
  
          people.Add(New Person12("John", "Doe"))
          people.Add(New Person12("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 Person12, y As Person12) 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
  

Null olan Null Atanabilir<T'yi> temel alınan türüne atama

Temel alınan türüne bir değer atama Nullable<T> girişimi bir InvalidOperationException özel durum oluşturur ve "Null atanabilir nesnenin bir değeri null olmalıdır.

Aşağıdaki örnek, değer içeren bir InvalidOperationException diziyi yinelemeye çalıştığında bir Nullable(Of Integer) özel durum oluşturur.

using System;
using System.Linq;

public class NullableEx1
{
   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()

open System
open System.Linq

let queryResult = [| Nullable 1; Nullable 2; Nullable(); Nullable 4 |]
let map = queryResult.Select(fun nullableInt -> nullableInt.Value)

// Display list.
for num in map do
    printf $"{num} "
printfn ""
// 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 <StartupCode$fs>.main()

Imports System.Linq

Module Example13
    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 önlemek için:

• Nullable<T>.HasValue özelliğini yalnızca olmayan nullöğeleri seçmek için kullanın.
• Bir değer için Nullable<T>.GetValueOrDefault varsayılan bir değer sağlamak üzere null aşırı yüklemelerden birini çağırın.

Aşağıdaki örnek, özel durumdan InvalidOperationException kaçınmak için her ikisini de yapar.

using System;
using System.Linq;

public class NullableEx2
{
   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

open System
open System.Linq

let queryResult = [| Nullable 1; Nullable 2; Nullable(); Nullable 4 |]
let numbers = queryResult.Select(fun nullableInt -> nullableInt.GetValueOrDefault())

// Display list using Nullable<int>.HasValue.
for number in numbers do
    printf $"{number} "
printfn ""

let numbers2 = queryResult.Select(fun nullableInt -> if nullableInt.HasValue then nullableInt.Value else -1)
// Display list using Nullable<int>.GetValueOrDefault.
for number in numbers2 do
    printf $"{number} "
printfn ""
// The example displays the following output:
//       1 2 0 4
//       1 2 -1 4

Imports System.Linq

Module Example14
    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.Enumerable yöntemini çağırma

Enumerable.Aggregate, , Enumerable.Average, Enumerable.First, Enumerable.Last, Enumerable.Max, , Enumerable.SingleEnumerable.Min, ve Enumerable.SingleOrDefault yöntemleri bir dizi üzerinde işlemler gerçekleştirir ve tek bir sonuç döndürür. Bu yöntemlerin bazı aşırı yüklemeleri sıra boş olduğunda bir InvalidOperationException özel durum oluştururken, diğer aşırı yüklemeler döndürür null. Yöntemi Enumerable.SingleOrDefault , dizi birden fazla öğe içerdiğinde de bir InvalidOperationException özel durum oluşturur.

Aşağıdaki tabloda, bazı System.Linq.Enumerable yöntemlere çağrılar InvalidOperationException tarafından oluşan özel durum nesnelerinden gelen özel durum iletileri listelenmektedir.

Özel durumu ortadan kaldırma veya işleme yöntemi, uygulamanızın varsayımlarına ve çağırdığınız belirli yönteme bağlıdır.

• Boş bir diziyi denetlemeden bu yöntemlerden birini kasıtlı olarak çağırdığınızda, dizinin boş olmadığını ve boş bir dizinin beklenmeyen bir durum olduğunu varsayarsınız. Bu durumda, özel durumu yakalamak veya yeniden boyutlandırmak uygundur.

• Boş bir diziyi denetleme hatanız yanlışlıkla yapıldıysa, bir dizinin öğe içerip içermediğini belirlemek için aşırı yüklemenin aşırı Enumerable.Any yüklemelerinden birini çağırabilirsiniz.

  İpucu

  Enumerable.Any<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) Bir dizi oluşturmadan önce yöntemini çağırmak, işlenecek verilerin çok sayıda öğe içermesi veya diziyi oluşturan işlemin pahalı olması durumunda performansı geliştirebilir.

• , veya Enumerable.Singlegibi Enumerable.FirstEnumerable.Lastbir yöntem çağırdıysanız, dizinin üyesi yerine varsayılan bir değer döndüren , Enumerable.LastOrDefaultveya Enumerable.SingleOrDefaultgibi Enumerable.FirstOrDefaultalternatif bir yöntemi değiştirebilirsiniz.

Örnekler ek ayrıntılar sağlar.

Aşağıdaki örnek, değerleri 4'ten büyük olan bir dizinin ortalamasını hesaplamak için yöntemini kullanır Enumerable.Average . Özgün dizideki hiçbir değer 4'ü aşmadığından, diziye hiçbir değer dahil değildir ve yöntem bir InvalidOperationException özel durum oluşturur.

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

open System
open System.Linq

let data = [| 1; 2; 3; 4 |]
let average = 
   data.Where(fun num -> num > 4).Average();
printfn $"The average of numbers greater than 4 is {average}"
// The example displays the following output:
//    Unhandled Exception: System.InvalidOperationException: Sequence contains no elements
//       at System.Linq.Enumerable.Average(IEnumerable`1 source)
//       at <StartupCode$fs>.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()

Aşağıdaki örnekte gösterildiği gibi, sırayı Any işleyen yöntemi çağırmadan önce dizinin herhangi bir öğe içerip içermediğini belirlemek için yöntemi çağrılarak özel durum ortadan kaldırılabilir.

using System;
using System.Linq;

public class EnumerableEx2
{
    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.

open System
open System.Linq

let dbQueryResults = [| 1; 2; 3; 4 |]
let moreThan4 = 
    dbQueryResults.Where(fun num -> num > 4)

if moreThan4.Any() then
    printfn $"Average value of numbers greater than 4: {moreThan4.Average()}:"
else
    // handle empty collection
    printfn "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 Example1
    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.

yöntemi, Enumerable.First bir dizideki ilk öğeyi veya belirtilen koşulu karşılayan bir dizideki ilk öğeyi döndürür. Dizi boşsa ve bu nedenle ilk öğe yoksa, bir InvalidOperationException özel durum oluşturur.

Aşağıdaki örnekte, Enumerable.First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) dbQueryResults dizisi 4'ten büyük bir öğe içermediğinden yöntemi bir InvalidOperationException özel durum oluşturur.

using System;
using System.Linq;

public class EnumerableEx3
{
    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()

open System
open System.Linq

let dbQueryResults = [| 1; 2; 3; 4 |]

let firstNum = dbQueryResults.First(fun n -> n > 4)

printfn $"The first value greater than 4 is {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 <StartupCode$fs>.main()

Imports System.Linq

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

Belirtilen veya varsayılan değeri döndürmek Enumerable.First yerine yöntemini çağırabilirsinizEnumerable.FirstOrDefault. Yöntem dizide ilk öğeyi bulamazsa, bu veri türü için varsayılan değeri döndürür. Varsayılan değer null bir başvuru türü, sayısal veri türü için sıfır ve DateTime.MinValue tür içindir DateTime .

Aşağıdaki örnek, önceki örnekte oluşan özel durumu önlemek InvalidOperationException için yöntemini çağırırEnumerable.FirstOrDefault<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>).

using System;
using System.Linq;

public class EnumerableEx4
{
    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.

open System
open System.Linq

let dbQueryResults = [| 1; 2; 3; 4 |]

let firstNum = dbQueryResults.FirstOrDefault(fun n -> n > 4)

if firstNum = 0 then
    printfn "No value is greater than 4."
else
    printfn $"The first value greater than 4 is {firstNum}"

// The example displays the following output:
//       No value is greater than 4.

Imports System.Linq

Module Example3
    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 öğe olmadan bir dizide Enumerable.Single veya Enumerable.SingleOrDefault çağrısı

Enumerable.Single yöntemi, bir dizinin tek öğesini veya belirtilen koşulu karşılayan bir dizinin tek öğesini döndürür. Dizide öğe yoksa veya birden fazla öğe varsa, yöntemi bir InvalidOperationException özel durum oluşturur.

Dizide Enumerable.SingleOrDefault öğe olmadığında özel durum oluşturmak yerine varsayılan bir değer döndürmek için yöntemini kullanabilirsiniz. Ancak, Enumerable.SingleOrDefault dizi birden fazla öğe içerdiğinde yöntemi yine de bir InvalidOperationException özel durum oluşturur.

Aşağıdaki tabloda, ve Enumerable.SingleOrDefault yöntemlerine Enumerable.Single çağrılar InvalidOperationException tarafından oluşan özel durum nesnelerinden gelen özel durum iletileri listelenmektedir.

Aşağıdaki örnekte, dizisinin 4'ten büyük bir öğesi olmadığından yöntemine yapılan çağrı Enumerable.Single bir InvalidOperationException özel durum oluşturur.

using System;
using System.Linq;

public class EnumerableEx5
{
    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()

open System
open System.Linq

let dbQueryResults = [| 1; 2; 3; 4 |]

let singleObject = dbQueryResults.Single(fun value -> value > 4)

// Display results.
printfn $"{singleObject} is the only value greater than 4"

// 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 <StartupCode$fs>.main()

Imports System.Linq

Module Example4
    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, bunun yerine yöntemini çağırarak bir dizi boş olduğunda oluşan özel durumu engellemeye InvalidOperationExceptionEnumerable.SingleOrDefault çalışır. Ancak, bu dizi değeri 2'den büyük olan birden çok öğe döndürdüğünden, bir InvalidOperationException özel durum da oluşturur.

using System;
using System.Linq;

public class EnumerableEx6
{
    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()

open System
open System.Linq

let dbQueryResults = [| 1; 2; 3; 4 |]

let singleObject = dbQueryResults.SingleOrDefault(fun value -> value > 2)

if singleObject <> 0 then
    printfn $"{singleObject} is the only value greater than 2"
else
    // Handle an empty collection.
    printfn "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 <StartupCode$fs>.main()

Imports System.Linq

Module Example5
    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önteminin çağrılması Enumerable.Single , belirtilen ölçütleri karşılayan bir dizi veya sıranın yalnızca bir öğe içerdiğini varsayar. Enumerable.SingleOrDefault sıfır veya bir sonuç içeren bir dizi olduğunu varsayar, ancak artık yok. Bu varsayım sizin için kasıtlı bir varsayımsa ve bu koşullar karşılanmazsa, sonucu InvalidOperationException yeniden oluşturmak veya yakalamak uygundur. Aksi takdirde veya geçersiz koşulların bir sıklıkta gerçekleşmesini bekliyorsanız veya Wheregibi FirstOrDefault başka Enumerable bir yöntem kullanmayı düşünmelisiniz.

Dinamik uygulamalar arası etki alanı alanı erişimi

Adresini OpCodes.Ldflda almaya çalıştığınız alanı içeren nesne kodunuzun yürütülmekte olduğu uygulama etki alanında değilse, ortak ara dil (CIL) yönergesi bir InvalidOperationException özel durum oluşturur. Bir alanın adresine yalnızca bulunduğu uygulama etki alanından erişilebilir.

InvalidOperationException özel durumu oluşturma

Yalnızca belirli bir nedenle nesnenizin durumu belirli bir InvalidOperationException yöntem çağrısını desteklemediğinde bir özel durum oluşturmalısınız. Başka bir ifadeyle, yöntem çağrısı bazı durumlarda veya bağlamlarda geçerlidir, ancak bazı durumlarda geçersizdir.

Yöntem çağırma hatası geçersiz bağımsız değişkenlerden kaynaklanıyorsa veya ArgumentException türetilmiş sınıflarından ArgumentNullException biri ya da ArgumentOutOfRangeExceptionbunun yerine atılmalıdır.