InvalidOperationException Sınıf

Tanım

Yöntem çağrısı nesnenin geçerli durumu için geçersiz olduğunda oluşan özel durum.

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ı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ğıdaki 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 . Bir koleksiyonu yinelerken değiştirme.

  • ResourceSet.GetString kaynak kümesi yöntem çağrısı yapılmadan önce kapatılırsa.

  • XContainer.Add, eklenecek nesne veya nesneler yanlış yapılandırılmış bir XML belgesine neden olacaksa.

  • Ana veya ui iş parçacığı olmayan bir iş parçacığından kullanıcı arabirimini işlemeye çalışan bir yöntem.

Önemli

InvalidOperationException Özel durum çok çeşitli durumlarda oluşturulabildiğinden, özelliği tarafından Message döndürülen özel durum iletisini okumak önemlidir.

Bu bölümdeki konular:

InvalidOperationException özel durumlarının bazı yaygın nedenleri
UI iş parçacığını UI olmayan bir iş parçacığından güncelleştirme
Bir koleksiyonu yinelerken değiştirme
Nesneleri karşılaştırılamayan bir diziyi veya koleksiyonu sıralama
Null olan bir Null atanabilir<T'yi> temel alınan türüne atama
Boş bir koleksiyonda System.Linq.Enumerable yöntemini çağırma
Tek bir öğe olmadan bir dizide Enumerable.Single veya Enumerable.SingleOrDefault çağırma
Dinamik uygulamalar arası etki alanı alanı erişimi
InvalidOperationException özel durumu oluşturma
Çeşitli bilgiler

InvalidOperationException özel durumlarının bazı 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österilir. 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 iş parçacığını UI olmayan bir iş parçacığından güncelleştirme

Genellikle çalışan iş parçacıkları, bir uygulamanın kullanıcı arabiriminde görüntülenecek verilerin toplanmasını 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çevesi, 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. Ui InvalidOperationException iş parçacığı dışında bir iş parçacığından bir ui öğesine erişmeye çalıştığınızda oluşturulur. Özel durum iletisinin metni aşağıdaki tabloda gösterilmiştir.

Uygulama Türü İleti
WPF uygulaması Çağıran iş parçacığı bu nesneye farklı bir iş parçacığı sahip olduğundan nesneye erişemiyor.
UWP uygulaması Uygulama, farklı bir iş parçacığı için sıralanmış bir arabirim olarak adlandırıldı.
Windows Forms uygulaması İş parçacıkları arası işlem geçerli değil: Oluşturulduğu iş parçacığı dışında bir iş parçacığından erişilen 'TextBox1' denetimi.

.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 denetlemek için 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ıştırılıp çalıştırılmadığını belirlemek için yöntemini çağırın Dispatcher.CheckAccess . Yöntemin ui iş parçacığında çalışıyorsa ve false değilse döndürürtrue. Ui iş parçacığında çağrıyı zamanlamak için yönteminin aşırı yüklemelerinden Dispatcher.Invoke birini çağırın.

  • UWP uygulamalarında, ui olmayan bir iş parçacığında bir yöntemin CoreDispatcher.HasThreadAccess çalıştırılıp çalıştırılmadığını belirlemek için özelliğini denetleyin. Ui iş parçacığını CoreDispatcher.RunAsync güncelleştiren bir temsilciyi 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ıştırılıp çalıştırılmadığını belirlemek için özelliğini kullanınControl.InvokeRequired. Ui iş parçacığını Control.Invoke güncelleştiren bir temsilciyi yürütmek için yönteminin aşırı yüklemelerinden 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. Windows Forms bir uygulamada özelliğini olarak trueayarlamanız Multiline gerekir.

  • adlı threadExampleBtnbir düğme denetimi. Örnek, ThreadsExampleBtn_Clickdüğmenin Click olayı için bir işleyicisi sağlar.

Her durumda, threadExampleBtn_Click olay işleyicisi yöntemini iki kez çağırır DoSomeWork . İlk çağrı zaman uyumlu olarak çalıştırılır ve başarılı olur. Ancak ikinci çağrı, bir 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ştirmeyi dener. Bu bir InvalidOperationException özel durumla sonuç alır.

WPF ve UWP 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;
}
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 DoSomeWork aşağıdaki sürümü bir 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; });
}
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öntemin DoSomeWork aşağıdaki sürümü, bir UWP 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.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ı

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

