Array.CreateInstance 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
初始化 Array 類別的新執行個體。
多載
CreateInstance(Type, Int32)
- 來源:
- Array.cs
- 來源:
- Array.cs
- 來源:
- Array.cs
- 來源:
- Array.cs
- 來源:
- Array.cs
public:
static Array ^ CreateInstance(Type ^ elementType, int length);public static Array CreateInstance(Type elementType, int length);[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("The code for an array of the specified type might not be available.")]
public static Array CreateInstance(Type elementType, int length);static member CreateInstance : Type * int -> Array[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("The code for an array of the specified type might not be available.")>]
static member CreateInstance : Type * int -> ArrayPublic Shared Function CreateInstance (elementType As Type, length As Integer) As Array參數
傳回
一個新的一維ArrayType，具有指定長度，使用零為基礎的索引。
- 屬性
例外狀況
elementType 是 null。
elementType 不是有效的 Type。
length 小於零。
範例
以下程式碼範例展示了如何建立並初始化一維 Array。
open System
let printValues (myArr: Array) =
let mutable i = 0
let cols = myArr.GetLength(myArr.Rank - 1)
for item in myArr do
if i < cols then
i <- i + 1
else
printfn ""
i <- 1
printf $"\t{item}"
printfn ""
// Creates and initializes a one-dimensional Array of type int.
let my1DArray = Array.CreateInstance(typeof<int>, 5)
// let my1DArrayy = Array.zeroCreate<int> 5
for i = my1DArray.GetLowerBound 0 to my1DArray.GetUpperBound 0 do
my1DArray.SetValue(i+1, i)
// Displays the values of the Array.
printfn "The one-dimensional Array contains the following values:"
printValues my1DArray
// This code produces the following output.
// The one-dimensional Array contains the following values:
// 1 2 3 4 5
using System;
public class SamplesArray {
public static void Main() {
// Creates and initializes a one-dimensional Array of type int.
Array my1DArray=Array.CreateInstance( typeof(int), 5 );
for ( int i = my1DArray.GetLowerBound(0); i <= my1DArray.GetUpperBound(0); i++ )
my1DArray.SetValue( i+1, i );
// Displays the values of the Array.
Console.WriteLine( "The one-dimensional Array contains the following values:" );
PrintValues( my1DArray );
}
public static void PrintValues( Array myArr ) {
System.Collections.IEnumerator myEnumerator = myArr.GetEnumerator();
int i = 0;
int cols = myArr.GetLength( myArr.Rank - 1 );
while ( myEnumerator.MoveNext() ) {
if ( i < cols ) {
i++;
} else {
Console.WriteLine();
i = 1;
}
Console.Write( "\t{0}", myEnumerator.Current );
}
Console.WriteLine();
}
}
/*
This code produces the following output.
The one-dimensional Array contains the following values:
1 2 3 4 5
*/
Public Class SamplesArray
Public Shared Sub Main()
' Creates and initializes a one-dimensional Array of type Int32.
Dim my1DArray As Array = Array.CreateInstance(GetType(Int32), 5)
Dim i As Integer
For i = my1DArray.GetLowerBound(0) To my1DArray.GetUpperBound(0)
my1DArray.SetValue(i + 1, i)
Next i
' Displays the values of the Array.
Console.WriteLine("The one-dimensional Array contains the " _
+ "following values:")
PrintValues(my1DArray)
End Sub
Public Shared Sub PrintValues(myArr As Array)
Dim myEnumerator As System.Collections.IEnumerator = _
myArr.GetEnumerator()
Dim i As Integer = 0
Dim cols As Integer = myArr.GetLength((myArr.Rank - 1))
While myEnumerator.MoveNext()
If i < cols Then
i += 1
Else
Console.WriteLine()
i = 1
End If
Console.Write(ControlChars.Tab + "{0}", myEnumerator.Current)
End While
Console.WriteLine()
End Sub
End Class
' This code produces the following output.
'
' The one-dimensional Array contains the following values:
' 1 2 3 4 5
備註
與大多數類別不同，提供 ArrayCreateInstance 方法而非公開建構子，以允許延遲綁定存取。
參考型元素初始化為 null。 值型元素初始化為零。
此方法是一個 O（n） 運算，其中 n 為 length。
在 F# 中，通常會使用 Array.zeroCreate 函式。
適用於
CreateInstance(Type, Int32[])
- 來源:
- Array.cs
- 來源:
- Array.cs
- 來源:
- Array.cs
- 來源:
- Array.cs
- 來源:
- Array.cs
public:
static Array ^ CreateInstance(Type ^ elementType, ... cli::array <int> ^ lengths);public static Array CreateInstance(Type elementType, params int[] lengths);[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("The code for an array of the specified type might not be available.")]
public static Array CreateInstance(Type elementType, params int[] lengths);static member CreateInstance : Type * int[] -> Array[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("The code for an array of the specified type might not be available.")>]
static member CreateInstance : Type * int[] -> ArrayPublic Shared Function CreateInstance (elementType As Type, ParamArray lengths As Integer()) As Array參數
傳回
一個新的多維 Array 度， Type 每個維度的長度為指定，使用零為基礎的索引。
- 屬性
例外狀況
任何 的 lengths 值都小於零。
範例
以下程式碼範例展示了如何建立並初始化多維 Array。
open System
let printValues (myArray: Array) =
let mutable i = 0
let cols = myArray.GetLength(myArray.Rank - 1)
for item in myArray do
if i < cols then
i <- i + 1
else
printfn ""
i <- 1;
printf $"\t{item}"
printfn ""
// Creates and initializes a multidimensional Array of type string.
let my4DArray = Array.CreateInstance( typeof<string>, [| 2..5 |] )
for i = my4DArray.GetLowerBound 0 to my4DArray.GetUpperBound 0 do
for j = my4DArray.GetLowerBound 1 to my4DArray.GetUpperBound 1 do
for k = my4DArray.GetLowerBound 2 to my4DArray.GetUpperBound 2 do
for l = my4DArray.GetLowerBound 3 to my4DArray.GetUpperBound 3 do
let myIndicesArray = [| i; j; k; l |]
my4DArray.SetValue($"{i}{j}{k}{l}", myIndicesArray)
// Displays the values of the Array.
printfn "The four-dimensional Array contains the following values:"
printValues my4DArray
// This code produces the following output.
// The four-dimensional Array contains the following values:
// 0000 0001 0002 0003 0004
// 0010 0011 0012 0013 0014
// 0020 0021 0022 0023 0024
// 0030 0031 0032 0033 0034
// 0100 0101 0102 0103 0104
// 0110 0111 0112 0113 0114
// 0120 0121 0122 0123 0124
// 0130 0131 0132 0133 0134
// 0200 0201 0202 0203 0204
// 0210 0211 0212 0213 0214
// 0220 0221 0222 0223 0224
// 0230 0231 0232 0233 0234
// 1000 1001 1002 1003 1004
// 1010 1011 1012 1013 1014
// 1020 1021 1022 1023 1024
// 1030 1031 1032 1033 1034
// 1100 1101 1102 1103 1104
// 1110 1111 1112 1113 1114
// 1120 1121 1122 1123 1124
// 1130 1131 1132 1133 1134
// 1200 1201 1202 1203 1204
// 1210 1211 1212 1213 1214
// 1220 1221 1222 1223 1224
// 1230 1231 1232 1233 1234
using System;
public class SamplesArray3 {
public static void Main() {
// Creates and initializes a multidimensional Array of type string.
int[] myLengthsArray = new int[4] { 2, 3, 4, 5 };
Array my4DArray=Array.CreateInstance( typeof(string), myLengthsArray );
for ( int i = my4DArray.GetLowerBound(0); i <= my4DArray.GetUpperBound(0); i++ )
for ( int j = my4DArray.GetLowerBound(1); j <= my4DArray.GetUpperBound(1); j++ )
for ( int k = my4DArray.GetLowerBound(2); k <= my4DArray.GetUpperBound(2); k++ )
for ( int l = my4DArray.GetLowerBound(3); l <= my4DArray.GetUpperBound(3); l++ ) {
int[] myIndicesArray = new int[4] { i, j, k, l };
my4DArray.SetValue( Convert.ToString(i) + j + k + l, myIndicesArray );
}
// Displays the values of the Array.
Console.WriteLine( "The four-dimensional Array contains the following values:" );
PrintValues( my4DArray );
}
public static void PrintValues( Array myArr ) {
System.Collections.IEnumerator myEnumerator = myArr.GetEnumerator();
int i = 0;
int cols = myArr.GetLength( myArr.Rank - 1 );
while ( myEnumerator.MoveNext() ) {
if ( i < cols ) {
i++;
} else {
Console.WriteLine();
i = 1;
}
Console.Write( "\t{0}", myEnumerator.Current );
}
Console.WriteLine();
}
}
/*
This code produces the following output.
The four-dimensional Array contains the following values:
0000 0001 0002 0003 0004
0010 0011 0012 0013 0014
0020 0021 0022 0023 0024
0030 0031 0032 0033 0034
0100 0101 0102 0103 0104
0110 0111 0112 0113 0114
0120 0121 0122 0123 0124
0130 0131 0132 0133 0134
0200 0201 0202 0203 0204
0210 0211 0212 0213 0214
0220 0221 0222 0223 0224
0230 0231 0232 0233 0234
1000 1001 1002 1003 1004
1010 1011 1012 1013 1014
1020 1021 1022 1023 1024
1030 1031 1032 1033 1034
1100 1101 1102 1103 1104
1110 1111 1112 1113 1114
1120 1121 1122 1123 1124
1130 1131 1132 1133 1134
1200 1201 1202 1203 1204
1210 1211 1212 1213 1214
1220 1221 1222 1223 1224
1230 1231 1232 1233 1234
*/
Public Class SamplesArray
Public Shared Sub Main()
' Creates and initializes a multidimensional Array of type String.
Dim myLengthsArray() As Integer = {2, 3, 4, 5}
Dim my4DArray As Array = Array.CreateInstance(GetType(String), myLengthsArray)
Dim i, j, k, l As Integer
Dim myIndicesArray() As Integer
For i = my4DArray.GetLowerBound(0) To my4DArray.GetUpperBound(0)
For j = my4DArray.GetLowerBound(1) To my4DArray.GetUpperBound(1)
For k = my4DArray.GetLowerBound(2) To my4DArray.GetUpperBound(2)
For l = my4DArray.GetLowerBound(3) To my4DArray.GetUpperBound(3)
myIndicesArray = New Integer() {i, j, k, l}
my4DArray.SetValue(Convert.ToString(i) + j.ToString() _
+ k.ToString() + l.ToString(), myIndicesArray)
Next l
Next k
Next j
Next i
' Displays the values of the Array.
Console.WriteLine("The four-dimensional Array contains the following values:")
PrintValues(my4DArray)
End Sub
Public Shared Sub PrintValues(myArr As Array)
Dim myEnumerator As System.Collections.IEnumerator = myArr.GetEnumerator()
Dim i As Integer = 0
Dim cols As Integer = myArr.GetLength(myArr.Rank - 1)
While myEnumerator.MoveNext()
If i < cols Then
i += 1
Else
Console.WriteLine()
i = 1
End If
Console.Write(ControlChars.Tab + "{0}", myEnumerator.Current)
End While
Console.WriteLine()
End Sub
End Class
' This code produces the following output.
'
' The four-dimensional Array contains the following values:
' 0000 0001 0002 0003 0004
' 0010 0011 0012 0013 0014
' 0020 0021 0022 0023 0024
' 0030 0031 0032 0033 0034
' 0100 0101 0102 0103 0104
' 0110 0111 0112 0113 0114
' 0120 0121 0122 0123 0124
' 0130 0131 0132 0133 0134
' 0200 0201 0202 0203 0204
' 0210 0211 0212 0213 0214
' 0220 0221 0222 0223 0224
' 0230 0231 0232 0233 0234
' 1000 1001 1002 1003 1004
' 1010 1011 1012 1013 1014
' 1020 1021 1022 1023 1024
' 1030 1031 1032 1033 1034
' 1100 1101 1102 1103 1104
' 1110 1111 1112 1113 1114
' 1120 1121 1122 1123 1124
' 1130 1131 1132 1133 1134
' 1200 1201 1202 1203 1204
' 1210 1211 1212 1213 1214
' 1220 1221 1222 1223 1224
' 1230 1231 1232 1233 1234
備註
與大多數類別不同，提供 ArrayCreateInstance 方法而非公開建構子，以允許延遲綁定存取。
陣列中的 lengths 元素數必須等於新 Array的維度數。 陣列中的 lengths 每個元素必須指定新 Array中對應維度的長度。
參考型元素初始化為 null。 值型元素初始化為零。
此方法為 O（n） 運算，其中 n 是所有 中 lengths值的乘積。
適用於
CreateInstance(Type, Int64[])
- 來源:
- Array.cs
- 來源:
- Array.cs
- 來源:
- Array.cs
- 來源:
- Array.cs
- 來源:
- Array.cs
public:
static Array ^ CreateInstance(Type ^ elementType, ... cli::array <long> ^ lengths);[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("The code for an array of the specified type might not be available.")]
public static Array CreateInstance(Type elementType, params long[] lengths);public static Array CreateInstance(Type elementType, params long[] lengths);[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("The code for an array of the specified type might not be available.")>]
static member CreateInstance : Type * int64[] -> Arraystatic member CreateInstance : Type * int64[] -> ArrayPublic Shared Function CreateInstance (elementType As Type, ParamArray lengths As Long()) As Array參數
- lengths
- Int64[]
一個由 64 位元整數組成的陣列，代表 to create 的每個維度 Array 大小。 陣列中的每個整數必須介於零與 Int32.MaxValue 之間，包含。
傳回
一個新的多維 Array 度， Type 每個維度的長度為指定，使用零為基礎的索引。
- 屬性
例外狀況
任何 的 lengths 值都小於零或大於 Int32.MaxValue。
範例
以下程式碼範例展示了如何建立並初始化多維 Array。
open System
let printValues (myArray: Array) =
let mutable i = 0
let cols = myArray.GetLength(myArray.Rank - 1)
for item in myArray do
if i < cols then
i <- i + 1
else
printfn ""
i <- 1;
printf $"\t{item}"
printfn ""
// Creates and initializes a multidimensional Array of type string.
let my4DArray = Array.CreateInstance( typeof<string>, [| 2..5 |] )
for i = my4DArray.GetLowerBound 0 to my4DArray.GetUpperBound 0 do
for j = my4DArray.GetLowerBound 1 to my4DArray.GetUpperBound 1 do
for k = my4DArray.GetLowerBound 2 to my4DArray.GetUpperBound 2 do
for l = my4DArray.GetLowerBound 3 to my4DArray.GetUpperBound 3 do
let myIndicesArray = [| i; j; k; l |]
my4DArray.SetValue($"{i}{j}{k}{l}", myIndicesArray)
// Displays the values of the Array.
printfn "The four-dimensional Array contains the following values:"
printValues my4DArray
// This code produces the following output.
// The four-dimensional Array contains the following values:
// 0000 0001 0002 0003 0004
// 0010 0011 0012 0013 0014
// 0020 0021 0022 0023 0024
// 0030 0031 0032 0033 0034
// 0100 0101 0102 0103 0104
// 0110 0111 0112 0113 0114
// 0120 0121 0122 0123 0124
// 0130 0131 0132 0133 0134
// 0200 0201 0202 0203 0204
// 0210 0211 0212 0213 0214
// 0220 0221 0222 0223 0224
// 0230 0231 0232 0233 0234
// 1000 1001 1002 1003 1004
// 1010 1011 1012 1013 1014
// 1020 1021 1022 1023 1024
// 1030 1031 1032 1033 1034
// 1100 1101 1102 1103 1104
// 1110 1111 1112 1113 1114
// 1120 1121 1122 1123 1124
// 1130 1131 1132 1133 1134
// 1200 1201 1202 1203 1204
// 1210 1211 1212 1213 1214
// 1220 1221 1222 1223 1224
// 1230 1231 1232 1233 1234
using System;
public class SamplesArray3 {
public static void Main() {
// Creates and initializes a multidimensional Array of type string.
int[] myLengthsArray = new int[4] { 2, 3, 4, 5 };
Array my4DArray=Array.CreateInstance( typeof(string), myLengthsArray );
for ( int i = my4DArray.GetLowerBound(0); i <= my4DArray.GetUpperBound(0); i++ )
for ( int j = my4DArray.GetLowerBound(1); j <= my4DArray.GetUpperBound(1); j++ )
for ( int k = my4DArray.GetLowerBound(2); k <= my4DArray.GetUpperBound(2); k++ )
for ( int l = my4DArray.GetLowerBound(3); l <= my4DArray.GetUpperBound(3); l++ ) {
int[] myIndicesArray = new int[4] { i, j, k, l };
my4DArray.SetValue( Convert.ToString(i) + j + k + l, myIndicesArray );
}
// Displays the values of the Array.
Console.WriteLine( "The four-dimensional Array contains the following values:" );
PrintValues( my4DArray );
}
public static void PrintValues( Array myArr ) {
System.Collections.IEnumerator myEnumerator = myArr.GetEnumerator();
int i = 0;
int cols = myArr.GetLength( myArr.Rank - 1 );
while ( myEnumerator.MoveNext() ) {
if ( i < cols ) {
i++;
} else {
Console.WriteLine();
i = 1;
}
Console.Write( "\t{0}", myEnumerator.Current );
}
Console.WriteLine();
}
}
/*
This code produces the following output.
The four-dimensional Array contains the following values:
0000 0001 0002 0003 0004
0010 0011 0012 0013 0014
0020 0021 0022 0023 0024
0030 0031 0032 0033 0034
0100 0101 0102 0103 0104
0110 0111 0112 0113 0114
0120 0121 0122 0123 0124
0130 0131 0132 0133 0134
0200 0201 0202 0203 0204
0210 0211 0212 0213 0214
0220 0221 0222 0223 0224
0230 0231 0232 0233 0234
1000 1001 1002 1003 1004
1010 1011 1012 1013 1014
1020 1021 1022 1023 1024
1030 1031 1032 1033 1034
1100 1101 1102 1103 1104
1110 1111 1112 1113 1114
1120 1121 1122 1123 1124
1130 1131 1132 1133 1134
1200 1201 1202 1203 1204
1210 1211 1212 1213 1214
1220 1221 1222 1223 1224
1230 1231 1232 1233 1234
*/
Public Class SamplesArray
Public Shared Sub Main()
' Creates and initializes a multidimensional Array of type String.
Dim myLengthsArray() As Integer = {2, 3, 4, 5}
Dim my4DArray As Array = Array.CreateInstance(GetType(String), myLengthsArray)
Dim i, j, k, l As Integer
Dim myIndicesArray() As Integer
For i = my4DArray.GetLowerBound(0) To my4DArray.GetUpperBound(0)
For j = my4DArray.GetLowerBound(1) To my4DArray.GetUpperBound(1)
For k = my4DArray.GetLowerBound(2) To my4DArray.GetUpperBound(2)
For l = my4DArray.GetLowerBound(3) To my4DArray.GetUpperBound(3)
myIndicesArray = New Integer() {i, j, k, l}
my4DArray.SetValue(Convert.ToString(i) + j.ToString() _
+ k.ToString() + l.ToString(), myIndicesArray)
Next l
Next k
Next j
Next i
' Displays the values of the Array.
Console.WriteLine("The four-dimensional Array contains the following values:")
PrintValues(my4DArray)
End Sub
Public Shared Sub PrintValues(myArr As Array)
Dim myEnumerator As System.Collections.IEnumerator = myArr.GetEnumerator()
Dim i As Integer = 0
Dim cols As Integer = myArr.GetLength(myArr.Rank - 1)
While myEnumerator.MoveNext()
If i < cols Then
i += 1
Else
Console.WriteLine()
i = 1
End If
Console.Write(ControlChars.Tab + "{0}", myEnumerator.Current)
End While
Console.WriteLine()
End Sub
End Class
' This code produces the following output.
'
' The four-dimensional Array contains the following values:
' 0000 0001 0002 0003 0004
' 0010 0011 0012 0013 0014
' 0020 0021 0022 0023 0024
' 0030 0031 0032 0033 0034
' 0100 0101 0102 0103 0104
' 0110 0111 0112 0113 0114
' 0120 0121 0122 0123 0124
' 0130 0131 0132 0133 0134
' 0200 0201 0202 0203 0204
' 0210 0211 0212 0213 0214
' 0220 0221 0222 0223 0224
' 0230 0231 0232 0233 0234
' 1000 1001 1002 1003 1004
' 1010 1011 1012 1013 1014
' 1020 1021 1022 1023 1024
' 1030 1031 1032 1033 1034
' 1100 1101 1102 1103 1104
' 1110 1111 1112 1113 1114
' 1120 1121 1122 1123 1124
' 1130 1131 1132 1133 1134
' 1200 1201 1202 1203 1204
' 1210 1211 1212 1213 1214
' 1220 1221 1222 1223 1224
' 1230 1231 1232 1233 1234
備註
與大多數類別不同，提供 ArrayCreateInstance 方法而非公開建構子，以允許延遲綁定存取。
陣列中的 lengths 元素數必須等於新 Array的維度數。 陣列中的 lengths 每個元素必須指定新 Array中對應維度的長度。
參考型元素初始化為 null。 值型元素初始化為零。
此方法為 O（n） 運算，其中 n 是所有 中 lengths值的乘積。
適用於
CreateInstance(Type, Int32, Int32)
- 來源:
- Array.cs
- 來源:
- Array.cs
- 來源:
- Array.cs
- 來源:
- Array.cs
- 來源:
- Array.cs
public:
static Array ^ CreateInstance(Type ^ elementType, int length1, int length2);public static Array CreateInstance(Type elementType, int length1, int length2);static member CreateInstance : Type * int * int -> ArrayPublic Shared Function CreateInstance (elementType As Type, length1 As Integer, length2 As Integer) As Array參數
傳回
一個新的二維ArrayType，每個維度的長度為指定，並使用以零為基礎的索引。
例外狀況
elementType 是 null。
elementType 不是有效的 Type。
範例
以下程式碼範例說明如何建立並初始化二維 Array。
open System
let printValues (myArray: Array) =
let mutable i = 0
let cols = myArray.GetLength(myArray.Rank - 1)
for item in myArray do
if i < cols then
i <- i + 1
else
printfn ""
i <- 1;
printf $"\t{item}"
printfn ""
// Creates and initializes a two-dimensional Array of type string.
let my2DArray = Array.CreateInstance(typeof<string>, 2, 3)
// let my2DArray2 = Array2D.zeroCreate<string> 2 3
for i = my2DArray.GetLowerBound 0 to my2DArray.GetUpperBound 0 do
for j = my2DArray.GetLowerBound 1 to my2DArray.GetUpperBound 1 do
my2DArray.SetValue( $"abc{i}{j}", i, j )
// Displays the values of the Array.
printfn "The two-dimensional Array contains the following values:"
printValues my2DArray
// This code produces the following output.
// The two-dimensional Array contains the following values:
// abc00 abc01 abc02
// abc10 abc11 abc12
using System;
public class SamplesArray1 {
public static void Main() {
// Creates and initializes a two-dimensional Array of type string.
Array my2DArray=Array.CreateInstance( typeof(string), 2, 3 );
for ( int i = my2DArray.GetLowerBound(0); i <= my2DArray.GetUpperBound(0); i++ )
for ( int j = my2DArray.GetLowerBound(1); j <= my2DArray.GetUpperBound(1); j++ )
my2DArray.SetValue( "abc" + i + j, i, j );
// Displays the values of the Array.
Console.WriteLine( "The two-dimensional Array contains the following values:" );
PrintValues( my2DArray );
}
public static void PrintValues( Array myArr ) {
System.Collections.IEnumerator myEnumerator = myArr.GetEnumerator();
int i = 0;
int cols = myArr.GetLength( myArr.Rank - 1 );
while ( myEnumerator.MoveNext() ) {
if ( i < cols ) {
i++;
} else {
Console.WriteLine();
i = 1;
}
Console.Write( "\t{0}", myEnumerator.Current );
}
Console.WriteLine();
}
}
/*
This code produces the following output.
The two-dimensional Array contains the following values:
abc00 abc01 abc02
abc10 abc11 abc12
*/
Public Class SamplesArray
Public Shared Sub Main()
' Creates and initializes a two-dimensional Array of type String.
Dim my2DArray As Array = Array.CreateInstance(GetType(String), 2, 3)
Dim i, j As Integer
For i = my2DArray.GetLowerBound(0) To my2DArray.GetUpperBound(0)
For j = my2DArray.GetLowerBound(1) To my2DArray.GetUpperBound(1)
my2DArray.SetValue("abc" + i.ToString() + j.ToString(), i, j)
Next j
Next i
' Displays the values of the Array.
Console.WriteLine("The two-dimensional Array contains the " _
+ "following values:")
PrintValues(my2DArray)
End Sub
Public Shared Sub PrintValues(myArr As Array)
Dim myEnumerator As System.Collections.IEnumerator = _
myArr.GetEnumerator()
Dim i As Integer = 0
Dim cols As Integer = myArr.GetLength(myArr.Rank - 1)
While myEnumerator.MoveNext()
If i < cols Then
i += 1
Else
Console.WriteLine()
i = 1
End If
Console.Write(ControlChars.Tab + "{0}", myEnumerator.Current)
End While
Console.WriteLine()
End Sub
End Class
' This code produces the following output.
'
' The two-dimensional Array contains the following values:
' abc00 abc01 abc02
' abc10 abc11 abc12
備註
與大多數類別不同，提供 ArrayCreateInstance 方法而非公開建構子，以允許延遲綁定存取。
參考型元素初始化為 null。 值型元素初始化為零。
此方法為 O（n） 運算，其中 n 是 和 length1的length2乘積。
在 F# 中，可以使用 Array2D.zeroCreate 函式。
適用於
CreateInstance(Type, Int32[], Int32[])
- 來源:
- Array.cs
- 來源:
- Array.cs
- 來源:
- Array.cs
- 來源:
- Array.cs
- 來源:
- Array.cs
public:
static Array ^ CreateInstance(Type ^ elementType, cli::array <int> ^ lengths, cli::array <int> ^ lowerBounds);public static Array CreateInstance(Type elementType, int[] lengths, int[] lowerBounds);[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("The code for an array of the specified type might not be available.")]
public static Array CreateInstance(Type elementType, int[] lengths, int[] lowerBounds);static member CreateInstance : Type * int[] * int[] -> Array[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("The code for an array of the specified type might not be available.")>]
static member CreateInstance : Type * int[] * int[] -> ArrayPublic Shared Function CreateInstance (elementType As Type, lengths As Integer(), lowerBounds As Integer()) As Array參數
傳回
一個新的多維 Array 度， Type 每個維度的長度和下界都指定。
- 屬性
例外狀況
範例
以下程式碼範例展示了如何建立並初始化具有指定下界的多維 Array 資料庫。
open System
let printValues (myArray: Array) =
let mutable i = 0
let cols = myArray.GetLength(myArray.Rank - 1)
for item in myArray do
if i < cols then
i <- i + 1
else
printfn ""
i <- 1;
printf $"\t{item}"
printfn ""
// Creates and initializes a multidimensional Array of type string.
let myLengthsArray = [| 3; 5 |]
let myBoundsArray = [| 2; 3 |]
let myArray = Array.CreateInstance(typeof<string>, myLengthsArray, myBoundsArray)
for i = myArray.GetLowerBound 0 to myArray.GetUpperBound 0 do
for j = myArray.GetLowerBound 1 to myArray.GetUpperBound 1 do
let myIndicesArray = [| i; j |]
myArray.SetValue($"{i}{j}", myIndicesArray)
// Displays the lower bounds and the upper bounds of each dimension.
printfn "Bounds:\tLower\tUpper"
for i = 0 to myArray.Rank - 1 do
printfn $"{i}:\t{myArray.GetLowerBound i}\t{myArray.GetUpperBound i}"
// Displays the values of the Array.
printfn "The Array contains the following values:"
printValues myArray
// This code produces the following output.
// Bounds: Lower Upper
// 0: 2 4
// 1: 3 7
// The Array contains the following values:
// 23 24 25 26 27
// 33 34 35 36 37
// 43 44 45 46 47
using System;
public class SamplesArray4 {
public static void Main() {
// Creates and initializes a multidimensional Array of type string.
int[] myLengthsArray = new int[2] { 3, 5 };
int[] myBoundsArray = new int[2] { 2, 3 };
Array myArray=Array.CreateInstance( typeof(string), myLengthsArray, myBoundsArray );
for ( int i = myArray.GetLowerBound(0); i <= myArray.GetUpperBound(0); i++ )
for ( int j = myArray.GetLowerBound(1); j <= myArray.GetUpperBound(1); j++ ) {
int[] myIndicesArray = new int[2] { i, j };
myArray.SetValue( Convert.ToString(i) + j, myIndicesArray );
}
// Displays the lower bounds and the upper bounds of each dimension.
Console.WriteLine( "Bounds:\tLower\tUpper" );
for ( int i = 0; i < myArray.Rank; i++ )
Console.WriteLine( "{0}:\t{1}\t{2}", i, myArray.GetLowerBound(i), myArray.GetUpperBound(i) );
// Displays the values of the Array.
Console.WriteLine( "The Array contains the following values:" );
PrintValues( myArray );
}
public static void PrintValues( Array myArr ) {
System.Collections.IEnumerator myEnumerator = myArr.GetEnumerator();
int i = 0;
int cols = myArr.GetLength( myArr.Rank - 1 );
while ( myEnumerator.MoveNext() ) {
if ( i < cols ) {
i++;
} else {
Console.WriteLine();
i = 1;
}
Console.Write( "\t{0}", myEnumerator.Current );
}
Console.WriteLine();
}
}
/*
This code produces the following output.
Bounds: Lower Upper
0: 2 4
1: 3 7
The Array contains the following values:
23 24 25 26 27
33 34 35 36 37
43 44 45 46 47
*/
using System;
public class SamplesArray4 {
public static void Main() {
// Creates and initializes a multidimensional Array of type string.
int[] myLengthsArray = new int[2] { 3, 5 };
int[] myBoundsArray = new int[2] { 2, 3 };
Array myArray=Array.CreateInstance( typeof(string), myLengthsArray, myBoundsArray );
for ( int i = myArray.GetLowerBound(0); i <= myArray.GetUpperBound(0); i++ )
for ( int j = myArray.GetLowerBound(1); j <= myArray.GetUpperBound(1); j++ ) {
int[] myIndicesArray = new int[2] { i, j };
myArray.SetValue( Convert.ToString(i) + j, myIndicesArray );
}
// Displays the lower bounds and the upper bounds of each dimension.
Console.WriteLine( "Bounds:\tLower\tUpper" );
for ( int i = 0; i < myArray.Rank; i++ )
Console.WriteLine( "{0}:\t{1}\t{2}", i, myArray.GetLowerBound(i), myArray.GetUpperBound(i) );
// Displays the values of the Array.
Console.WriteLine( "The Array contains the following values:" );
PrintValues( myArray );
}
public static void PrintValues( Array myArr ) {
System.Collections.IEnumerator myEnumerator = myArr.GetEnumerator();
int i = 0;
int cols = myArr.GetLength( myArr.Rank - 1 );
while ( myEnumerator.MoveNext() ) {
if ( i < cols ) {
i++;
} else {
Console.WriteLine();
i = 1;
}
Console.Write( "\t{0}", myEnumerator.Current );
}
Console.WriteLine();
}
}
/*
This code produces the following output.
Bounds: Lower Upper
0: 2 4
1: 3 7
The Array contains the following values:
23 24 25 26 27
33 34 35 36 37
43 44 45 46 47
*/
備註
與大多數類別不同，提供 ArrayCreateInstance 方法而非公開建構子，以允許延遲綁定存取。
lengths和lowerBounds陣列必須有相同數量的元素。 陣列中的 lengths 元素數必須等於新 Array的維度數。
陣列中的 lengths 每個元素必須指定新 Array中對應維度的長度。
陣列中的 lowerBounds 每個元素必須指定新 Array中對應維度的下界。 一般來說，.NET 類別函式庫和許多程式語言不處理非零的下界。
參考型元素初始化為 null。 值型元素初始化為零。
此方法為 O（n） 運算，其中 n 是所有 中 lengths值的乘積。
Note
並非所有語言都支援下限非零的陣列，因此你可能無法根據該語言的陣列類型來鑄造非零 Array 的實例。 例如，你無法將一個下界為 6 的 C# int[] 類型一維整數陣列。 執行 InvalidCastException 時會出現訊息：「無法將類型為 'System.Int32[*]' 的物件 cast 為類型 'System.Int32[]'.」，其中星號（*）代表非零基索引。 不過，你可以將任何 CreateInstance(Type, Int32[], Int32[]) 階級的零基礎陣列投射到該語言的陣列中。 例如，你可以用這個方法將一個以零為基礎的二維整數陣列鑄造成 C# int[,] 的型別。
適用於
CreateInstance(Type, Int32, Int32, Int32)
- 來源:
- Array.cs
- 來源:
- Array.cs
- 來源:
- Array.cs
- 來源:
- Array.cs
- 來源:
- Array.cs
public:
static Array ^ CreateInstance(Type ^ elementType, int length1, int length2, int length3);public static Array CreateInstance(Type elementType, int length1, int length2, int length3);static member CreateInstance : Type * int * int * int -> ArrayPublic Shared Function CreateInstance (elementType As Type, length1 As Integer, length2 As Integer, length3 As Integer) As Array參數
傳回
一個新的三維ArrayType，每個維度的長度為指定，使用零為基礎的索引。
例外狀況
elementType 是 null。
elementType 不是有效的 Type。
範例
以下程式碼範例展示了如何建立並初始化三維 Array。
open System
let printValues (myArray: Array) =
let mutable i = 0
let cols = myArray.GetLength(myArray.Rank - 1)
for item in myArray do
if i < cols then
i <- i + 1
else
printfn ""
i <- 1;
printf $"\t{item}"
printfn ""
// Creates and initializes a three-dimensional Array of type Object.
let my3DArray = Array.CreateInstance(typeof<obj>, 2, 3, 4 )
// let my3dArray = Array3D.zeroCreate<obj> 2 3 4
for i = my3DArray.GetLowerBound 0 to my3DArray.GetUpperBound 0 do
for j = my3DArray.GetLowerBound 1 to my3DArray.GetUpperBound 1 do
for k = my3DArray.GetLowerBound 2 to my3DArray.GetUpperBound 2 do
my3DArray.SetValue($"abc{i}{j}{k}", i, j, k)
// Displays the values of the Array.
printfn "The three-dimensional Array contains the following values:"
printValues my3DArray
// This code produces the following output.
// The three-dimensional Array contains the following values:
// abc000 abc001 abc002 abc003
// abc010 abc011 abc012 abc013
// abc020 abc021 abc022 abc023
// abc100 abc101 abc102 abc103
// abc110 abc111 abc112 abc113
// abc120 abc121 abc122 abc123
using System;
public class SamplesArray2 {
public static void Main() {
// Creates and initializes a three-dimensional Array of type Object.
Array my3DArray=Array.CreateInstance( typeof(Object), 2, 3, 4 );
for ( int i = my3DArray.GetLowerBound(0); i <= my3DArray.GetUpperBound(0); i++ )
for ( int j = my3DArray.GetLowerBound(1); j <= my3DArray.GetUpperBound(1); j++ )
for ( int k = my3DArray.GetLowerBound(2); k <= my3DArray.GetUpperBound(2); k++ )
my3DArray.SetValue( "abc" + i + j + k, i, j, k );
// Displays the values of the Array.
Console.WriteLine( "The three-dimensional Array contains the following values:" );
PrintValues( my3DArray );
}
public static void PrintValues( Array myArr ) {
System.Collections.IEnumerator myEnumerator = myArr.GetEnumerator();
int i = 0;
int cols = myArr.GetLength( myArr.Rank - 1 );
while ( myEnumerator.MoveNext() ) {
if ( i < cols ) {
i++;
} else {
Console.WriteLine();
i = 1;
}
Console.Write( "\t{0}", myEnumerator.Current );
}
Console.WriteLine();
}
}
/*
This code produces the following output.
The three-dimensional Array contains the following values:
abc000 abc001 abc002 abc003
abc010 abc011 abc012 abc013
abc020 abc021 abc022 abc023
abc100 abc101 abc102 abc103
abc110 abc111 abc112 abc113
abc120 abc121 abc122 abc123
*/
Public Class SamplesArray
Public Shared Sub Main()
' Creates and initializes a three-dimensional Array of type Object.
Dim my3DArray As Array = Array.CreateInstance(GetType(Object), 2, 3, 4)
Dim i As Integer
For i = my3DArray.GetLowerBound(0) To my3DArray.GetUpperBound(0)
Dim j As Integer
For j = my3DArray.GetLowerBound(1) To my3DArray.GetUpperBound(1)
Dim k As Integer
For k = my3DArray.GetLowerBound(2) To my3DArray.GetUpperBound(2)
my3DArray.SetValue("abc" + i.ToString() _
+ j.ToString() + k.ToString(), i, j, k)
Next k
Next j
Next i
' Displays the values of the Array.
Console.WriteLine("The three-dimensional Array contains the " _
+ "following values:")
PrintValues(my3DArray)
End Sub
Public Shared Sub PrintValues(myArr As Array)
Dim myEnumerator As System.Collections.IEnumerator = _
myArr.GetEnumerator()
Dim i As Integer = 0
Dim cols As Integer = myArr.GetLength(myArr.Rank - 1)
While myEnumerator.MoveNext()
If i < cols Then
i += 1
Else
Console.WriteLine()
i = 1
End If
Console.Write(ControlChars.Tab + "{0}", myEnumerator.Current)
End While
Console.WriteLine()
End Sub
End Class
' This code produces the following output.
'
' The three-dimensional Array contains the following values:
' abc000 abc001 abc002 abc003
' abc010 abc011 abc012 abc013
' abc020 abc021 abc022 abc023
' abc100 abc101 abc102 abc103
' abc110 abc111 abc112 abc113
' abc120 abc121 abc122 abc123
備註
與大多數類別不同，提供 ArrayCreateInstance 方法而非公開建構子，以允許延遲綁定存取。
參考型元素初始化為 null。 值型元素初始化為零。
此方法是一個 O（n） 運算，其中 n 是 、 length1和 length2的乘積length3。
在 F# 中，可以使用 Array3D.zeroCreate 函式。
