共用方式為

Visual Basic 中的陣列

  • 發行項

「陣列」(Array) 是一組邏輯相關值，例如文法學校中每一年級的學生數。

若要使用陣列，您可以利用相同名稱參考這些相關值，並使用呼叫個別呼叫其索引或註標的數字。 這些個別值稱為陣列的「元素」(Element)。 會從索引 0 是連續的到最高索引值。

與陣列相反，包含的變數唯一值呼叫一個純量變數。

本主題內容

  • 在簡單的陣列的陣列元素。

  • 建立陣列

  • 宣告陣列

  • 在陣列中儲存值

  • 在陣列填入初始值

    • 巢狀陣列常值

  • 逐一查看陣列

  • 做為傳回值和參數的陣列。

  • 不規則陣列

  • 長度為零的陣列

  • 陣列大小

  • 陣列型別及其他型別

  • 使用集合取代陣列

在簡單的陣列的陣列元素。

下列範例宣告含有文法學校中每一年級學生數目的陣列變數。

Dim students(6) As Integer

在上述範例中的陣列 students 包含七個元素。 元素的索引範圍從 0 到 6。 含有此陣列較宣告所有的變數來得簡單。

下圖顯示陣列 students。 對於陣列的每一元素︰

  • 元素的索引表示年級 (索引 0 表示幼稚園)。

  • 在這個項目包含的值表示學生數目該層級的。

"students" 陣列的元素

顯示學生人數之陣列的圖片

下列範例說明參考陣列 students 的第一、第二和最後一個元素的方法。

Dim kindergarten As Integer = students(0)
Dim firstGrade As Integer = students(1)
Dim sixthGrade As Integer = students(6)
MsgBox("Students in kindergarten = " & CStr(kindergarten))
MsgBox("Students in first grade = " & CStr(firstGrade))
MsgBox("Students in sixth grade = " & CStr(sixthGrade))

您可以只使用沒有索引的陣列變數名稱來當做整個陣列的參考。

在前一個執行個體使用的 students 陣列的索引和視為一維。 使用一個以上的索引或註標則稱為「多維」(Multidimensional)。 如需詳細資訊，請參閱其餘主題和 Visual Basic 中的陣列維度。

建立陣列

您可以定義陣列大小的幾種方式。 您可以提供大小，宣告陣列時，，如下列範例所示。

Dim cargoWeights(10) As Double
Dim atmospherePressures(2, 2, 4, 10) As Short
Dim inquiriesByYearMonthDay(20)()() As Byte

您也可以使用 New 子句提供陣列的大小，在建立時，，如下列範例所示。

cargoWeights = New Double(10) {}
atmospherePressures = New Short(2, 2, 4, 10) {}
inquiriesByYearMonthDay = New Byte(20)()() {}

如果您有現有的陣列，可以使用 Redim 陣述式來重新定義其大小。 您可以指定 Redim 陳述式應保留在陣列的值，也可以指定它會建立空白陣列。 下列範例顯示 Redim 陳述式的不同使用方法，以修改現有陣列的大小。

' Assign a new array size and retain the current element values.
ReDim Preserve cargoWeights(20)
' Assign a new array size and retain only the first five element values.
ReDim Preserve cargoWeights(4)
' Assign a new array size and discard all current element values.
ReDim cargoWeights(15)

如需詳細資訊，請參閱ReDim 陳述式 (Visual Basic)。

宣告陣列

您可使用 Dim 陳述式 (Statement) 來宣告陣列變數，方式和其他變數相同。 您遵循型別或這個變數名稱之後加上一組或多組括號表示它將保留陣列而不是純量，是變數包含唯一值。

在您宣告陣列之後，您可以使用 ReDim 陳述式 (Visual Basic)，您可以定義控制項的大小。

下列範例會加入一組宣告一維陣列變數括號型別之後。 使用 ReDim 陳述式 (Visual Basic)，這個範例也會指定陣列維度。

' Declare a one-dimensional array.
Dim cargoWeights As Double()

' Dimension the array.
ReDim cargoWeights(15)

下列範例宣告多維陣列變數將一組括號在型別之後以及將放在括號內的逗號分隔維度。 使用 ReDim 陳述式 (Visual Basic)，這個範例也會指定陣列維度。

