ArgumentOutOfRangeException Sınıf

Tanım

public ref class ArgumentOutOfRangeException : ArgumentException

public class ArgumentOutOfRangeException : ArgumentException

[System.Serializable]
public class ArgumentOutOfRangeException : ArgumentException

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class ArgumentOutOfRangeException : ArgumentException

type ArgumentOutOfRangeException = class
    inherit ArgumentException

type ArgumentOutOfRangeException = class
    inherit ArgumentException
    interface ISerializable

[<System.Serializable>]
type ArgumentOutOfRangeException = class
    inherit ArgumentException
    interface ISerializable

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type ArgumentOutOfRangeException = class
    inherit ArgumentException
    interface ISerializable

Public Class ArgumentOutOfRangeException
Inherits ArgumentException

Devralma

Object

Exception

ArgumentException

ArgumentOutOfRangeException

Devralma

Object

Exception

SystemException

ArgumentException

ArgumentOutOfRangeException

Öznitelikler

SerializableAttribute ComVisibleAttribute

Uygulamalar

ISerializable

Örnekler

Aşağıdaki örnek, davet edilen konuk hakkında bilgi içeren bir sınıf tanımlar. Konuk 21 yaşından küçükse bir ArgumentOutOfRangeException özel durum oluşturulur.

using System;
using static System.Console;

public class Program
{
    public static void Main(string[] args)
    {
        try
        {
            var guest1 = new Guest("Ben", "Miller", 17);
            WriteLine(guest1.GuestInfo);
        }
        catch (ArgumentOutOfRangeException argumentOutOfRangeException)
        {
            WriteLine($"Error: {argumentOutOfRangeException.Message}");
        }
    }
}

class Guest
{
    private const int minimumRequiredAge = 21;

    private string firstName;
    private string lastName;
    private int age;

    public Guest(string firstName, string lastName, int age)
    {
        if (age < minimumRequiredAge)
            throw new ArgumentOutOfRangeException(nameof(age), $"All guests must be {minimumRequiredAge}-years-old or older.");

        this.firstName = firstName;
        this.lastName = lastName;
        this.age = age;
    }

    public string GuestInfo => $"{firstName} {lastName}, {age}";
}

open System

type Guest(fName: string, lName: string, age: int) =
    let minimumRequiredAge = 21

    do if age < minimumRequiredAge then 
        raise (ArgumentOutOfRangeException(nameof age, $"All guests must be {minimumRequiredAge}-years-old or older."))

    member _.FirstName = fName
    member _.LastName = lName
    member _.GuestInfo() = $"{fName} {lName}, {age}"

try
    let guest1 = Guest("Ben", "Miller", 17);
    printfn $"{guest1.GuestInfo()}"
with
| :? ArgumentOutOfRangeException as e ->
    printfn $"Error: {e.Message}"

Module Module1
   Public Sub Main()
       Try
           Dim guest1 As Guest = New Guest("Ben", "Miller", 17)
           Console.WriteLine(guest1.GuestInfo)
       Catch outOfRange As ArgumentOutOfRangeException
           Console.WriteLine("Error: {0}", outOfRange.Message)
       End Try
   End Sub
End Module

Class Guest
    Private FirstName As String
    Private LastName As String
    Private Age As Integer

    Public Sub New(ByVal fName As String, ByVal lName As String, ByVal age As Integer)
        MyBase.New()
        FirstName = fName
        LastName = lName
        If (age < 21) Then
            Throw New ArgumentOutOfRangeException("age", "All guests must be 21-years-old or older.")
        Else
            age = age
        End If
    End Sub

    Public Function GuestInfo() As String
        Dim gInfo As String = (FirstName + (" " _
                    + (Me.LastName + (", " + Me.Age.ToString))))
        Return gInfo
    End Function
End Class

Açıklamalar

Bir ArgumentOutOfRangeException yöntem çağrıldığında özel durum oluşturulur ve yönteme geçirilen bağımsız değişkenlerden en az biri değildir null ve bağımsız değişken için beklenen değer kümesinin üyesi olmayan geçersiz bir değer içerir. ParamName özelliği geçersiz bağımsız değişkeni tanımlar ve ActualValue bir değer varsa özelliği geçersiz değeri tanımlar.

Genellikle, ArgumentOutOfRangeException geliştirici hatasından bir sonuç elde edin. Bir try/catch bloktaki özel durumu işlemek yerine, özel durumun nedenini ortadan kaldırmanız veya bağımsız değişken, özel durumu oluşturan yönteme geçirilmeden önce kullanıcı tarafından bir yöntem çağrısı veya girişi tarafından döndürülürse, bağımsız değişkenleri yönteme geçirmeden önce doğrulamanız gerekir.

ArgumentOutOfRangeException tarafından yaygın olarak kullanılır:

• ve System.IO ad alanları içindeki System.Collections sınıflar.

• Sınıf Array .

• sınıfında dize işleme yöntemleri String .

Özel durumun oluşturulduğu koşullar ArgumentOutOfRangeException şunlardır:

• Bir koleksiyonun üyesini dizin numarasına göre alırsınız ve dizin numarası geçersizdir.

  Bu, bir ArgumentOutOfRangeException özel durumun en yaygın nedenidir. Dizin numarası genellikle dört nedenden biri nedeniyle geçersizdir:

  1. Koleksiyonun üyesi yok ve kodunuz üye olduğunu varsayar. Aşağıdaki örnek, öğe içermeyen bir koleksiyonun ilk öğesini almayı dener:

     using System;
     using System.Collections.Generic;
     
     public class Example4
     {
        public static void Main()
        {
           var list = new List<string>();
           Console.WriteLine("Number of items: {0}", list.Count);
           try {
              Console.WriteLine("The first item: '{0}'", list[0]);
           }
           catch (ArgumentOutOfRangeException e) {
              Console.WriteLine(e.Message);
           }
        }
     }
     // The example displays the following output:
     //   Number of items: 0
     //   Index was out of range. Must be non-negative and less than the size of the collection.
     //   Parameter name: index
     

     open System
     
     
     let list = ResizeArray<string>()
     printfn $"Number of items: {list.Count}"
     try
         printfn $"The first item: '{list[0]}'"
     with 
     | :? ArgumentOutOfRangeException as e ->
         printfn $"{e.Message}"
     
     // The example displays the following output:
     //   Number of items: 0
     //   Index was out of range. Must be non-negative and less than the size of the collection. (Parameter 'index')
     

     Imports System.Collections.Generic
     
     Module Example
        Public Sub Main()
           Dim list As New List(Of String)
           Console.WriteLine("Number of items: {0}", list.Count)
           Try
              Console.WriteLine("The first item: '{0}'", list(0))
           Catch e As ArgumentOutOfRangeException
              Console.WriteLine(e.Message)
           End Try
        End Sub
     End Module
     ' The example displays the following output:
     '   Number of items: 0
     '   Index was out of range. Must be non-negative and less than the size of the collection.
     '   Parameter name: index
     

     Özel durumu önlemek için, aşağıdaki kod parçasında olduğu gibi herhangi bir üyeyi almaya çalışmadan önce koleksiyonun Count özelliğinin sıfırdan büyük olup olmadığını denetleyin.

     if (list.Count > 0)
        Console.WriteLine("The first item: '{0}'", list[0]);
     

     if list.Count > 0 then
         printfn $"The first item: '{list[0]}'"
     

     If list.Count > 0 Then
        Console.WriteLine("The first item: '{0}'", list(0))
     End If
     

  2. Bazı durumlarda, bu amaç için var olan gibi yöntemini çağırmak yerine var olmayan bir dizin kullanarak bir koleksiyona üye eklemeye çalıştığınızdan özel Adddurum oluşabilir. Aşağıdaki örnek, yöntemini çağırmak yerine var olmayan bir dizin kullanarak bir koleksiyona öğe eklemeye List<T>.Add çalışır.

     using System;
     using System.Collections.Generic;
     
     public class Example13
     {
        public static void Main()
        {
           var numbers = new List<int>();
           numbers.AddRange( new int[] { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 20 } );
     
           var squares = new List<int>();
           for (int ctr = 0; ctr < numbers.Count; ctr++)
              squares[ctr] = (int) Math.Pow(numbers[ctr], 2);
        }
     }
     // The example displays the following output:
     //    Unhandled Exception: System.ArgumentOutOfRangeException: Index was out of range. Must be non-negative and less than the size of the collection.
     //    Parameter name: index
     //       at System.ThrowHelper.ThrowArgumentOutOfRangeException(ExceptionArgument argument, ExceptionResource resource)
     //       at Example.Main()
     

     let numbers = ResizeArray<int>()
     numbers.AddRange [ 0; 1; 2; 3; 4; 5; 6; 7; 8; 9; 20 ]
     
     let squares = ResizeArray<int>()
     for  ctr = 0 to numbers.Count - 1 do
         squares[ctr] <- int (float numbers[ctr] ** 2)
     
     // The example displays the following output:
     //    Unhandled Exception: System.ArgumentOutOfRangeException: Index was out of range. Must be non-negative and less than the size of the collection. (Parameter 'index')
     //       at System.ThrowHelper.ThrowArgumentOutOfRangeException(ExceptionArgument argument, ExceptionResource resource)
     //       at <StartupCode$argumentoutofrangeexception>.$NoElements.main@()
     

     Imports System.Collections.Generic
     
     Module Example
        Public Sub Main()
           Dim numbers As New List(Of Integer)
           numbers.AddRange( { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 20 } )
           
           Dim squares As New List(Of Integer)
           For ctr As Integer = 0 To numbers.Count - 1
              squares(ctr) = CInt(numbers(ctr) ^ 2) 
           Next
        End Sub
     End Module
     ' The example displays the following output:
     '    Unhandled Exception: System.ArgumentOutOfRangeException: Index was out of range. Must be non-negative and less than the size of the collection.
     '    Parameter name: index
     '       at System.ThrowHelper.ThrowArgumentOutOfRangeException(ExceptionArgument argument, ExceptionResource resource)
     '       at Example.Main()
     

     Aşağıdaki kod parçası bu hatayı düzeltmektedir:

     var squares = new List<int>();
     for (int ctr = 0; ctr < numbers.Count; ctr++)
        squares.Add((int) Math.Pow(numbers[ctr], 2));
     

     let squares = ResizeArray<int>()
     for ctr = 0 to numbers.Count - 1 do
         squares.Add(int (float numbers[ctr] ** 2))
     

     Dim squares As New List(Of Integer)
     For ctr As Integer = 0 To numbers.Count - 1
        squares.Add(CInt(numbers(ctr) ^ 2)) 
     Next
     

  3. Dizini negatif olan bir öğeyi almaya çalışıyorsunuz. Bu durum genellikle belirli bir öğenin dizinini bir koleksiyonda aradığınız ve yanlışlıkla aramanın başarılı olduğunu varsaydığınız için oluşur. Aşağıdaki örnekte, yöntemine List<T>.FindIndex(Predicate<T>) yapılan çağrı "Z" değerine eşit bir dizeyi bulamadığından -1 döndürür. Ancak bu geçersiz bir dizin değeridir.

     using System;
     using System.Collections.Generic;
     
     public class Example
     {
        public static void Main()
        {
           var list = new List<string>();
           list.AddRange( new String[] { "A", "B", "C" } );
           // Get the index of the element whose value is "Z".
           int index = list.FindIndex((new StringSearcher("Z")).FindEquals);
           try {
              Console.WriteLine("Index {0} contains '{1}'", index, list[index]);
           }
           catch (ArgumentOutOfRangeException e) {
              Console.WriteLine(e.Message);
           }
        }
     }
     
     internal class StringSearcher
     {
        string value;
     
        public StringSearcher(string value)
        {
           this.value = value;
        }
     
        public bool FindEquals(string s)
        {
           return s.Equals(value, StringComparison.InvariantCulture);
        }
     }
     // The example displays the following output:
     //   Index was out of range. Must be non-negative and less than the size of the collection.
     //   Parameter name: index
     

     open System
     
     module StringSearcher =
         let findEquals (s: string) value =
             s.Equals(value, StringComparison.InvariantCulture)
     
     let list = ResizeArray<string>()
     list.AddRange [ "A"; "B"; "C" ]
     // Get the index of the element whose value is "Z".
     let index = list.FindIndex(StringSearcher.findEquals "Z")
     try 
         printfn $"Index {index} contains '{list[index]}'"
     with 
     | :? ArgumentOutOfRangeException as e ->
         printfn $"{e.Message}" 
     
     // The example displays the following output:
     //   Index was out of range. Must be non-negative and less than the size of the collection. (Parameter 'index')
     

     Imports System.Collections.Generic
     
     Module Example
        Public Sub Main()
           Dim list As New List(Of String) 
           list.AddRange( { "A", "B", "C" } )
           ' Get the index of the element whose value is "Z".
           Dim index As Integer = list.FindIndex(AddressOf (New StringSearcher("Z")).FindEquals)
           Try
              Console.WriteLine("Index {0} contains '{1}'", index, list(index)) 
           Catch e As ArgumentOutOfRangeException
              Console.WriteLine(e.Message)
           End Try
        End Sub
     End Module
     
     Friend Class StringSearcher
        Dim value As String
        
        Public Sub New(value As String)
           Me.value = value
        End Sub
        
        Public Function FindEquals(s As String) As Boolean
           Return s.Equals(value, StringComparison.InvariantCulture) 
        End Function
     End Class
     ' The example displays the following output:
     '   Index was out of range. Must be non-negative and less than the size of the collection.
     '   Parameter name: index
     

     Özel durumu önlemek için, aşağıdaki kod parçasında olduğu gibi öğeyi koleksiyondan almayı denemeden önce döndürülen dizinin sıfırdan büyük veya sıfıra eşit olduğundan emin olarak aramanın başarılı olup olmadığını denetleyin.

     // Get the index of the element whose value is "Z".
     int index = list.FindIndex((new StringSearcher("Z")).FindEquals);
     if (index >= 0)
        Console.WriteLine("'Z' is found at index {0}", list[index]);
     

     // Get the index of the element whose value is "Z".
     let index = list.FindIndex(StringSearcher.findEquals "Z")
     if index >= 0 then
         printfn $"'Z' is found at index {list[index]}"
     

     ' Get the index of the element whose value is "Z".
     Dim index As Integer = list.FindIndex(AddressOf (New StringSearcher("Z")).FindEquals)
     If index >= 0 Then
        Console.WriteLine("Index {0} contains '{1}'", index, list(index)) 
     End If
     

  4. Aşağıdaki örnekte gösterildiği gibi dizini koleksiyonun Count özelliğinin değerine eşit olan bir öğeyi almaya çalışıyorsunuz.

     using System;
     using System.Collections.Generic;
     
     public class Example8
     {
        public static void Main()
        {
           var list = new List<string>();
           list.AddRange( new String[] { "A", "B", "C" } );
           try {
              // Display the elements in the list by index.
              for (int ctr = 0; ctr <= list.Count; ctr++)
                 Console.WriteLine("Index {0}: {1}", ctr, list[ctr]);
           }
           catch (ArgumentOutOfRangeException e) {
              Console.WriteLine(e.Message);
           }
        }
     }
     // The example displays the following output:
     //   Index 0: A
     //   Index 1: B
     //   Index 2: C
     //   Index was out of range. Must be non-negative and less than the size of the collection.
     //   Parameter name: index
     

     open System
     
     let list = ResizeArray<string>()
     list.AddRange [ "A"; "B"; "C" ] 
     try
         // Display the elements in the list by index.
         for i = 0 to list.Count do
             printfn $"Index {i}: {list[i]}"
     with 
     | :? ArgumentOutOfRangeException as e ->
         printfn $"{e.Message}" 
           
     // The example displays the following output:
     //   Index 0: A
     //   Index 1: B
     //   Index 2: C
     //   Index was out of range. Must be non-negative and less than the size of the collection. (Parameter 'index')
     

     Imports System.Collections.Generic
     
     Module Example
        Public Sub Main()
           Dim list As New List(Of String) 
           list.AddRange( { "A", "B", "C" } )
           Try
              ' Display the elements in the list by index.
              For ctr As Integer = 0 To list.Count
                 Console.WriteLine("Index {0}: {1}", ctr, list(ctr)) 
              Next   
           Catch e As ArgumentOutOfRangeException
              Console.WriteLine(e.Message)
           End Try
        End Sub
     End Module
     ' The example displays the following output:
     '   Index 0: A
     '   Index 1: B
     '   Index 2: C
     '   Index was out of range. Must be non-negative and less than the size of the collection.
     '   Parameter name: index
     

     .NET'teki koleksiyonlar sıfır tabanlı dizin oluşturma kullandığından, koleksiyonun ilk öğesi dizin 0'da ve son öğe dizin Count - 1'dedir. Aşağıdaki kodda olduğu gibi dizin Count - 1'deki son öğeye erişdiğinizden emin olarak hatayı ortadan kaldırabilirsiniz.

     // Display the elements in the list by index.
     for (int ctr = 0; ctr < list.Count; ctr++)
        Console.WriteLine("Index {0}: {1}", ctr, list[ctr]);
     

     // Display the elements in the list by index.
     for i = 0 to list.Count - 1 do
         printfn $"Index {i}: {list[i]}"
     

     ' Display the elements in the list by index.
     For ctr As Integer = 0 To list.Count - 1 
        Console.WriteLine("Index {0}: {1}", ctr, list(ctr)) 
     Next
     