foreach C#, for...in F# dilinde deyimi veya For Each Visual Basic 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ının karesini toplamaya ekleme girişimlerinden oluş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 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()
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 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 yoldan biriyle ortadan kaldırabilirsiniz:

  • Öğeler yinelenirken koleksiyona eklenmesi gerekiyorsa, , veya For Eachyerine for...in``foreach(for..to F#içinde) 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 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
    
    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 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ü içinde döngüden uygun şekilde çıkılacak bir sayaç kullanarak, - 1'den Count 0'a geri giderek 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 koleksiyonu yinelemeden önce 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, koleksiyon yinelenirken eklediğiniz geçici bir koleksiyonda 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 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
    
    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 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ı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. Aksi takdirde, 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 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()
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 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 üç yoldan biriyle ortadan kaldırabilirsiniz:

  • Sıralamaya çalıştığınız türe sahipseniz (kaynak kodunu denetlerseniz), veya IComparable arabirimini uygulayacak IComparable<T> şekilde değiştirebilirsiniz. Bunun için veya CompareTo yöntemini uygulamanız IComparable<T>.CompareTo gerekir. Arabirim uygulamasını mevcut bir türe 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österilen çıktıda gösterildiği gibi koleksiyon başarıyla sıralanır.

    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
    
    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 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ı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 Sort aşırı yüklemesini ç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 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
    
    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 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ı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 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
    
    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 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
    

Null olan null değeri<T> 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 şu hata iletisini görüntüler: "Null atanabilir nesnenin bir değeri olmalıdır. null

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 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()
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 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 önlemek için:

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

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

Enumerable.Aggregate, Enumerable.Average, , Enumerable.First, Enumerable.Last, Enumerable.Max, Enumerable.Min, Enumerable.Singleve 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, dizi 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.

Not

Özel durum oluşturan InvalidOperationException yöntemlerin çoğu aşırı yüklemelerdir. Seçtiğiniz aşırı yüklemenin davranışını anladığınızdan emin olun.

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

Yöntem İleti
Aggregate
Average
Last
Max
Min
Sıra öğe içermiyor
First Sıra eşleşen öğe içermiyor
Single
SingleOrDefault
Sıra birden fazla eşleşen öğe içeriyor

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

Ö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 saptamak için yöntemi çağrılarak özel durum ortadan kaldırılabilir.

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.
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 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.

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

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 .

Not

yöntemi tarafından döndürülen değeri yorumlamak Enumerable.FirstOrDefault genellikle türün varsayılan değerinin dizide geçerli bir değer olabileceği gerçeğiyle karmaşıktır. Bu durumda, yöntemini çağırmadan önce dizinin geçerli üyeleri olup olmadığını belirlemek için yöntemini çağırırsınız Enumerable.Any Enumerable.First .

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 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.
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 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 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 yapılan çağrılar tarafından oluşan özel durum nesnelerinden InvalidOperationException gelen özel durum iletileri listelemektedir.

Yöntem İleti
Single Sıra eşleşen öğe içermiyor
Single
SingleOrDefault
Sıra birden fazla eşleşen öğe içeriyor

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 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()
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 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, bunun yerine yöntemini çağırarak bir dizi boş olduğunda oluşan özel durumu önlemeye InvalidOperationException Enumerable.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 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()
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 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önteminin Enumerable.Single çağrılması, belirtilen ölçütleri karşılayan bir sıranın veya dizinin 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 tarafınızda 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ı göz önünde bulundurmalısınız.

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

OpCodes.Ldflda Microsoft ara dili (MSIL) yönergesi, adresini almaya çalıştığınız alanı içeren nesne kodunuzun yürütülmekte olduğu uygulama etki alanı içinde değilse 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 nesnenizin herhangi bir nedenle 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.

Çeşitli bilgiler

InvalidOperationException değeri 0x80131509 olan HRESULT COR_E_INVALIDOPERATION kullanır.

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

Oluşturucular

InvalidOperationException()

InvalidOperationException sınıfının yeni bir örneğini başlatır.

InvalidOperationException(SerializationInfo, StreamingContext)

InvalidOperationException sınıfının yeni bir örneğini serileştirilmiş verilerle başlatır.

InvalidOperationException(String)

Belirtilen hata iletisiyle sınıfının yeni bir örneğini InvalidOperationException başlatır.

InvalidOperationException(String, Exception)

Belirtilen bir hata iletisi ve bu özel durumun nedeni olan iç özel duruma başvuru ile sınıfının yeni bir örneğini InvalidOperationException başlatır.

Özellikler

Data

Özel durum hakkında kullanıcı tanımlı ek bilgiler sağlayan bir anahtar/değer çifti koleksiyonu alır.

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

Bu özel durumla ilişkili yardım dosyasının bağlantısını alır veya ayarlar.

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

Belirli bir özel duruma atanan kodlanmış sayısal bir değer olan HRESULT değerini alır veya ayarlar.

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

Exception Geçerli özel duruma neden olan örneği alır.

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

Geçerli özel durumu açıklayan bir ileti alır.

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

Hataya neden olan uygulamanın veya nesnenin adını alır veya ayarlar.

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

Çağrı yığınındaki anlık çerçevelerin dize gösterimini alır.

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

Geçerli özel durumu oluşturan yöntemini alır.

(Devralındığı yer: Exception)

Yöntemler

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

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

Türetilmiş bir sınıfta geçersiz kılındığında, sonraki bir veya daha fazla özel durumun kök nedeni olan değerini döndürür Exception .

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

Varsayılan karma işlevi işlevi görür.

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

Türetilmiş bir sınıfta geçersiz kılındığında, özel durum hakkındaki bilgilerle öğesini ayarlar SerializationInfo .

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

Geçerli örneğin çalışma zamanı türünü alır.

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

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

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

Geçerli özel durumun dize gösterimini oluşturur ve döndürür.

(Devralındığı yer: Exception)

Ekinlikler

SerializeObjectState
Kullanımdan kalktı.

Bir özel durum, özel durum hakkında serileştirilmiş veriler içeren bir özel durum nesnesi oluşturmak üzere seri hale getirildiğinde gerçekleşir.

(Devralındığı yer: Exception)

Şunlara uygulanır

Ayrıca bkz.