IndexOutOfRangeException Clase

Definición

Espacio de nombres:

System

Ensamblado:

System.Runtime.dll

Ensamblado:

mscorlib.dll

Ensamblado:

netstandard.dll

Excepción que se inicia cuando se intenta acceder a un elemento de una matriz o de una colección con un índice que está fuera de los límites.

public ref class IndexOutOfRangeException sealed : Exception

public ref class IndexOutOfRangeException sealed : SystemException

public sealed class IndexOutOfRangeException : Exception

public sealed class IndexOutOfRangeException : SystemException

[System.Serializable]
public sealed class IndexOutOfRangeException : SystemException

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class IndexOutOfRangeException : SystemException

type IndexOutOfRangeException = class
    inherit Exception

type IndexOutOfRangeException = class
    inherit SystemException

[<System.Serializable>]
type IndexOutOfRangeException = class
    inherit SystemException

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type IndexOutOfRangeException = class
    inherit SystemException

Public NotInheritable Class IndexOutOfRangeException
Inherits Exception

Public NotInheritable Class IndexOutOfRangeException
Inherits SystemException

Herencia

Object

Exception

IndexOutOfRangeException

Herencia

Object

Exception

SystemException

IndexOutOfRangeException

Atributos

SerializableAttribute ComVisibleAttribute

Comentarios

Se IndexOutOfRangeException produce una excepción cuando se usa un índice no válido para tener acceso a un miembro de una matriz o una colección, o para leer o escribir desde una ubicación determinada de un búfer. Esta excepción hereda de la Exception clase pero no agrega ningún miembro único.

Normalmente, se produce una IndexOutOfRangeException excepción como resultado del error del desarrollador. En lugar de controlar la excepción, debe diagnosticar la causa del error y corregir el código. Las causas más comunes del error son:

• Olvidando que el límite superior de una colección o una matriz de base cero es uno menor que su número de miembros o elementos, como se muestra en el ejemplo siguiente.

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

  Para corregir el error, puede usar código como el siguiente.

  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'
  

  Como alternativa, en lugar de iterar todos los elementos de la matriz por su índice, puede usar la foreach instrucción (en C#), la for...in instrucción (en F#) o la For Each instrucción (en Visual Basic).

• Intentando asignar un elemento de matriz a otra matriz que no se ha dimensionado adecuadamente y que tiene menos elementos que la matriz original. En el ejemplo siguiente se intenta asignar el último elemento de la value1 matriz al mismo elemento de la value2 matriz. Sin embargo, la value2 matriz se ha dimensionado incorrectamente para tener seis en lugar de siete elementos. Como resultado, la asignación produce una IndexOutOfRangeException excepción.

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

• Con un valor devuelto por un método de búsqueda para iterar una parte de una matriz o colección a partir de una posición de índice determinada. Si olvida comprobar si la operación de búsqueda encontró una coincidencia, el tiempo de ejecución produce una IndexOutOfRangeException excepción, como se muestra en este ejemplo.

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

  En este caso, el List<T>.IndexOf método devuelve -1, que es un valor de índice no válido, cuando no encuentra una coincidencia. Para corregir este error, compruebe el valor devuelto del método de búsqueda antes de iterar la matriz, como se muestra en este ejemplo.

  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.
  

• Intentando usar o enumerar un conjunto de resultados, una colección o una matriz devueltos por una consulta sin probar si el objeto devuelto tiene datos válidos.

• Con un valor calculado para definir el índice inicial, el índice final o el número de elementos que se van a iterar. Si el resultado del cálculo es inesperado, podría producir una IndexOutOfRangeException excepción. Debe comprobar la lógica del programa al calcular el valor de índice y validar el valor antes de iterar la matriz o colección. Todas las condiciones siguientes deben ser verdaderas; De lo contrario, se produce una IndexOutOfRangeException excepción:

  • El índice inicial debe ser mayor o igual que Array.GetLowerBound para la dimensión de la matriz que desea iterar, o mayor o igual que 0 para una colección.

  • El índice final no puede superar Array.GetUpperBound para la dimensión de la matriz que desea iterar o no puede ser mayor o igual que la Count propiedad de una colección.

  • La siguiente ecuación debe ser true para la dimensión de la matriz que desea iterar:

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

    Para una colección, la siguiente ecuación debe ser true:

    start_index >= 0 And start_index + items_to_iterate <= Count  
    

    Sugerencia

    El índice inicial de una matriz o colección nunca puede ser un número negativo.

• Suponiendo que una matriz debe estar basada en cero. Las matrices que no están basadas en cero se pueden crear mediante el Array.CreateInstance(Type, Int32[], Int32[]) método y se pueden devolver mediante la interoperabilidad COM, aunque no son compatibles con CLS. En el ejemplo siguiente se muestra el IndexOutOfRangeException que se produce al intentar iterar una matriz no basada en cero creada por el Array.CreateInstance(Type, Int32[], Int32[]) método .

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

  Para corregir el error, como hace el ejemplo siguiente, puede llamar al GetLowerBound método en lugar de realizar suposiciones sobre el índice inicial de una matriz.

  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
  

  Tenga en cuenta que, al llamar al GetLowerBound método para obtener el índice inicial de una matriz, también debe llamar al método para obtener su Array.GetUpperBound(Int32) índice final.

• Confundir un índice y el valor de ese índice en una matriz o colección numéricas. Este problema suele producirse cuando se usa la foreach instrucción (en C#), la for...in instrucción (en F#) o la For Each instrucción (en Visual Basic). En el siguiente ejemplo se ilustra el problema.

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

  La construcción de iteración devuelve cada valor de una matriz o colección, no su índice. Para eliminar la excepción, use este código.

  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
  

• Proporcionar un nombre de columna no válido a la DataView.Sort propiedad .

• Infringir la seguridad de subprocesos. Las operaciones como leer desde el mismo StreamReader objeto, escribir en el mismo StreamWriter objeto desde varios subprocesos o enumerar los objetos de un Hashtable subproceso diferente pueden producir un IndexOutOfRangeException si no se tiene acceso al objeto de forma segura para subprocesos. Esta excepción suele ser intermitente porque se basa en una condición de carrera.

Es probable que el uso de valores de índice codificados de forma rígida para manipular una matriz produzca una excepción si el valor de índice es incorrecto o no válido, o si el tamaño de la matriz que se está manipulando es inesperado. Para evitar que una operación produzca una IndexOutOfRangeException excepción, puede hacer lo siguiente:

• Iteración de los elementos de la matriz mediante la instrucción foreach (en C#), para... in (en F#) o For Each... Siguiente construcción (en Visual Basic) en lugar de iterar elementos por índice.

• Iterar los elementos por índice empezando por el índice devuelto por el Array.GetLowerBound método y finalizando con el índice devuelto por el Array.GetUpperBound método .

• Si va a asignar elementos de una matriz a otra, asegúrese de que la matriz de destino tenga al menos tantos elementos como la matriz de origen comparando sus Array.Length propiedades.

Para obtener una lista de valores de propiedad iniciales de una instancia de IndexOutOfRangeException, consulte el IndexOutOfRangeException constructores.

Las siguientes instrucciones de lenguaje intermedio (IL) inician IndexOutOfRangeException:

• ldelem.<type>

• ldelema

• stelem.<type>

IndexOutOfRangeException usa el COR_E_INDEXOUTOFRANGE HRESULT, que tiene el valor 0x80131508.

Constructores

IndexOutOfRangeException()	Inicializa una nueva instancia de la clase IndexOutOfRangeException.
IndexOutOfRangeException(String)	Inicializa una nueva instancia de la clase IndexOutOfRangeException con el mensaje de error especificado.
IndexOutOfRangeException(String, Exception)	Inicializa una nueva instancia de la clase IndexOutOfRangeException con el mensaje de error especificado y una referencia a la excepción interna que representa la causa de esta excepción.

Propiedades

Data	Obtiene una colección de pares clave/valor que proporciona información definida por el usuario adicional sobre la excepción. (Heredado de Exception)
HelpLink	Obtiene o establece un vínculo al archivo de ayuda asociado a esta excepción. (Heredado de Exception)
HResult	Obtiene o establece HRESULT, un valor numérico codificado que se asigna a una excepción específica. (Heredado de Exception)
InnerException	Obtiene la instancia Exception que produjo la excepción actual. (Heredado de Exception)
Message	Obtiene un mensaje que describe la excepción actual. (Heredado de Exception)
Source	Devuelve o establece el nombre de la aplicación o del objeto que generó el error. (Heredado de Exception)
StackTrace	Obtiene una representación de cadena de los marcos inmediatos en la pila de llamadas. (Heredado de Exception)
TargetSite	Obtiene el método que produjo la excepción actual. (Heredado de Exception)

Métodos

Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetBaseException()	Cuando se invalida en una clase derivada, devuelve la clase Exception que representa la causa principal de una o más excepciones posteriores. (Heredado de Exception)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetObjectData(SerializationInfo, StreamingContext)	Cuando se invalida en una clase derivada, establece SerializationInfo con información sobre la excepción. (Heredado de Exception)
GetType()	Obtiene el tipo de tiempo de ejecución de la instancia actual. (Heredado de Exception)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Crea y devuelve una representación de cadena de la excepción actual. (Heredado de Exception)

Eventos

SerializeObjectState

Obsoleto. Ocurre cuando una excepción se serializa para crear un objeto de estado de excepción que contenga datos serializados sobre la excepción. (Heredado de Exception)

Consulte también

• Exception
• Controlar y generar excepciones en .NET