• Dize işleme yöntemini çağırarak bir dize işlemi gerçekleştirmeye çalışıyorsunuz ve başlangıç dizini dizede yok.

  İşlemin başlangıç dizinini belirtmenize olanak sağlayan , String.CompareOrdinal, String.IndexOfIndexOfAny, , String.Insert, String.LastIndexOf, , , RemoveString.LastIndexOfAnyString.Substring veya gibi String.Compareyöntemlerin aşırı yüklenmesi, dizinin dize içinde geçerli bir konum olmasını gerektirir. Geçerli dizinler 0 String.Length ile - 1 arasında değişir.

  Bu ArgumentOutOfRangeException özel durumun dört yaygın nedeni vardır:

  1. Boş bir dize veya String.Emptyile çalışıyorsunuz. String.Length Özelliği 0 döndürdüğünden, dizine göre işleme girişimi bir ArgumentOutOfRangeException özel durum oluşturur. Aşağıdaki örnek, bir dizenin ilk karakterini döndüren bir GetFirstCharacter yöntemi tanımlar. Dize boşsa, yönteme geçirilen son dize olduğu gibi, yöntem bir ArgumentOutOfRangeException özel durum oluşturur.

     using System;
     
     public class Example1
     {
         public static void Main()
         {
             String[] words = { "the", "today", "tomorrow", " ", "" };
             foreach (var word in words)
                 Console.WriteLine("First character of '{0}': '{1}'",
                                   word, GetFirstCharacter(word));
         }
     
         private static char GetFirstCharacter(string s)
         {
             return s[0];
         }
     }
     // The example displays the following output:
     //    First character of //the//: //t//
     //    First character of //today//: //t//
     //    First character of //tomorrow//: //t//
     //    First character of // //: // //
     //
     //    Unhandled Exception: System.IndexOutOfRangeException: Index was outside the bounds of the array.
     //       at Example.Main()
     

     open System
     
     let getFirstCharacter (s: string) = s[0]
     
     let words = [ "the"; "today"; "tomorrow"; " "; "" ]
     for word in words do
         printfn $"First character of '{word}': '{getFirstCharacter word}'"
     
     // The example displays the following output:
     //    First character of 'the': 't'
     //    First character of 'today': 't'
     //    First character of 'tomorrow': 't'
     //    First character of ' ': ' '
     //
     //    Unhandled Exception: System.IndexOutOfRangeException: Index was outside the bounds of the array.
     //       at <StartupCode$argumentoutofrangeexception>.$EmptyString1.main@()
     

     Module Example
        Public Sub Main()
            Dim words() As String = { "the", "today", "tomorrow", " ", "" }
            For Each word In words
               Console.WriteLine("First character of '{0}': '{1}'", 
                                 word, GetFirstCharacter(word))
            Next                     
        End Sub
        
        Private Function GetFirstCharacter(s As String) As Char
           Return s(0)
        End Function
     End Module
     ' The example displays the following output:
     '    First character of 'the': 't'
     '    First character of 'today': 't'
     '    First character of 'tomorrow': 't'
     '    First character of ' ': ' '
     '    
     '    Unhandled Exception: System.IndexOutOfRangeException: Index was outside the bounds of the array.
     '       at Example.Main()
     

     Dizenin sıfırdan büyük olup olmadığını test ederek veya dizenin String.Length boş veya boş olmadığından null emin olmak için yöntemini çağırarak IsNullOrEmpty özel durumu ortadan kaldırabilirsiniz. Aşağıdaki kod parçası ikincisini yapar. Bu durumda, dize null boşsa veya boşsa yöntemi GetFirstCharacter U+0000 döndürür.

     static char GetFirstCharacter(string s)
     {
         if (string.IsNullOrEmpty(s))
             return '\u0000';
         else
             return s[0];
     }
     

     let getFirstCharacter (s: string) =
        if String.IsNullOrEmpty s then
           '\u0000'
        else
           s[0]
     

     Function GetFirstCharacter(s As String) As Char
        If String.IsNullOrEmpty(s) Then 
           Return ChrW(0)
        Else   
           Return s(0)
        End If   
     End Function
     

  2. Bir dizeyi, bu dize içindeki bir alt dizenin konumuna göre işliyor ve alt dizenin gerçekten bulunup bulunmadığını belirleyemediniz.

     Aşağıdaki örnek, iki sözcüklü bir tümceciğin ikinci sözcüğünü ayıklar. Tümcecik yalnızca bir ArgumentOutOfRangeException sözcükden oluşuyorsa ve bu nedenle eklenmiş bir boşluk karakteri içermiyorsa bir özel durum oluşturur. Bunun nedeni, yöntemine yapılan çağrının aramanın String.IndexOf(String) başarısız olduğunu belirtmek için -1 döndürmesi ve bu geçersiz değerin yöntemine String.Substring(Int32) geçirilmesidir.

     using System;
     
     public class Example17
     {
        public static void Main()
        {
           String[] phrases = { "ocean blue", "concerned citizen",
                                "runOnPhrase" };
           foreach (var phrase in phrases)
              Console.WriteLine("Second word is {0}", GetSecondWord(phrase));
        }
     
        static string GetSecondWord(string s)
        {
           int pos = s.IndexOf(" ");
           return s.Substring(pos).Trim();
        }
     }
     // The example displays the following output:
     //    Second word is blue
     //    Second word is citizen
     //
     //    Unhandled Exception: System.ArgumentOutOfRangeException: StartIndex cannot be less than zero.
     //    Parameter name: startIndex
     //       at System.String.Substring(Int32 startIndex, Int32 length)
     //       at Example17.GetSecondWord(String s)
     //       at Example17.Main()
     

     let getSecondWord (s: string) =
         let pos = s.IndexOf " "
         s.Substring(pos).Trim()
     
     let phrases = [ "ocean blue"; "concerned citizen"; "runOnPhrase" ]
     for phrase in phrases do
         printfn $"Second word is {getSecondWord phrase}"
     
     // The example displays the following output:
     //    Second word is blue
     //    Second word is citizen
     //
     //    Unhandled Exception: System.ArgumentOutOfRangeException: StartIndex cannot be less than zero. (Parameter 'startIndex')
     //       at System.String.Substring(Int32 startIndex, Int32 length)
     //       at System.String.Substring(Int32 startIndex)
     //       at NoFind1.getSecondWord(String s)
     //       at <StartupCode$argumentoutofrangeexception>.$NoFind1.main@()
     

     Module Example
        Public Sub Main()
           Dim phrases() As String = { "ocean blue", "concerned citizen", 
                                       "runOnPhrase" }
           For Each phrase In phrases
              Console.WriteLine("Second word is {0}", GetSecondWord(phrase))
           Next                            
       End Sub
       
       Function GetSecondWord(s As String) As String
          Dim pos As Integer = s.IndexOf(" ")
          Return s.Substring(pos).Trim()
       End Function
     End Module
     ' The example displays the following output:
     '       Second word is blue
     '       Second word is citizen
     '       
     '       Unhandled Exception: System.ArgumentOutOfRangeException: StartIndex cannot be less than zero.
     '       Parameter name: startIndex
     '          at System.String.Substring(Int32 startIndex, Int32 length)
     '          at Example.GetSecondWord(String s)
     '          at Example.Main()
     

     Özel durumu ortadan kaldırmak için dize işleme yöntemini çağırmadan önce dize arama yöntemi tarafından döndürülen değeri doğrulayın.

     using System;
     
     public class Example18
     {
        public static void Main()
        {
           String[] phrases = { "ocean blue", "concerned citizen",
                                "runOnPhrase" };
           foreach (var phrase in phrases) {
              string word = GetSecondWord(phrase);
              if (! string.IsNullOrEmpty(word))
                 Console.WriteLine("Second word is {0}", word);
           }
        }
     
        static string GetSecondWord(string s)
        {
           int pos = s.IndexOf(" ");
           if (pos >= 0)
              return s.Substring(pos).Trim();
           else
              return string.Empty;
        }
     }
     // The example displays the following output:
     //       Second word is blue
     //       Second word is citizen
     

     open System
     
     let getSecondWord (s: string) =
         let pos = s.IndexOf " "
         if pos >= 0 then
             s.Substring(pos).Trim()
         else 
             String.Empty
     
     let phrases = [ "ocean blue"; "concerned citizen"; "runOnPhrase" ]
     for phrase in phrases do
         let word = getSecondWord phrase
         if not (String.IsNullOrEmpty word) then
             printfn $"Second word is {word}"
     
     // The example displays the following output:
     //       Second word is blue
     //       Second word is citizen
     

     Module Example
        Public Sub Main()
           Dim phrases() As String = { "ocean blue", "concerned citizen", 
                                       "runOnPhrase" }
           For Each phrase In phrases
              Dim word As String = GetSecondWord(phrase)
              If Not String.IsNullOrEmpty(word) Then _
                 Console.WriteLine("Second word is {0}", word)
           Next                            
        End Sub
       
        Function GetSecondWord(s As String) As String
           Dim pos As Integer = s.IndexOf(" ")
           If pos >= 0
               Return s.Substring(pos).Trim()
           Else
              Return String.Empty
           End If
       End Function
     End Module
     ' The example displays the following output:
     '       Second word is blue
     '       Second word is citizen
     

  3. Geçerli dize aralığının dışında bir alt dize ayıklamayı denediniz.

     Alt dizeleri ayıklayan yöntemlerin tümü, alt dizenin başlangıç konumunu ve dizenin sonuna kadar devam etmeyen alt dizeler için alt dizedeki karakter sayısını belirtmenizi gerektirir. Bunun alt dizedeki son karakterin dizini olmadığını unutmayın.

     ArgumentOutOfRangeException Bu durumda genellikle bir özel durum oluşturulur çünkü alt dizedeki karakter sayısını yanlış hesaplamış olursunuz. Bir alt dizenin başlangıç ve bitiş konumlarını belirlemek için gibi String.IndexOf bir arama yöntemi kullanıyorsanız:

     • tarafından döndürülen String.IndexOf bitiş konumundaki karakter alt dizeye dahil edilecekse, alt dizenin bitiş konumu formül tarafından verilir

       endIndex - startIndex + 1
       

     • tarafından döndürülen String.IndexOf bitiş konumundaki karakter alt dizenin dışında tutulacaksa, alt dizenin bitiş konumu formül tarafından verilir

       endIndex - startIndex
       

       Aşağıdaki örnek, bir FindWords dizedeki String.IndexOfAny(Char[], Int32) boşluk karakterlerini ve noktalama işaretlerini tanımlamak için yöntemini kullanan bir yöntemi tanımlar ve dizede bulunan sözcükleri içeren bir dizi döndürür.

       using System;
       using System.Collections.Generic;
       
       public class Example19
       {
          public static void Main()
          {
             string sentence = "This is a simple, short sentence.";
             Console.WriteLine("Words in '{0}':", sentence);
             foreach (var word in FindWords(sentence))
                Console.WriteLine("   '{0}'", word);
          }
       
          static String[] FindWords(string s)
          {
             int start = 0, end = 0;
             Char[] delimiters = { ' ', '.', ',', ';', ':', '(', ')' };
             var words = new List<string>();
       
             while (end >= 0) {
                end = s.IndexOfAny(delimiters, start);
                if (end >= 0) {
                   if (end - start > 0)
                      words.Add(s.Substring(start, end - start));
       
                   start = end + 1;
                }
                else {
                   if (start < s.Length - 1)
                      words.Add(s.Substring(start));
                }
             }
             return words.ToArray();
          }
       }
       // The example displays the following output:
       //       Words in 'This is a simple, short sentence.':
       //          'This'
       //          'is'
       //          'a'
       //          'simple'
       //          'short'
       //          'sentence'
       

       
       let findWords (s: string) =
           let mutable start, end' = 0, 0
           let delimiters = [| ' '; '.'; ','; ';'; ':'; '('; ')' |]
           let words = ResizeArray<string>()
           while end' >= 0 do
               end' <- s.IndexOfAny(delimiters, start)
               if end' >= 0 then
                   if end' - start > 0 then
                       words.Add(s.Substring(start, end' - start))
                   start <- end' + 1
               elif start < s.Length - 1 then
                   words.Add(s.Substring start)
           words.ToArray()
       
       let sentence = "This is a simple, short sentence."
       printfn $"Words in '{sentence}':"
       for word in findWords sentence do
           printfn $"   '{word}'"
       
       // The example displays the following output:
       //       Words in 'This is a simple, short sentence.':
       //          'This'
       //          'is'
       //          'a'
       //          'simple'
       //          'short'
       //          'sentence'
       

       Imports System.Collections.Generic
       
       Module Example
          Public Sub Main()
             Dim sentence As String = "This is a simple, short sentence."
             Console.WriteLine("Words in '{0}':", sentence)
             For Each word In FindWords(sentence)
                Console.WriteLine("   '{0}'", word)
             Next
          End Sub
          
          Function FindWords(s As String) As String()
             Dim start, ending As Integer
             Dim delimiters() As Char = { " "c, "."c, ","c, ";"c, ":"c,
                                          "("c, ")"c }
             Dim words As New List(Of String)()
       
             Do While ending >= 0
                ending = s.IndexOfAny(delimiters, start)
                If ending >= 0
                   If ending - start > 0 Then
                      words.Add(s.Substring(start, ending - start)) 
                   End If
                   start = ending + 1
                Else
                   If start < s.Length - 1 Then
                      words.Add(s.Substring(start))
                   End If      
                End If
             Loop    
             Return words.ToArray()                         
          End Function
       End Module
       ' The example displays the following output:
       '       Words in 'This is a simple, short sentence.':
       '          'This'
       '          'is'
       '          'a'
       '          'simple'
       '          'short'
       '          'sentence'
       

• Yalnızca pozitif sayılar ve sıfır gerektiren bir bağımsız değişkeni olan bir yönteme negatif bir sayı geçirdiniz veya yalnızca pozitif sayılar gerektiren bir bağımsız değişkeni olan bir yönteme negatif bir sayı veya sıfır geçirdiniz.

  Örneğin, yöntemi iki Array.CreateInstance(Type, Int32, Int32, Int32) boyutlu bir dizinin her boyutundaki öğe sayısını belirtmenizi gerektirir; her boyut için geçerli değerler 0 Int32.MaxValueile arasında değişebilir. Ancak aşağıdaki örnekteki boyut bağımsız değişkeni negatif bir değere sahip olduğundan, yöntem bir ArgumentOutOfRangeException özel durum oluşturur.

  using System;
  
  public class Example01
  {
      public static void Main()
      {
          int dimension1 = 10;
          int dimension2 = -1;
          try
          {
              Array arr = Array.CreateInstance(typeof(string),
                                               dimension1, dimension2);
          }
          catch (ArgumentOutOfRangeException e)
          {
              if (e.ActualValue != null)
                  Console.WriteLine("{0} is an invalid value for {1}: ", e.ActualValue, e.ParamName);
              Console.WriteLine(e.Message);
          }
      }
  }
  // The example displays the following output:
  //     Non-negative number required.
  //     Parameter name: length2
  

  open System
  
  let dimension1 = 10
  let dimension2 = -1
  try
      let arr = Array.CreateInstance(typeof<string>, dimension1, dimension2)
      printfn "%A" arr
  with 
  | :? ArgumentOutOfRangeException as e ->
      if not (isNull e.ActualValue) then
          printfn $"{e.ActualValue} is an invalid value for {e.ParamName}: "
      printfn $"{e.Message}"
  
  // The example displays the following output:
  //     Non-negative number required. (Parameter 'length2')
  

  Module Example
     Public Sub Main()
        Dim dimension1 As Integer = 10
        Dim dimension2 As Integer = -1
        Try
           Dim arr AS Array = Array.CreateInstance(GetType(String), 
                                                   dimension1, dimension2)
        Catch e As ArgumentOutOfRangeException
           If e.ActualValue IsNot Nothing Then
              Console.WriteLine("{0} is an invalid value for {1}: ", 
                                e.ActualValue, e.ParamName)
           End If                     
           Console.WriteLine(e.Message)
        End Try
     End Sub
  End Module
  ' The example displays the following output:
  '     Non-negative number required.
  '     Parameter name: length2
  

  Hatayı düzeltmek için geçersiz bağımsız değişkenin değerinin negatif olmamasını sağlayın. Bunu, aşağıdaki kod parçasının yaptığı gibi geçerli bir değer sağlayarak yapabilirsiniz.

  int dimension1 = 10;
  int dimension2 = 10;
  Array arr = Array.CreateInstance(typeof(string),
                                   dimension1, dimension2);
  

  let dimension1 = 10
  let dimension2 = 10
  let arr = Array.CreateInstance(typeof<string>, dimension1, dimension2)
  printfn "%A" arr
  

  Dim dimension1 As Integer = 10
  Dim dimension2 As Integer = 10
  Dim arr As Array = Array.CreateInstance(GetType(String), 
                                          dimension1, dimension2)
  

  Ayrıca girişi doğrulayabilir ve geçersizse bazı eylemler gerçekleştirebilirsiniz. Aşağıdaki kod parçası yöntemini çağırmak yerine bir hata iletisi görüntüler.

  if (dimension1 < 0 || dimension2 < 0)
  {
      Console.WriteLine("Unable to create the array.");
      Console.WriteLine("Specify non-negative values for the two dimensions.");
  }
  else
  {
      arr = Array.CreateInstance(typeof(string),
                                 dimension1, dimension2);
  }
  

  if dimension1 < 0 || dimension2 < 0 then
      printfn "Unable to create the array."
      printfn "Specify non-negative values for the two dimensions."
  else
      let arr = Array.CreateInstance(typeof<string>, dimension1, dimension2)
      printfn "%A" arr
  

  If dimension1 < 0 OrElse dimension2 < 0 Then
     Console.WriteLine("Unable to create the array.")
     Console.WriteLine("Specify non-negative values for the two dimensions.")
  Else
     arr = Array.CreateInstance(GetType(String), 
                                dimension1, dimension2)   
  End If
  

• Çok iş parçacıklı veya zaman uyumsuz olarak yürütülen ve bir diziyi veya koleksiyonu güncelleştiren görevleri olan bir uygulamada yarış durumu vardır.

  Aşağıdaki örnek, bir List<T> nesne koleksiyonunu Continent doldurmak için bir nesnesi kullanır. Örnek, koleksiyon tam olarak doldurulmadan önce koleksiyondaki yedi öğeyi görüntülemeye çalışırsa bir ArgumentOutOfRangeException oluşturur.

  using System;
  using System.Collections.Generic;
  using System.Threading;
  
  public class Continent
  {
     public string? Name { get; set; }
     public int Population { get; set; }
     public Decimal Area { get; set; }
  }
  
  public class Example11
  {
     static List<Continent> continents = new List<Continent>();
     static string? s_msg;
  
     public static void Main()
     {
        String[] names = { "Africa", "Antarctica", "Asia",
                           "Australia", "Europe", "North America",
                           "South America" };
        // Populate the list.
        foreach (var name in names) {
           var th = new Thread(PopulateContinents);
           th.Start(name);
        }
        Console.WriteLine(s_msg);
        Console.WriteLine();
  
        // Display the list.
        for (int ctr = 0; ctr < names.Length; ctr++) {
           var continent = continents[ctr];
           Console.WriteLine("{0}: Area: {1}, Population {2}",
                             continent.Name, continent.Population,
                             continent.Area);
        }
     }
  
     private static void PopulateContinents(Object? obj)
     {
        string? name = obj?.ToString();
        s_msg += string.Format("Adding '{0}' to the list.\n", name);
        var continent = new Continent();
        continent.Name = name;
        // Sleep to simulate retrieving remaining data.
        Thread.Sleep(50);
        continents.Add(continent);
     }
  }
  // The example displays output like the following:
  //    Adding //Africa// to the list.
  //    Adding //Antarctica// to the list.
  //    Adding //Asia// to the list.
  //    Adding //Australia// to the list.
  //    Adding //Europe// to the list.
  //    Adding //North America// to the list.
  //    Adding //South America// to the list.
  //
  //
  //
  //    Unhandled Exception: System.ArgumentOutOfRangeException: Index was out of range. Must be non-negative and less than the size of the collection.
  //    Parameter name: index
  //       at System.ThrowHelper.ThrowArgumentOutOfRangeException(ExceptionArgument argument, ExceptionResource resource)
  //       at Example.Main()
  

  open System.Threading
  
  type Continent =
      { Name: string
        Population: int
        Area: decimal }
  
  let continents = ResizeArray<Continent>()
  let mutable msg = ""
  
  let names = 
      [ "Africa"; "Antarctica"; "Asia"
        "Australia"; "Europe"; "North America"
        "South America" ]
  
  let populateContinents obj = 
      let name = string obj
      msg <- msg + $"Adding '{name}' to the list.\n"
      // Sleep to simulate retrieving data.
      Thread.Sleep 50
      let continent = 
          { Name = name
            Population = 0
            Area = 0M }
      continents.Add continent
        
  // Populate the list.
  for name in names do
      let th = Thread(ParameterizedThreadStart populateContinents)
      th.Start name
        
  printfn $"{msg}\n"
  
  // Display the list.
  for i = 0 to names.Length - 1 do
      let continent = continents[i]
      printfn $"{continent.Name}: Area: {continent.Population}, Population {continent.Area}"
  
  // The example displays output like the following:
  //    Unhandled Exception: System.ArgumentOutOfRangeException: Index was out of range. Must be non-negative and less than the size of the collection. (Parameter 'index')
  //       at System.Collections.Generic.List`1.get_Item(Int32 index)
  //       at <StartupCode$argumentoutofrangeexception>.$Race1.main@()
  

  Imports System.Collections.Generic
  Imports System.Threading
  
  Public Class Continent
     Public Property Name As String
     Public Property Population As Integer
     Public Property Area As Decimal  
  End Class
  
  Module Example
     Dim continents As New List(Of Continent)
     Dim msg As String 
        
     Public Sub Main()
        Dim names() As String = { "Africa", "Antarctica", "Asia", 
                                       "Australia", "Europe", "North America",
                                       "South America" }
        ' Populate the list.
        For Each name In names
           Dim th As New Thread(AddressOf PopulateContinents)
           th.Start(name)
        Next              
        Console.WriteLine(msg)
        Console.WriteLine()
  
        ' Display the list.
        For ctr As Integer = 0 To names.Length - 1
           Dim continent = continents(ctr)
           Console.WriteLine("{0}: Area: {1}, Population {2}", 
                             continent.Name, continent.Population,
                             continent.Area)
        Next
     End Sub
     
     Private Sub PopulateContinents(obj As Object)
        Dim name As String = obj.ToString()
        msg += String.Format("Adding '{0}' to the list.{1}", name, vbCrLf)
        Dim continent As New Continent()
        continent.Name = name
        ' Sleep to simulate retrieving remaining data.
        Thread.Sleep(50)
        continents.Add(continent)
     End Sub
  End Module
  ' The example displays output like the following:
  '    Adding 'Africa' to the list.
  '    Adding 'Antarctica' to the list.
  '    Adding 'Asia' to the list.
  '    Adding 'Australia' to the list.
  '    Adding 'Europe' to the list.
  '    Adding 'North America' to the list.
  '    Adding 'South America' to the list.
  '    
  '    
  '    
  '    Unhandled Exception: System.ArgumentOutOfRangeException: Index was out of range. Must be non-negative and less than the size of the collection.
  '    Parameter name: index
  '       at System.ThrowHelper.ThrowArgumentOutOfRangeException(ExceptionArgument argument, ExceptionResource resource)
  '       at Example.Main()
  

  Bu durumda, birden çok iş parçacığından iki kaynağa erişilir:

  • continents topluluğu. Yöntemi List<T>.Add birden çok iş parçacığından çağrılır. Buna ek olarak, ana veya birincil iş parçacığı, üyelerini yinelediğinde koleksiyonun yedi öğeyle tamamen doldurulduğundan varsayılır.

  • msg Birden çok iş parçacığından birleştirilmiş dize.

  Hatayı düzeltmek için, paylaşılan duruma aşağıdaki gibi iş parçacığı güvenli bir şekilde erişildiğinden emin olun.

  • Uygulamanız bir dizi veya koleksiyon nesnesi kullanıyorsa, ad alanı veya System.Collections.Immutable bant dışı sürüm türleri System.Collections.Concurrent gibi iş parçacığı açısından güvenli bir koleksiyon sınıfı kullanmayı göz önünde bulundurun.

  • Paylaşılan duruma (yani birden çok iş parçacığı tarafından erişilebilen kaynaklara) iş parçacığı açısından güvenli bir şekilde erişildiğinden emin olun; böylece kaynaklara tek seferde yalnızca bir iş parçacığı özel erişime sahip olur. Kaynaklara erişimi eşitlemek için , Interlocked, Monitorve Mutexgibi CountdownEventçok sayıda sınıf kullanılabilir. Daha fazla bilgi için bkz. İş Parçacığı Oluşturma. Ayrıca, C# dilindeki lock deyimi ve Visual Basic'teki SyncLock yapısı aracılığıyla dil desteği sağlanır.

  Aşağıdaki örnek, önceki örnekteki ArgumentOutOfRangeException ve diğer sorunları giderir. Koleksiyona erişimin List<T> iş parçacığı güvenli olduğundan emin olmak için nesnesini bir ConcurrentBag<T> nesneyle değiştirir, uygulama iş parçacığının yalnızca diğer iş parçacıkları yürütüldükten sonra devam etmesini sağlamak için bir CountdownEvent nesnesi kullanır ve bir kerede yalnızca bir iş parçacığının msg değişkene erişebilmesini sağlamak için bir kilit kullanır.

  using System;
  using System.Collections.Concurrent;
  using System.Threading;
  
  public class ContinentD
  {
     public string? Name { get; set; }
     public int Population { get; set; }
     public Decimal Area { get; set; }
  }
  
  public class Example12
  {
     static ConcurrentBag<ContinentD> ContinentDs = new ConcurrentBag<ContinentD>();
     static CountdownEvent? gate;
     static string msg = string.Empty;
  
     public static void Main()
     {
        String[] names = { "Africa", "Antarctica", "Asia",
                           "Australia", "Europe", "North America",
                           "South America" };
        gate = new CountdownEvent(names.Length);
  
        // Populate the list.
        foreach (var name in names) {
           var th = new Thread(PopulateContinentDs);
           th.Start(name);
        }
  
        // Display the list.
        gate.Wait();
        Console.WriteLine(msg);
        Console.WriteLine();
  
        var arr = ContinentDs.ToArray();
        for (int ctr = 0; ctr < names.Length; ctr++) {
           var ContinentD = arr[ctr];
           Console.WriteLine("{0}: Area: {1}, Population {2}",
                             ContinentD.Name, ContinentD.Population,
                             ContinentD.Area);
        }
     }
  
     private static void PopulateContinentDs(Object? obj)
     {
        string? name = obj?.ToString();
        lock(msg) {
           msg += string.Format("Adding '{0}' to the list.\n", name);
        }
        var ContinentD = new ContinentD();
        ContinentD.Name = name;
        // Sleep to simulate retrieving remaining data.
        Thread.Sleep(25);
        ContinentDs.Add(ContinentD);
        gate?.Signal();
     }
  }
  // The example displays output like the following:
  //       Adding 'Africa' to the list.
  //       Adding 'Antarctica' to the list.
  //       Adding 'Asia' to the list.
  //       Adding 'Australia' to the list.
  //       Adding 'Europe' to the list.
  //       Adding 'North America' to the list.
  //       Adding 'South America' to the list.
  //
  //
  //       Africa: Area: 0, Population 0
  //       Antarctica: Area: 0, Population 0
  //       Asia: Area: 0, Population 0
  //       Australia: Area: 0, Population 0
  //       Europe: Area: 0, Population 0
  //       North America: Area: 0, Population 0
  //       South America: Area: 0, Population 0
  

  open System.Collections.Concurrent
  open System.Threading
  
  type Continent =
      { Name: string
        Population: int
        Area: decimal }
  
  let continents = ConcurrentBag<Continent>();
  let mutable msg = ""
  
  let names = 
      [ "Africa"; "Antarctica"; "Asia"
        "Australia"; "Europe"; "North America"
        "South America" ]
  
  let gate = new CountdownEvent(names.Length)
  
  let populateContinents obj = 
      let name = string obj
      lock msg (fun () -> 
          msg <- msg + $"Adding '{name}' to the list.\n" )
  
      // Sleep to simulate retrieving remaining data.
      let continent = 
          { Name = name
            Population = 0
            Area = 0M }
      Thread.Sleep 25
      continents.Add continent
      gate.Signal() |> ignore
  
  // Populate the list.
  for name in names do
      let th = Thread(ParameterizedThreadStart populateContinents)
      th.Start name
  
  // Display the list.
  gate.Wait();
  printfn $"{msg}\n"
  
  let arr = continents.ToArray();
  for i = 0 to names.Length - 1 do
      let continent = arr[i]
      printfn $"{continent.Name}: Area: {continent.Population}, Population {continent.Area}"
  
  // The example displays output like the following:
  //       Adding 'Africa' to the list.
  //       Adding 'Antarctica' to the list.
  //       Adding 'Asia' to the list.
  //       Adding 'Australia' to the list.
  //       Adding 'Europe' to the list.
  //       Adding 'North America' to the list.
  //       Adding 'South America' to the list.
  //
  //
  //       Africa: Area: 0, Population 0
  //       Antarctica: Area: 0, Population 0
  //       Asia: Area: 0, Population 0
  //       Australia: Area: 0, Population 0
  //       Europe: Area: 0, Population 0
  //       North America: Area: 0, Population 0
  //       South America: Area: 0, Population 0
  

  Imports System.Collections.Concurrent
  Imports System.Threading
  
  Public Class Continent
     Public Property Name As String
     Public Property Population As Integer
     Public Property Area As Decimal  
  End Class
  
  Module Example
     Dim continents As New ConcurrentBag(Of Continent)
     Dim gate As CountdownEvent
     Dim msg As String = String.Empty
        
     Public Sub Main()
        Dim names() As String = { "Africa", "Antarctica", "Asia", 
                                  "Australia", "Europe", "North America",
                                  "South America" }
        gate = new CountdownEvent(names.Length)
        
        ' Populate the list.
        For Each name In names
           Dim th As New Thread(AddressOf PopulateContinents)
           th.Start(name)
        Next              
  
        ' Display the list.
        gate.Wait()
        Console.WriteLine(msg)
        Console.WriteLine()
  
        For ctr As Integer = 0 To names.Length - 1
           Dim continent = continents(ctr)
           Console.WriteLine("{0}: Area: {1}, Population {2}", 
                             continent.Name, continent.Population,
                             continent.Area)
        Next
     End Sub
     
     Private Sub PopulateContinents(obj As Object)
        Dim name As String = obj.ToString()
        SyncLock msg 
           msg += String.Format("Adding '{0}' to the list.{1}", name, vbCrLf)
        End SyncLock
        Dim continent As New Continent()
        continent.Name = name
        ' Sleep to simulate retrieving remaining data.
        Thread.Sleep(25)
        continents.Add(continent)
        gate.Signal()
     End Sub
  End Module
  ' The example displays output like the following:
  '    Adding 'Africa' to the list.
  '    Adding 'Antarctica' to the list.
  '    Adding 'Asia' to the list.
  '    Adding 'Australia' to the list.
  '    Adding 'Europe' to the list.
  '    Adding 'North America' to the list.
  '    Adding 'South America' to the list.
  '    
  '    
  '    Africa: Area: 0, Population 0
  '    Antarctica: Area: 0, Population 0
  '    Asia: Area: 0, Population 0
  '    Australia: Area: 0, Population 0
  '    Europe: Area: 0, Population 0
  '    North America: Area: 0, Population 0
  '    South America: Area: 0, Population 0
  

ArgumentOutOfRangeException değeri 0x80131502 olan HRESULT COR_E_ARGUMENTOUTOFRANGE kullanır.

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

Oluşturucular

Özellikler

Yöntemler

Ekinlikler

Şunlara uygulanır

Ayrıca bkz.

• Exception