' Declare a multidimensional array.
Dim atmospherePressures As Short(,,,)

' Dimension the array.
ReDim atmospherePressures(1, 2, 3, 4)

若要宣告不規則陣列變數，請新增一組括號，在變數名稱每個巢狀陣列的層數之後。

Dim inquiriesByYearMonthDay()()() As Byte

上述範例宣告陣列變數，但不將陣列指派給它們。 您仍然必須建立陣列，將它初始化，然後將其指派給變數。

在陣列中儲存值

您可以使用型別為 Integer 的索引來存取陣列中的每一個位置。 您可以使用以括號括住的陣列索引參照每一個陣列位置，儲存和擷取陣列值。 多維陣列的索引以逗號 (，) 分隔。 您需要每個陣列維度的索引。 下列範例顯示一些將值儲存在陣列中的陳述式 (Statement)。

Dim i = 4
Dim j = 2

Dim numbers(10) As Integer
Dim matrix(5, 5) As Double

numbers(i + 1) = 0
matrix(3, j * 2) = j

下列範例顯示一些從陣列中取得值的陳述式 (Statement)。

Dim v = 2
Dim i = 1
Dim j = 1
Dim k = 1
Dim wTotal As Double = 0.0
Dim sortedValues(5), rawValues(5), estimates(2, 2, 2) As Double
Dim lowestValue = sortedValues(0)
wTotal += (rawValues(v) ^ 2)
Dim firstGuess = estimates(i, j, k)

在陣列填入初始值

若要使用陣列常值，您可以建立包含一組值的陣列。 陣列常值由大括號 ({}) 括住的逗點分隔值清單構成。

當您使用陣列常值來建立陣列時，可以提供陣列型別 (Array Type) 或者使用型別推斷來判別陣列型別。 下列程式碼顯示兩個選項。

Dim numbers = New Integer() {1, 2, 4, 8}
Dim doubles = {1.5, 2, 9.9, 18}

