IndexOutOfRangeException クラス

リファレンス

定義

名前空間:: System

アセンブリ:: System.Runtime.dll

アセンブリ:: mscorlib.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

境界外のインデックスを使用して配列またはコレクションの要素にアクセスしようとしたときにスローされる例外。

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

継承: Object

Exception
IndexOutOfRangeException

継承: Object

Exception

SystemException
IndexOutOfRangeException

属性: SerializableAttribute ComVisibleAttribute

注釈

無効なインデックスを使用して、配列またはコレクションのメンバーにアクセスする、またはバッファー内の特定の場所から読み取り/書き込みした場合IndexOutOfRangeException例外がスローされます。この例外はExceptionクラスを継承しますが、一意のメンバーの追加はありません。

通常、IndexOutOfRangeException例外は開発者のエラーの結果としてスローされます。例外を処理する代わりに、エラーの原因を診断し、コードを修正する必要があります。エラーの最も一般的な原因は次のとおりです。

次の例が示すように、コレクションまたは 0 ベースの配列の上限が、メンバーまたは要素数よりも 1 少ないことを忘れる。

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

エラーを修正するには、次のようなコードを使用できます。

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'

または、配列内のすべての要素をインデックスで反復処理する代わりに、ステートメント (C#)、ステートメント (F#)for...in、またはFor Eachステートメント (Visual Basic) を使用foreachできます。

適切な大きさでなく、元の配列よりも要素の数が少ない別の配列に、配列の要素を割り当てようとしています。次の例は、value1配列内の最後の要素を、value2配列の同じ要素に代入しようとしています。ただし、value2配列は 7 ではなく 6 つの要素を持つ、適切でない大きさになっています。その結果、割り当てによってIndexOutOfRangeException例外がスローされます。

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

検索メソッドから返された値を使用して、特定のインデックス位置から配列またはコレクションの一部を反復処理します。検索操作で一致が見つかったかどうかを確認し忘れた場合、この例で示すようにランタイムはIndexOutOfRangeException例外をスローします。

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

ここで、List<T>.IndexOfメソッドは、検索に失敗した場合、無効なインデックス値である -1 を返します。このエラーを修正するには、この例で示すように、配列を反復処理する前に、検索メソッドの戻り値を確認します。

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.

返されたオブジェクトに有効なデータがあるかどうかをテストせずに、クエリから返された結果セット、コレクション、または配列を使用、または列挙しようとしました。
計算値を使用して、開始インデックス、終了インデックス、または反復処理する項目の数を定義します。計算の結果が予期しないものである場合、IndexOutOfRangeException例外が発生する可能性があります。配列またはコレクションを反復処理する前に、インデックス値の計算のときにプログラムのロジックを確認し、値を検証する必要があります。次の条件をすべて満たす必要があります。そうでない場合、IndexOutOfRangeException例外がスローされます。
- 開始インデックスは、配列の次元を反復する場合はArray.GetLowerBound以上、コレクションの場合は 0 以上である必要があります。
- 終了インデックスは、配列の次元を反復する場合はArray.GetUpperBoundよりも大きい値を指定、またはコレクションのCountプロパティ以上にできません。
- 次の式は、配列の次元を反復する場合は true である必要があります。
```
start_index >= lower_bound And start_index + items_to_iterate - 1 <= upper_bound  
```
  コレクション場合は、次の式を満たす必要があります。
```
start_index >= 0 And start_index + items_to_iterate <= Count  
```
  ヒント
  
  配列またはコレクションの開始インデックスは、負の数値を指定することはできません。

配列が 0 から始まる必要があると仮定します。 0 以外から始まる配列はArray.CreateInstance(Type, Int32[], Int32[])メソッドで作成でき、COM 相互運用機能で返すことができますが、CLS に準拠していません。次の例は、Array.CreateInstance(Type, Int32[], Int32[])メソッドで作成された、 0 から始まらない配列を反復処理するときにスローされるIndexOutOfRangeExceptionを示しています。

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

エラーを修正するには、次の例のように、配列の GetLowerBound 開始インデックスに関する仮定を行う代わりに、メソッドを呼び出すことができます。

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

GetLowerBoundメソッドを呼び出して配列の開始インデックスを取得するときには、Array.GetUpperBound(Int32)も呼び出して終了インデックスを取得する必要があることに注意してください。

数値の配列またはコレクション内のインデックスと、そのインデックスにある値を混同する。この問題は、通常、ステートメント (C#)、ステートメント (F#)、for...inまたはFor Eachステートメント (Visual Basic) を使用foreachする場合に発生します。この問題を説明する例を次に示します。

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

イテレーションの構成体は、インデックスではなく、配列またはコレクションの各値を返します。例外を排除するには、このコードを使用します。

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

DataView.Sortプロパティで、無効な列名を指定する。
スレッドセーフに違反する。同じStreamReaderオブジェクトからの読み取り、複数のスレッドからの同じStreamWriterオブジェクトへの書き込み、または異なるスレッドからのHashtable内のオブジェクトの列挙などの操作は、オブジェクトがスレッドセーフな方法でアクセスされていない場合、IndexOutOfRangeExceptionをスローします。この例外は競合状態に依存するために、通常は断続的です。

ハードコーディングされたインデックス値を使用して配列を操作するとき、インデックス値が正しくないか無効な場合、または操作されている配列のサイズが予期されていない場合は、例外をスローする可能性があります。操作がIndexOutOfRangeException例外をスローすることを防ぐためには、次のようにします。

foreach ステートメント (C# では)、for.. を使用して配列の要素を反復処理します。in ステートメント (F# の場合)、または For Each...インデックスによって要素を反復処理するのではなく、(Visual Basic内の) 次のコンストラクト。
Array.GetLowerBoundメソッドによって返されるインデックスで始まり、Array.GetUpperBoundメソッドによって返されるインデックスで終わるインデックスを使用して要素を反復処理します。
ある配列の要素を別の配列に割り当てる場合は、Array.Lengthプロパティを比較して、対象の配列に、少なくともソース配列と同じ数の要素があることを確認してください。

インスタンスの初期プロパティ値の一覧についてはIndexOutOfRangeExceptionを参照してください、IndexOutOfRangeExceptionコンストラクター。

次の中間言語 (IL) 命令は、 IndexOutOfRangeExceptionをスローします。

ldelem。<type>
ldelema
ステレム。<type>

IndexOutOfRangeExceptionは、値が 0x80131508 の HRESULT COR_E_INDEXOUTOFRANGE を使用します。

コンストラクター

IndexOutOfRangeException()	IndexOutOfRangeException クラスの新しいインスタンスを初期化します。
IndexOutOfRangeException(String)	指定したエラーメッセージを使用して、IndexOutOfRangeException クラスの新しいインスタンスを初期化します。
IndexOutOfRangeException(String, Exception)	指定したエラーメッセージおよびこの例外の原因となった内部例外への参照を使用して、IndexOutOfRangeException クラスの新しいインスタンスを初期化します。

プロパティ

Data	例外に関する追加のユーザー定義情報を提供する、キーと値のペアのコレクションを取得します。 (継承元 Exception)
HelpLink	この例外に関連付けられているヘルプファイルへのリンクを取得または設定します。 (継承元 Exception)
HResult	特定の例外に割り当てられているコード化数値である HRESULT を取得または設定します。 (継承元 Exception)
InnerException	現在の例外の原因となる Exception インスタンスを取得します。 (継承元 Exception)
Message	現在の例外を説明するメッセージを取得します。 (継承元 Exception)
Source	エラーの原因となるアプリケーションまたはオブジェクトの名前を取得または設定します。 (継承元 Exception)
StackTrace	呼び出し履歴で直前のフレームの文字列形式を取得します。 (継承元 Exception)
TargetSite	現在の例外がスローされたメソッドを取得します。 (継承元 Exception)

メソッド

Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetBaseException()	派生クラスでオーバーライドされた場合、それ以後に発生する 1 つ以上の例外の根本原因である Exception を返します。 (継承元 Exception)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetObjectData(SerializationInfo, StreamingContext)	派生クラスでオーバーライドされた場合は、その例外に関する情報を使用して SerializationInfo を設定します。 (継承元 Exception)
GetType()	現在のインスタンスのランタイム型を取得します。 (継承元 Exception)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ToString()	現在の例外の文字列形式を作成して返します。 (継承元 Exception)

events

SerializeObjectState

互換性のために残されています。

例外がシリアル化され、例外に関するシリアル化されたデータを含む例外状態オブジェクトが作成されたときに発生します。

(継承元 Exception)

適用対象

次の方法で共有