IndexOutOfRangeException Třída

Definice

Obor názvů:

System

Sestavení:

netstandard.dll, System.Runtime.dll

Zdroj:

IndexOutOfRangeException.cs

Výjimka, která se vyvolá při pokusu o přístup k prvku pole nebo kolekce s indexem, který je mimo jeho hranice.

public ref class IndexOutOfRangeException sealed : SystemException

public sealed class IndexOutOfRangeException : SystemException

type IndexOutOfRangeException = class
    inherit SystemException

Public NotInheritable Class IndexOutOfRangeException
Inherits SystemException

Dědičnost

Object

Exception

SystemException

IndexOutOfRangeException

Poznámky

Výjimka IndexOutOfRangeException se vyvolá, když se pro přístup k členu pole nebo kolekce používá neplatný index nebo ke čtení nebo zápisu z konkrétního umístění ve vyrovnávací paměti. Tato výjimka dědí z Exception třídy, ale nepřidá žádné jedinečné členy.

Obvykle se v IndexOutOfRangeException důsledku chyby vývojáře vyvolá výjimka. Místo zpracování výjimky byste měli diagnostikovat příčinu chyby a opravit kód. Mezi nejběžnější příčiny chyby patří:

• Zapomeňte, že horní mez kolekce nebo pole založené na nule je jedna menší než počet členů nebo prvků, jak ukazuje následující příklad.

  using System;
  using System.Collections.Generic;
  
  public class Example
  {
     public static void Main()
     {
        List<Char> characters = new List<Char>();
        characters.InsertRange(0, new Char[] { 'a', 'b', 'c', 'd', 'e', 'f' } );
        for (int ctr = 0; ctr <= characters.Count; ctr++)
           Console.Write("'{0}'    ", characters[ctr]);
     }
  }
  // The example displays the following output:
  //    'a'    'b'    'c'    'd'    'e'    'f'
  //    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 Example.Main()
  

  let characters = ResizeArray()
  characters.InsertRange(0, [| 'a'; 'b'; 'c'; 'd'; 'e'; 'f' |])
  
  for i = 0 to characters.Count do
      printf $"'{characters[i]}'    "
  // The example displays the following output:
  //    'a'    'b'    'c'    'd'    'e'    'f'
  //    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 <StartupCode$fs>.main@()
  

  Imports System.Collections.Generic
  
  Module Example
     Public Sub Main()
        Dim characters As New List(Of Char)()
        characters.InsertRange(0, { "a"c, "b"c, "c"c, "d"c, "e"c, "f"c} )
        For ctr As Integer = 0 To characters.Count
           Console.Write("'{0}'    ", characters(ctr))
        Next
     End Sub
  End Module
  ' The example displays the following output:
  '    'a'    'b'    'c'    'd'    'e'    'f'
  '    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.Collections.Generic.List`1.get_Item(Int32 index)
  '       at Example.Main()
  

  Pokud chcete chybu opravit, můžete použít kód podobný následujícímu.

  using System;
  using System.Collections.Generic;
  
  public class Example
  {
     public static void Main()
     {
        List<Char> characters = new List<Char>();
        characters.InsertRange(0, new Char[] { 'a', 'b', 'c', 'd', 'e', 'f' } );
        for (int ctr = 0; ctr < characters.Count; ctr++)
           Console.Write("'{0}'    ", characters[ctr]);
     }
  }
  // The example displays the following output:
  //        'a'    'b'    'c'    'd'    'e'    'f'
  

  let characters = ResizeArray()
  characters.InsertRange(0, [| 'a'; 'b'; 'c'; 'd'; 'e'; 'f' |])
  
  for i = 0 to characters.Count - 1 do
      printf $"'{characters[i]}'    "
  // The example displays the following output:
  //        'a'    'b'    'c'    'd'    'e'    'f'
  

  Imports System.Collections.Generic
  
  Module Example
     Public Sub Main()
        Dim characters As New List(Of Char)()
        characters.InsertRange(0, { "a"c, "b"c, "c"c, "d"c, "e"c, "f"c} )
        For ctr As Integer = 0 To characters.Count - 1
           Console.Write("'{0}'    ", characters(ctr))
        Next
     End Sub
  End Module
  ' The example displays the following output:
  '       'a'    'b'    'c'    'd'    'e'    'f'
  

  Místo iterace všech prvků v matici pomocí jejich indexu můžete použít foreach příkaz (v jazyce C#), for...in příkaz (v jazyce F#) nebo For Each příkaz (v jazyce Visual Basic).

• Při pokusu o přiřazení prvku pole k jiné matici, která nebyla adekvátně kótována a která má méně prvků než původní pole. Následující příklad se pokusí přiřadit poslední prvek v value1 poli stejnému value2 prvku v poli. Matice je však nesprávně kótována tak, value2 aby měla šest namísto sedmi prvků. V důsledku toho přiřazení vyvolá IndexOutOfRangeException výjimku.

  public class Example
  {
     public static void Main()
     {
        int[] values1 = { 3, 6, 9, 12, 15, 18, 21 };
        int[] values2 = new int[6];
  
        // Assign last element of the array to the new array.
        values2[values1.Length - 1] = values1[values1.Length - 1];
     }
  }
  // The example displays the following output:
  //       Unhandled Exception:
  //       System.IndexOutOfRangeException:
  //       Index was outside the bounds of the array.
  //       at Example.Main()
  

  let values1 = [| 3; 6; 9; 12; 15; 18; 21 |]
  let values2 = Array.zeroCreate<int> 6
  
  // Assign last element of the array to the new array.
  values2[values1.Length - 1] <- values1[values1.Length - 1];
  // The example displays the following output:
  //       Unhandled Exception:
  //       System.IndexOutOfRangeException:
  //       Index was outside the bounds of the array.
  //       at <StartupCode$fs>.main@()
  

  Module Example
     Public Sub Main()
        Dim values1() As Integer = { 3, 6, 9, 12, 15, 18, 21 }
        Dim values2(5) As Integer
        
        ' Assign last element of the array to the new array.
        values2(values1.Length - 1) = values1(values1.Length - 1)
     End Sub
  End Module
  ' The example displays the following output:
  '       Unhandled Exception: 
  '       System.IndexOutOfRangeException: 
  '       Index was outside the bounds of the array.
  '       at Example.Main()
  

• Použití hodnoty vrácené vyhledávací metodou k iteraci části pole nebo kolekce začínající na konkrétní pozici indexu. Pokud zapomenete zkontrolovat, jestli operace hledání našla shodu, modul runtime vyvolá IndexOutOfRangeException výjimku, jak je znázorněno v tomto příkladu.

  using System;
  using System.Collections.Generic;
  
  public class Example
  {
     static List<int> numbers = new List<int>();
  
     public static void Main()
     {
        int startValue;
        string[] args = Environment.GetCommandLineArgs();
        if (args.Length < 2)
           startValue = 2;
        else
           if (!Int32.TryParse(args[1], out startValue))
              startValue = 2;
  
        ShowValues(startValue);
     }
  
     private static void ShowValues(int startValue)
     {
        // Create a collection with numeric values.
        if (numbers.Count == 0)
           numbers.AddRange( new int[] { 2, 4, 6, 8, 10, 12, 14, 16, 18, 20, 22} );
  
        // Get the index of a startValue.
        Console.WriteLine("Displaying values greater than or equal to {0}:",
                          startValue);
        int startIndex = numbers.IndexOf(startValue);
        // Display all numbers from startIndex on.
        for (int ctr = startIndex; ctr < numbers.Count; ctr++)
           Console.Write("    {0}", numbers[ctr]);
     }
  }
  // The example displays the following output if the user supplies
  // 7 as a command-line parameter:
  //    Displaying values greater than or equal to 7:
  //
  //    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.Collections.Generic.List`1.get_Item(Int32 index)
  //       at Example.ShowValues(Int32 startValue)
  //       at Example.Main()
  

  open System
  
  let numbers = ResizeArray()
  
  let showValues startValue =
      // Create a collection with numeric values.
      if numbers.Count = 0 then
          numbers.AddRange [| 2..2..22 |]
  
      // Get the index of a startValue.
      printfn $"Displaying values greater than or equal to {startValue}:"
      let startIndex = numbers.IndexOf startValue
      
      // Display all numbers from startIndex on.
      for i = startIndex to numbers.Count - 1 do
          printf $"    {numbers[i]}"
  
  let startValue =
      let args = Environment.GetCommandLineArgs()
      if args.Length < 2 then
          2
      else
          match Int32.TryParse args[1] with
          | true, v -> v
          | _ -> 2
  
  showValues startValue
  
  // The example displays the following output if the user supplies
  // 7 as a command-line parameter:
  //    Displaying values greater than or equal to 7:
  //
  //    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.Collections.Generic.List`1.get_Item(Int32 index)
  //       at Example.ShowValues(Int32 startValue)
  //       at <StartupCode$fs>.main@()
  

  Imports System.Collections.Generic
  
  Module Example
     Dim numbers As New List(Of Integer)
  
     Public Sub Main()
        Dim startValue As Integer 
        Dim args() As String = Environment.GetCommandLineArgs()
        If args.Length < 2 Then
           startValue = 2
        Else
           If Not Int32.TryParse(args(1), startValue) Then
              startValue = 2
           End If   
        End If
        ShowValues(startValue)
     End Sub
     
     Private Sub ShowValues(startValue As Integer)   
        ' Create a collection with numeric values.
        If numbers.Count = 0 Then 
           numbers.AddRange( { 2, 4, 6, 8, 10, 12, 14, 16, 18, 20, 22} )
        End If   
        ' Get the index of a particular number, in this case 7.
        Console.WriteLine("Displaying values greater than or equal to {0}:",
                          startValue)
        Dim startIndex As Integer = numbers.IndexOf(startValue)
        ' Display all numbers from startIndex on.
        For ctr As Integer = startIndex To numbers.Count - 1
           Console.Write("    {0}", numbers(ctr))
        Next
     End Sub
  End Module
  ' The example displays the following output if the user supplies
  ' 7 as a command-line parameter:
  '    Displaying values greater than or equal to 7:
  '    
  '    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.Collections.Generic.List`1.get_Item(Int32 index)
  '       at Example.ShowValues(Int32 startValue)
  '       at Example.Main()
  

  V tomto případě List<T>.IndexOf metoda vrátí hodnotu -1, což je neplatná hodnota indexu, pokud se nepodaří najít shodu. Chcete-li tuto chybu opravit, zkontrolujte návratovou hodnotu metody vyhledávání před iterací pole, jak je znázorněno v tomto příkladu.

  using System;
  using System.Collections.Generic;
  
  public class Example
  {
     static List<int> numbers = new List<int>();
  
     public static void Main()
     {
        int startValue;
        string[] args = Environment.GetCommandLineArgs();
        if (args.Length < 2)
           startValue = 2;
        else
           if (!Int32.TryParse(args[1], out startValue))
              startValue = 2;
  
        ShowValues(startValue);
     }
  
     private static void ShowValues(int startValue)
     {
        // Create a collection with numeric values.
        if (numbers.Count == 0)
           numbers.AddRange( new int[] { 2, 4, 6, 8, 10, 12, 14, 16, 18, 20, 22} );
  
        // Get the index of startValue.
        int startIndex = numbers.IndexOf(startValue);
        if (startIndex < 0) {
           Console.WriteLine("Unable to find {0} in the collection.", startValue);
        }
        else {
           // Display all numbers from startIndex on.
           Console.WriteLine("Displaying values greater than or equal to {0}:",
                          startValue);
           for (int ctr = startIndex; ctr < numbers.Count; ctr++)
              Console.Write("    {0}", numbers[ctr]);
        }
     }
  }
  // The example displays the following output if the user supplies
  // 7 as a command-line parameter:
  //      Unable to find 7 in the collection.
  

  open System
  open System.Collections.Generic
  
  let numbers = new List<int>()
  
  let showValues startValue =
      // Create a collection with numeric values.
      if numbers.Count = 0 then
          numbers.AddRange [| 2..2..22 |]
  
      // Get the index of startValue.
      let startIndex = numbers.IndexOf startValue
      if startIndex < 0 then
          printfn $"Unable to find {startValue} in the collection."
      else
          // Display all numbers from startIndex on.
          printfn $"Displaying values greater than or equal to {startValue}:"
          for i = startIndex to numbers.Count - 1 do
              printf $"    {numbers[i]}"
  
  let startValue =
      let args = Environment.GetCommandLineArgs()
      if args.Length < 2 then
          2
      else
          match Int32.TryParse args[1] with
          | true, v -> v
          | _ -> 2
  
  showValues startValue
  
  // The example displays the following output if the user supplies
  // 7 as a command-line parameter:
  //      Unable to find 7 in the collection.
  

  Imports System.Collections.Generic
  
  Module Example
     Dim numbers As New List(Of Integer)
  
     Public Sub Main()
        Dim startValue As Integer 
        Dim args() As String = Environment.GetCommandLineArgs()
        If args.Length < 2 Then
           startValue = 2
        Else
           If Not Int32.TryParse(args(1), startValue) Then
              startValue = 2
           End If   
        End If
        ShowValues(startValue)
     End Sub
     
     Private Sub ShowValues(startValue As Integer)   
        ' Create a collection with numeric values.
        If numbers.Count = 0 Then 
           numbers.AddRange( { 2, 4, 6, 8, 10, 12, 14, 16, 18, 20, 22} )
        End If   
        ' Get the index of startValue.
        Dim startIndex As Integer = numbers.IndexOf(startValue)
        If startIndex < 0 Then
           Console.WriteLine("Unable to find {0} in the collection.", startValue)
        Else
           ' Display all numbers from startIndex on.
           Console.WriteLine("Displaying values greater than or equal to {0}:",
                          startValue)
           For ctr As Integer = startIndex To numbers.Count - 1
              Console.Write("    {0}", numbers(ctr))
           Next
        End If
     End Sub
  End Module
  ' The example displays the following output if the user supplies
  '       Unable to find 7 in the collection.
  

• Při pokusu o použití nebo vytvoření výčtu sady výsledků, kolekce nebo pole vráceného dotazem bez testování, zda vrácený objekt obsahuje platná data.

• Použití vypočítané hodnoty k definování počátečního indexu, koncového indexu nebo počtu položek, které se mají iterated. Pokud je výsledek výpočtu neočekávaný, může dojít k výjimce IndexOutOfRangeException . Logiku programu byste měli zkontrolovat při výpočtu hodnoty indexu a ověřit hodnotu před iterací pole nebo kolekce. Všechny následující podmínky musí být splněny; IndexOutOfRangeException v opačném případě je vyvolán výjimka:

  • Počáteční index musí být větší nebo roven Array.GetLowerBound dimenzi matice, kterou chcete iterovat, nebo větší než nebo rovnou 0 pro kolekci.

  • Koncový index nemůže překročit Array.GetUpperBound rozměr pole, které chcete iterovat, nebo nesmí být větší nebo roven Count vlastnosti kolekce.

  • Následující rovnice musí být pravdivá pro dimenzi pole, kterou chcete iterovat:

    start_index >= lower_bound And start_index + items_to_iterate - 1 <= upper_bound
    

    Pro kolekci musí být splněna následující rovnice:

    start_index >= 0 And start_index + items_to_iterate <= Count
    

    Návod

    Počáteční index pole nebo kolekce nemůže být nikdy záporným číslem.

• Za předpokladu, že pole musí být založené na nule. Pole, která nejsou založená na nule, je možné vytvořit Array.CreateInstance(Type, Int32[], Int32[]) metodou a může je vrátit zprostředkovatele komunikace modelu COM, i když nejsou kompatibilní se specifikací CLS. Následující příklad ukazuje IndexOutOfRangeException , že je vyvolán při pokusu iterovat nenulové pole vytvořené metodou Array.CreateInstance(Type, Int32[], Int32[]) .

  using System;
  
  public class Example
  {
     public static void Main()
     {
        Array values = Array.CreateInstance(typeof(int), new int[] { 10 },
                                            new int[] { 1 });
        int value = 2;
        // Assign values.
        for (int ctr = 0; ctr < values.Length; ctr++) {
           values.SetValue(value, ctr);
           value *= 2;
        }
  
        // Display values.
        for (int ctr = 0; ctr < values.Length; ctr++)
           Console.Write("{0}    ", values.GetValue(ctr));
     }
  }
  // The example displays the following output:
  //    Unhandled Exception:
  //    System.IndexOutOfRangeException: Index was outside the bounds of the array.
  //       at System.Array.InternalGetReference(Void* elemRef, Int32 rank, Int32* pIndices)
  //       at System.Array.SetValue(Object value, Int32 index)
  //       at Example.Main()
  

  open System
  
  let values = 
      Array.CreateInstance(typeof<int>, [| 10 |], [| 1 |])
  let mutable value = 2
  // Assign values.
  for i = 0 to values.Length - 1 do
      values.SetValue(value, i)
      value <- value * 2
  
  // Display values.
  for i = 0 to values.Length - 1 do
      printf $"{values.GetValue i}    "
  
  // The example displays the following output:
  //    Unhandled Exception:
  //    System.IndexOutOfRangeException: Index was outside the bounds of the array.
  //       at System.Array.InternalGetReference(Void* elemRef, Int32 rank, Int32* pIndices)
  //       at System.Array.SetValue(Object value, Int32 index)
  //       at <StartupCode$fs>.main@()
  

  Module Example
     Public Sub Main()
        Dim values = Array.CreateInstance(GetType(Integer), { 10 }, { 1 })
        Dim value As Integer = 2
        ' Assign values.
        For ctr As Integer = 0 To values.Length - 1
           values(ctr) = value
           value *= 2
        Next
        
        ' Display values.
        For ctr As Integer = 0 To values.Length - 1
           Console.Write("{0}    ", values(ctr))
        Next
     End Sub
  End Module
  ' The example displays the following output:
  '    Unhandled Exception: 
  '    System.IndexOutOfRangeException: Index was outside the bounds of the array.
  '       at System.Array.InternalGetReference(Void* elemRef, Int32 rank, Int32* pIndices)
  '       at System.Array.SetValue(Object value, Int32 index)
  '       at Microsoft.VisualBasic.CompilerServices.NewLateBinding.ObjectLateIndexSetComplex(Obje
  '    ct Instance, Object[] Arguments, String[] ArgumentNames, Boolean OptimisticSet, Boolean RV
  '    alueBase)
  '       at Microsoft.VisualBasic.CompilerServices.NewLateBinding.LateIndexSet(Object Instance,
  '    Object[] Arguments, String[] ArgumentNames)
  '       at Example.Main()
  

  Chcete-li chybu opravit, jak je znázorněno v následujícím příkladu, můžete metodu GetLowerBound volat místo předpokladů o počátečním indexu pole.

  using System;
  
  public class Example
  {
     public static void Main()
     {
        Array values = Array.CreateInstance(typeof(int), new int[] { 10 },
                                            new int[] { 1 });
        int value = 2;
        // Assign values.
        for (int ctr = values.GetLowerBound(0); ctr <= values.GetUpperBound(0); ctr++) {
           values.SetValue(value, ctr);
           value *= 2;
        }
  
        // Display values.
        for (int ctr = values.GetLowerBound(0); ctr <= values.GetUpperBound(0); ctr++)
           Console.Write("{0}    ", values.GetValue(ctr));
     }
  }
  // The example displays the following output:
  //        2    4    8    16    32    64    128    256    512    1024
  

  open System
  
  let values = 
      Array.CreateInstance(typeof<int>, [| 10 |], [| 1 |])
  let mutable value = 2
  // Assign values.
  for i = values.GetLowerBound 0 to values.GetUpperBound 0 do
      values.SetValue(value, i)
      value <- value * 2
  
  // Display values.
  for i = values.GetLowerBound 0 to values.GetUpperBound 0 do
      printf $"{values.GetValue i}    "
  // The example displays the following output:
  //        2    4    8    16    32    64    128    256    512    1024
  

  Module Example
     Public Sub Main()
        Dim values = Array.CreateInstance(GetType(Integer), { 10 }, { 1 })
        Dim value As Integer = 2
        ' Assign values.
        For ctr As Integer = values.GetLowerBound(0) To values.GetUpperBound(0)
           values(ctr) = value
           value *= 2
        Next
        
        ' Display values.
        For ctr As Integer = values.GetLowerBound(0) To values.GetUpperBound(0)
           Console.Write("{0}    ", values(ctr))
        Next
     End Sub
  End Module
  ' The example displays the following output:
  '       2    4    8    16    32    64    128    256    512    1024
  

  Všimněte si, že když zavoláte metodu GetLowerBound pro získání počátečního indexu pole, měli byste také volat metodu Array.GetUpperBound(Int32) pro získání jeho koncového indexu.

• Matoucí index a hodnotu v daném indexu v číselném poli nebo kolekci. K tomuto problému obvykle dochází při použití foreach příkazu (v jazyce C#), for...in příkazu (v jazyce F#) nebo příkazu For Each (v jazyce Visual Basic). Následující příklad ukazuje problém.

  using System;
  
  public class Example
  {
     public static void Main()
     {
        // Generate array of random values.
        int[] values = PopulateArray(5, 10);
        // Display each element in the array.
        foreach (var value in values)
           Console.Write("{0}   ", values[value]);
     }
  
     private static int[] PopulateArray(int items, int maxValue)
     {
        int[] values = new int[items];
        Random rnd = new Random();
        for (int ctr = 0; ctr < items; ctr++)
           values[ctr] = rnd.Next(0, maxValue + 1);
  
        return values;
     }
  }
  // The example displays output like the following:
  //    6   4   4
  //    Unhandled Exception: System.IndexOutOfRangeException:
  //    Index was outside the bounds of the array.
  //       at Example.Main()
  

  open System
  
  let populateArray items maxValue =
      let rnd = Random()
      [| for i = 0 to items - 1 do
          rnd.Next(0, maxValue + 1) |]
  
  // Generate array of random values.
  let values = populateArray 5 10
  // Display each element in the array.
  for value in values do
      printf $"{values[value]}   "
  
  // The example displays output like the following:
  //    6   4   4
  //    Unhandled Exception: System.IndexOutOfRangeException:
  //    Index was outside the bounds of the array.
  //       at <StartupCode$fs>.main@()
  

  Module Example
     Public Sub Main()
        ' Generate array of random values.
        Dim values() As Integer = PopulateArray(5, 10)
        ' Display each element in the array.
        For Each value In values
           Console.Write("{0}   ", values(value))
        Next
     End Sub
     
     Private Function PopulateArray(items As Integer, 
                                    maxValue As Integer) As Integer()
        Dim values(items - 1) As Integer
        Dim rnd As New Random()
        For ctr As Integer = 0 To items - 1
           values(ctr) = rnd.Next(0, maxValue + 1)   
        Next    
        Return values                                                      
     End Function
  End Module
  ' The example displays output like the following:
  '    6   4   4
  '    Unhandled Exception: System.IndexOutOfRangeException: 
  '    Index was outside the bounds of the array.
  '       at Example.Main()
  

  Konstruktor iterace vrátí každou hodnotu v matici nebo kolekci, nikoli její index. Pokud chcete výjimku odstranit, použijte tento kód.

  using System;
  
  public class Example
  {
     public static void Main()
     {
        // Generate array of random values.
        int[] values = PopulateArray(5, 10);
        // Display each element in the array.
        foreach (var value in values)
           Console.Write("{0}   ", value);
     }
  
     private static int[] PopulateArray(int items, int maxValue)
     {
        int[] values = new int[items];
        Random rnd = new Random();
        for (int ctr = 0; ctr < items; ctr++)
           values[ctr] = rnd.Next(0, maxValue + 1);
  
        return values;
     }
  }
  // The example displays output like the following:
  //        10   6   7   5   8
  

  open System
  
  let populateArray items maxValue =
      let rnd = Random()
      [| for i = 0 to items - 1 do
          rnd.Next(0, maxValue + 1) |]
  
  // Generate array of random values.
  let values = populateArray 5 10
  // Display each element in the array.
  for value in values do
      printf $"{value}   "
      
  // The example displays output like the following:
  //        10   6   7   5   8
  

  Module Example
     Public Sub Main()
        ' Generate array of random values.
        Dim values() As Integer = PopulateArray(5, 10)
        ' Display each element in the array.
        For Each value In values
           Console.Write("{0}   ", value)
        Next
     End Sub
     
     Private Function PopulateArray(items As Integer, 
                                    maxValue As Integer) As Integer()
        Dim values(items - 1) As Integer
        Dim rnd As New Random()
        For ctr As Integer = 0 To items - 1
           values(ctr) = rnd.Next(0, maxValue + 1)   
        Next    
        Return values                                                      
     End Function
  End Module
  ' The example displays output like the following:
  '       10   6   7   5   8
  

• Zadejte pro vlastnost neplatný název DataView.Sort sloupce.

• Porušení bezpečnosti závitů. Operace, jako je čtení ze stejného StreamReader objektu, zápis do stejného StreamWriter objektu z více vláken nebo výčet objektů v Hashtable různých vláknech, můžou vyvolat IndexOutOfRangeException výjimku, pokud k objektu nemá přístup bezpečný přístup z více vláken. Tato výjimka je obvykle přerušovaná, protože závisí na stavu časování.

Použití pevně zakódovaných hodnot indexu pro manipulaci s polem pravděpodobně vyvolá výjimku, pokud je hodnota indexu nesprávná nebo neplatná, nebo pokud je velikost pole neočekávaná. Pokud chcete zabránit tomu, aby operace vyvolala IndexOutOfRangeException výjimku, můžete provést následující:

• Iterujte prvky pole pomocí příkazu foreach (v jazyce C#), příkazu for... in statement (in F#) nebo For Each... Další konstruktor (v jazyce Visual Basic) místo iterace prvků indexem.

• Iterujte prvky indexem počínaje indexem vráceným Array.GetLowerBound metodou a končí indexem vráceným metodou Array.GetUpperBound .

• Pokud přiřazujete prvky v jedné matici k druhému, ujistěte se, že má cílové pole alespoň tolik prvků jako zdrojové pole, a to porovnáním jejich Array.Length vlastností.

Seznam počátečních hodnot vlastností pro instanci IndexOutOfRangeExceptionnaleznete v konstruktoru IndexOutOfRangeException.

Vyvolá se následující pokyny pro zprostředkující IndexOutOfRangeExceptionjazyk :

• ldelem.<Typ>

• ldelema

• stelem.<Typ>

IndexOutOfRangeException používá COR_E_INDEXOUTOFRANGE HRESULT, který má hodnotu 0x80131508.

Konstruktory

Name	Description
IndexOutOfRangeException()	Inicializuje novou instanci IndexOutOfRangeException třídy.
IndexOutOfRangeException(String, Exception)	Inicializuje novou instanci IndexOutOfRangeException třídy se zadanou chybovou zprávou a odkazem na vnitřní výjimku, která je příčinou této výjimky.
IndexOutOfRangeException(String)	Inicializuje novou instanci IndexOutOfRangeException třídy se zadanou chybovou zprávou.

Vlastnosti

Name	Description
Data	Získá kolekci párů klíč/hodnota, které poskytují další uživatelem definované informace o výjimce. (Zděděno od Exception)
HelpLink	Získá nebo nastaví odkaz na soubor nápovědy přidružený k této výjimce. (Zděděno od Exception)
HResult	Získá nebo nastaví HRESULT, kódovanou číselnou hodnotu, která je přiřazena ke konkrétní výjimce. (Zděděno od Exception)
InnerException	Exception Získá instanci, která způsobila aktuální výjimku. (Zděděno od Exception)
Message	Získá zprávu, která popisuje aktuální výjimku. (Zděděno od Exception)
Source	Získá nebo nastaví název aplikace nebo objektu, který způsobuje chybu. (Zděděno od Exception)
StackTrace	Získá řetězcové znázornění okamžitých rámců v zásobníku volání. (Zděděno od Exception)
TargetSite	Získá metodu, která vyvolá aktuální výjimku. (Zděděno od Exception)

Metody

Name	Description
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetBaseException()	Při přepsání v odvozené třídě vrátí Exception to, že je původní příčinou jedné nebo více následných výjimek. (Zděděno od Exception)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetObjectData(SerializationInfo, StreamingContext)	Zastaralé. Při přepsání v odvozené třídě nastaví SerializationInfo s informacemi o výjimce. (Zděděno od Exception)
GetType()	Získá typ modulu runtime aktuální instance. (Zděděno od Exception)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	Vytvoří a vrátí řetězcovou reprezentaci aktuální výjimky. (Zděděno od Exception)

Událost

Name	Description
SerializeObjectState	Zastaralé. Nastane, když je výjimka serializována vytvořit objekt stavu výjimky, který obsahuje serializovaná data o výjimce. (Zděděno od Exception)

Viz také

• Exception
• Zpracování a vyvolání výjimek v .NET