IndexOutOfRangeException 類別

定義

命名空間:: System

組件:: mscorlib.dll, System.Runtime.dll

組件:: netstandard.dll, System.Runtime.dll

組件:: System.Runtime.dll

組件:: mscorlib.dll

組件:: netstandard.dll

來源:: IndexOutOfRangeException.cs

來源:: IndexOutOfRangeException.cs

來源:: IndexOutOfRangeException.cs

來源:: IndexOutOfRangeException.cs

來源:: IndexOutOfRangeException.cs

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 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 例外是因為開發者錯誤而拋出。與其處理異常，不如診斷錯誤原因並修正程式碼。最常見的錯誤原因包括：

忘記集合或以零為基礎的陣列的上界比其成員或元素數少一個，如下範例所示。

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'

或者，你也可以使用 foreach 陳述句（C# for...in ）、陳述句（F#）或 For Each 陳述句（Visual Basic）。

嘗試將一個陣列元素指派到另一個未被充分維度化且元素數少於原始陣列的陣列。以下範例嘗試將陣列中的 value1 最後一個元素指派給陣列中的 value2 相同元素。然而，該 value2 陣列的尺寸被錯誤地劃定為六個元素而非七個元素。因此，指派會拋 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 集合的性質。
- 以下方程式必須對你想迭代的陣列維度成立：
```
start_index >= lower_bound And start_index + items_to_iterate - 1 <= upper_bound
```
  對於一個集合，以下方程式必須成立：
```
start_index >= 0 And start_index + items_to_iterate <= Count
```
  小提示
  
  陣列或集合的起始索引絕不能是負數。

假設陣列必須是零基的。非零基礎陣列可透過此 Array.CreateInstance(Type, Int32[], Int32[]) 方法建立，並可透過 COM 互操作回傳，儘管不符合 CLS 標準。以下範例說明 IndexOutOfRangeException 了當你嘗試迭代由該 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()

為了修正錯誤，如以下範例所示，你可以直接呼叫該 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) 該方法取得其終點索引。

混淆索引與該索引值在數值陣列或集合中的值。此問題通常發生在使用 foreach C# 語句、 for...in F# For Each 語句或 Visual Basic 語句時。下列範例說明問題。

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... 來迭代陣列元素）在陳述中（以 F# 表示），或是 For Each...接下來用 Visual Basic 建構，而不是用索引來迭代元素。
以索引迭代元素，從方法回傳 Array.GetLowerBound 的索引開始，到方法回傳 Array.GetUpperBound 的索引結束。
如果你要將一個陣列中的元素指派到另一個陣列，請透過比較 Array.Length 它們的屬性，確保目標陣列的元素數量至少與來源陣列相同。

如需查看 IndexOutOfRangeException 實例的初始屬性值列表，請參閱 IndexOutOfRangeException 的建構子。

以下中介語言（IL）指令會拋出 IndexOutOfRangeException：

伊德萊姆。<類型>
伊德萊瑪
斯特勒姆。<類型>

IndexOutOfRangeException 使用 HRESULT COR_E_INDEXOUTOFRANGE，其值為 0x80131508。

建構函式

名稱	Description
IndexOutOfRangeException()	初始化 IndexOutOfRangeException 類別的新執行個體。
IndexOutOfRangeException(String, Exception)	初始化類別的新實例 IndexOutOfRangeException ，並附上指定的錯誤訊息及導致該異常的內部例外的參考。
IndexOutOfRangeException(String)	初始化類別的新實例 IndexOutOfRangeException 並指定錯誤訊息。

屬性

名稱	Description
Data	取得一組鍵值對，提供關於例外的額外使用者定義資訊。 (繼承來源 Exception)
HelpLink	取得或設定與此例外相關的說明檔案連結。 (繼承來源 Exception)
HResult	取得或設定 HRESULT，一個編碼的數值，指派給特定例外。 (繼承來源 Exception)
InnerException	會取得 Exception 造成目前例外的實例。 (繼承來源 Exception)
Message	會收到描述目前例外的訊息。 (繼承來源 Exception)
Source	取得或設定造成錯誤之應用程式或物件的名稱。 (繼承來源 Exception)
StackTrace	會取得呼叫堆疊上即時框架的字串表示。 (繼承來源 Exception)
TargetSite	會取得拋出當前例外的方法。 (繼承來源 Exception)

方法

名稱	Description
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetBaseException()	當在派生類別中被覆寫時，回傳 Exception 是一個或多個後續例外的根因。 (繼承來源 Exception)
GetHashCode()	做為預設哈希函式。 (繼承來源 Object)
GetObjectData(SerializationInfo, StreamingContext)	已淘汰. 在衍生類別中覆寫時，使用例外狀況的相關信息來設定 SerializationInfo。 (繼承來源 Exception)
GetType()	取得目前實例的執行時型態。 (繼承來源 Exception)
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
ToString()	建立並回傳當前例外的字串表示。 (繼承來源 Exception)

事件

名稱	Description
SerializeObjectState	已淘汰. 當例外被序列化以建立包含該例外序列化資料的例外狀態物件時，會發生這種情況。 (繼承來源 Exception)

適用於

另請參閱

意見反應

此頁面對您有幫助嗎？

共用方式為

IndexOutOfRangeException 類別

定義

備註

建構函式

屬性

方法

事件

適用於

另請參閱

意見反應