當您使用型別推斷時，主要取決於陣列型別輸入為陣列常值提供值的清單。 主型別 (Dominant Type) 是任何其他輸入陣列常值可以擴展的唯一型別。 如果這個唯一型別無法判斷的，主型別為任何其他輸入陣列可以縮小至的唯一型別。 如果無法決定所有這些型別，則主型別為 Object。 例如，在中，如果提供給陣列常值的值清單包含型別 Integer、 Long和 Double的值，產生的陣列是 Double型別。 Integer 和 Long 只會擴展至 Double。 因此，Double 是主型別。 如需詳細資訊，請參閱擴展和縮小轉換 (Visual Basic)。 這些推斷規則適用於陣列推斷為區域變數 (在類別成員上定義的型別。 雖然您可以使用陣列常值，當您建立類別層級的變數時，您無法使用型別推斷在類別層級。 因此，指定在類別層級推斷值為陣列常值提供做為 Object型別的陣列常值。

您可以使用陣列常值，建立的陣列可以明確指定項目的型別。 在這種情況下，陣列常值中的值必須擴展為陣列元素型別。 下列程式碼範例將從整數清單建立型別為 Double 的陣列。

Dim values As Double() = {1, 2, 3, 4, 5, 6}

wak0wfyt.collapse_all(zh-tw,VS.110).gif巢狀陣列常值

您可以使用巢狀陣列常值來建立多維陣列。 巢狀陣列常值必須有維度或陣序維度和數字，以及產生的陣列是一致的。 下列程式碼範例將使用陣列常值建立整數的二維陣列。

Dim grid = {{1, 2}, {3, 4}}

在上述範例中，則為，如果項目數巢狀陣列常值的不相符，就會發生錯誤。 除了二維之外，，，如果您明確宣告陣列變數是錯誤也會發生。

注意事項注意事項

您可以在提供不同維度之巢狀陣列常值時，使用括號括住內部陣列常值來避免錯誤。括號會強制陣列常值運算式評估，因此，結果值搭配外部陣列常值，，如下列程式碼所示。

 
Dim values = {({1, 2}), ({3, 4, 5})}

使用巢狀陣列常值來建立多維陣列時，可以使用型別推斷。 當您使用型別推斷時，推斷的型別是某個巢狀層次之所有陣列常值中所有值的主型別。 下列程式碼範例將從型別為 Integer 和 Double 的值建立型別為 Double 的二維陣列。

Dim a = {{1, 2.0}, {3, 4}, {5, 6}, {7, 8}}

如需其他範例，請參閱 如何：在 Visual Basic 中初始化陣列變數。

逐一查看陣列

當您將陣列時，逐一查看您從最低的索引來存取陣列中的每個項目到最高的索引。

使用 For...Next 陳述式 (Visual Basic)，下列範例傳遞一維陣列逐一查看。 GetUpperBound 方法會傳回索引可以擁有的最大值。 最小的索引值一律為 0。

Dim numbers = {10, 20, 30}

For index = 0 To numbers.GetUpperBound(0)
    Debug.WriteLine(numbers(index))
Next
' Output:
'  10
'  20
'  30

您可以使用 For...Next 陳述式，下列範例將多維陣列逐一查看。 GetUpperBound 方法會指定這個維度的參數。 GetUpperBound(0) 會傳回第一個維度的最高索引值和 GetUpperBound(1) 傳回第二個維度的最高索引值。

Dim numbers = {{1, 2}, {3, 4}, {5, 6}}

For index0 = 0 To numbers.GetUpperBound(0)
    For index1 = 0 To numbers.GetUpperBound(1)
        Debug.Write(numbers(index0, index1).ToString & " ")
    Next
    Debug.WriteLine("")
Next
' Output 
'  1 2 
'  3 4 
'  5 6

使用 For Each...Next 陳述式 (Visual Basic)，下列範例傳遞一維陣列逐一查看。

Dim numbers = {10, 20, 30}

For Each number In numbers
    Debug.WriteLine(number)
Next
' Output:
'  10
'  20
'  30

您可以使用 For Each...Next 陳述式，下列範例將多維陣列逐一查看。 不過，更多對多維度陣列的元素，如果您使用巢狀 For…Next 陳述式，在上述範例中，而不是 For Each…Next 陳述式。

Dim numbers = {{1, 2}, {3, 4}, {5, 6}}

For Each number In numbers
    Debug.WriteLine(number)
Next
' Output:
'  1
'  2
'  3
'  4
'  5
'  6

做為傳回值和參數的陣列。

要從 Function 傳回程序的陣列，指定陣列資料型別和維度數目， Function 陳述式 (Visual Basic)的傳回型別。 在函式中，宣告與維護相同的資料型別和數值的區域變數。 在 Return 陳述式 (Visual Basic)中，包括區域變數，而不用括號。

若要指定陣列當做參數傳遞給 Sub 或 Function 程序，請定義參數做為與所指定的資料型別和數值的陣列。 在對程序的呼叫，將具有相同維度資料型別和數值的陣列變數。

在下列範例中， GetNumbers 函式會傳回 Integer()。 這個陣列型別是一維陣列型別 Integer。 ShowNumbers 程序接受 Integer() 引數。

Public Sub Process()
    Dim numbers As Integer() = GetNumbers()
    ShowNumbers(numbers)
End Sub

Private Function GetNumbers() As Integer()
    Dim numbers As Integer() = {10, 20, 30}
    Return numbers
End Function

Private Sub ShowNumbers(numbers As Integer())
    For index = 0 To numbers.GetUpperBound(0)
        Debug.WriteLine(numbers(index) & " ")
    Next
End Sub

' Output:
'   10
'   20
'   30

在下列範例中， GetNumbersMultiDim 函式會傳回 Integer(,)。 這個陣列型別是 Integer的二維陣列。 ShowNumbersMultiDim 程序接受 Integer(,) 引數。

Public Sub ProcessMultidim()
    Dim numbers As Integer(,) = GetNumbersMultidim()
    ShowNumbersMultidim(numbers)
End Sub

Private Function GetNumbersMultidim() As Integer(,)
    Dim numbers As Integer(,) = {{1, 2}, {3, 4}, {5, 6}}
    Return numbers
End Function

Private Sub ShowNumbersMultidim(numbers As Integer(,))
    For index0 = 0 To numbers.GetUpperBound(0)
        For index1 = 0 To numbers.GetUpperBound(1)
            Debug.Write(numbers(index0, index1).ToString & " ")
        Next
        Debug.WriteLine("")
    Next
End Sub

' Output  
'  1 2  
'  3 4  
'  5 6

不規則陣列

保留其他陣列的陣列，當項目，稱為陣列的陣列或不規則陣列。 不規則陣列中每個項目在不規則陣列可以有一或多個維度。 有時候應用程式中的資料結構會是非矩形的二維陣列。

下列範例包含月份，每個項目都是天數。 由於不同的月份的天數不同的數字，項目不會形成一個矩形二維陣列。 因此，不規則陣列而不是多維陣列。

' Declare the jagged array.
' The New clause sets the array variable to a 12-element
' array. Each element is an array of Double elements.
Dim sales()() As Double = New Double(11)() {}

' Set each element of the sales array to a Double
' array of the appropriate size.
For month As Integer = 0 To 11
    Dim days As Integer =
        DateTime.DaysInMonth(Year(Now), month + 1)
    sales(month) = New Double(days - 1) {}
Next month

' Store values in each element.
For month As Integer = 0 To 11
    Dim upper = sales(month).GetUpperBound(0)
    For day = 0 To upper
        sales(month)(day) = (month * 100) + day
    Next
Next

長度為零的陣列

沒有任何元素的陣列也稱為長度為零的陣列。 存放一個長度為零的陣列的變數值不是 Nothing。 若要建立沒有元素的陣列中，宣告一個陣列的大小是 -1，，如下列範例所示。

Dim twoDimensionalStrings(-1, 3) As String

在下列情況中，您可能需要建立長度為零的陣列：

  • 而不會有發生 NullReferenceException 例外狀況的風險，您的程式碼必須存取 Array 類別的成員，例如 Length 或 Rank，或是呼叫 Visual Basic 函式 (例如 UBound)。

  • 您希望不需檢查 Nothing (以特殊情況處理)，讓使用程式碼更簡單。

  • 您的程式碼與要求您將長度為零的陣列加入至一個或多個程序或傳回一個或多個程序的長度為零的陣列的 API (API) 互動。

陣列大小

陣列大小為其所有維度 (Dimension) 長度之乘積。 它代表目前包含於陣列中的元素總數。

下列範例宣告一個三維陣列︰

Dim prices(3, 4, 5) As Long

變數 prices 陣列的整體大小為 (3 + 1) x (4 + 1) x (5 + 1) = 120。

您可以使用 Length 屬性來尋找陣列的大小。 您也可以使用 GetLength 方法來尋找多維陣列中每一維的長度。

您可以指派新的陣列物件或者使用 ReDim 陳述式來調整陣列變數的大小。

處理陣列大小時，請注意幾點︰

維度長度

每個維度的索引都以 0 為起點，也就是它的範圍是由 0 到它的上限 (Upper Bound)。 因此，指定維度的長度會比該維度的宣告上限多 1。

長度限制

每個陣列之維度長度都受限於 Integer 資料型別的最大值，也就是 (2 ^ 31) - 1。 然而，陣列之總大小也同時受限於系統可用的記憶體。 若您試圖對總大小超過可用的 RAM 之陣列進行初始化，Common Language Runtime 將擲回 OutOfMemoryException 例外狀況。

大小及元素大小

陣列大小與其元素的資料型別無關。 大小永遠是指元素的總數，而不是它們於儲存體中所佔的位元組。

記憶體消耗量

對陣列在記憶體中的儲存方式做任何假設都是不安全的。 儲存體會因不同資料寬度的平台而有差異，所以相同陣列於 64 位元系統上所佔記憶體將較 32 位元系統來的多。 當您初始化陣列時，隨著系統組態不同，Common Language Runtime (CLR) 會指派儲存體盡可能將元素存放在一起，或是根據實體硬體界限將它們全部加以調整。 同時，陣列需要耗用儲存體以供其控制資訊使用，此消耗量會隨著維度增加而增加。

陣列型別及其他型別

每個陣列都具有其資料型別，但此資料型別不同於陣列元素的資料型別。 沒有任何單一的資料型別適用於所有的陣列。 陣列的型別是由陣列的維度數目 (或稱為「順位」(Rank) 以及陣列元素的資料型別決定。 只要兩個陣列變數具有相同順位且其元素具有相同的資料型別，就會視為具有相同的資料型別。 陣列中維度的長度不會影響陣列的資料型別。

每個陣列繼承自 System.Array 類別，且可將變數宣告為型別 Array，但您不能建立型別為 Array 變數。 同時，ReDim 陳述式 (Visual Basic) 無法在型別宣告為 Array 的變數上運作。 由於這些原因及型別安全，建議您將每個陣列宣告為特定型別，如前述範例中的 Integer。

有幾個方法可以找出陣列或其元素的資料型別。

  • 您可以在變數上呼叫 Object.GetType 方法，以接收變數的執行階段型別的 Type 物件。 Type 物件在其屬性和方法中保留了大量的資訊。

  • 您可以將變數傳遞給 TypeName 函式，以接收包含執行階段型別名稱的 String。

  • 您可以將變數傳遞給 VarType 函式，以接收表示變數型別類別的 VariantType 值。

下列範例呼叫 TypeName 函式來判斷陣列的型別以及陣列中元素的型別。 陣列型別為 Integer(,)，陣列中元素的型別為 Integer。

Dim thisTwoDimArray(,) As Integer = New Integer(9, 9) {}
MsgBox("Type of thisTwoDimArray is " & TypeName(thisTwoDimArray))
MsgBox("Type of thisTwoDimArray(0, 0) is " & TypeName(thisTwoDimArray(0, 0)))

使用集合取代陣列

陣列為建立和最有用的強型別物件一起使用固定數目。 集合提供一個較具彈性的方式在使用物件群組方面則。 不同於陣列，您可以與一起使用的物件群組動態成長縮小為應用程式變更的需要。

如果必須變更陣列的大小，請務必使用 ReDim 陳述式 (Visual Basic)。 當您這麼做時，Visual Basic 會建立新的陣列，並釋出先前的陣列以供處置 (Dispose)。 這將佔用執行時間。 因此，如果您處理的項目數經常變更，或無法預測需要的最大項目數，您可以使用集合來達到較佳的效能。

對於某些集合，您可以將機碼加入至使用索引鍵到任何您放入集合的物件，讓您可以藉由使用這個索引鍵快速擷取物件。

若集合受限於只有一種資料型別的元素，則可使用 System.Collections.Generic 命名空間內的類別之一。 「泛型」(Generic) 集合會強制「型別安全」(Type Safety)，如此就不會加入其他資料型別。 當您從泛型集合中擷取元素，並不需要判斷其資料型別或將之轉換。

如需集合的詳細資訊，請參閱 集合 (C# 和 Visual Basic)。

wak0wfyt.collapse_all(zh-tw,VS.110).gif範例

下列範例使用 .NET Framework 泛型類別 System.Collections.Generic.List<T> 來建立 Customer 物件的清單集合。

' Define the class for a customer.
Public Class Customer
    Public Property Name As String
    ' Insert code for other members of customer structure.
End Class

' Create a module-level collection that can hold 200 elements.
Public CustomerList As New List(Of Customer)(200)

' Add a specified customer to the collection.
Private Sub AddNewCustomer(ByVal newCust As Customer)
    ' Insert code to perform validity check on newCust.
    CustomerList.Add(newCust)
End Sub

' Display the list of customers in the Debug window.
Private Sub PrintCustomers()
    For Each cust As Customer In CustomerList
        Debug.WriteLine(cust)
    Next cust
End Sub

CustomerFile 集合的宣告指定它僅可包含型別 Customer 的項目。 同時也提供 200 個項目的初始容量。 程序 AddNewCustomer 會檢查新項目的有效性，然後將它加入集合中。 程序 PrintCustomers 會使用 For Each 迴圈以便穿越集合並顯示項目。

相關主題

詞彙

定義

Visual Basic 中的陣列維度

說明陣列中的陣序規範和維度 (Dimension)。

如何：在 Visual Basic 中初始化陣列變數

描述如何在陣列中填入初始值。

HOW TO：在 Visual Basic 中排序陣列

示範如何依字母順序排列陣列中的元素。

HOW TO：指派一個陣列至另一個陣列 (Visual Basic)

描述將陣列指派給另一個陣列變數的規則和步驟。

疑難排解陣列 (Visual Basic)

討論在使用陣列時會引發的一些常見問題。

請參閱

參考

Dim 陳述式 (Visual Basic)

ReDim 陳述式 (Visual Basic)

Array