Matrizes multidimensionais (Guia de Programação em C#)

Arrays podem ter mais de uma dimensão. Por exemplo, a declaração a seguir cria uma matriz bidimensional de quatro linhas e duas colunas.

int[,] array = new int[4, 2];

A declaração a seguir cria uma matriz de três dimensões, 4, 2 e 3.

int[, ,] array1 = new int[4, 2, 3];

Inicialização de matriz

Você pode inicializar a matriz na declaração, como é mostrado no exemplo a seguir.

// Two-dimensional array. 
int[,] array2D = new int[,] { { 1, 2 }, { 3, 4 }, { 5, 6 }, { 7, 8 } };
// The same array with dimensions specified. 
int[,] array2Da = new int[4, 2] { { 1, 2 }, { 3, 4 }, { 5, 6 }, { 7, 8 } };
// A similar array with string elements. 
string[,] array2Db = new string[3, 2] { { "one", "two" }, { "three", "four" },
                                        { "five", "six" } };

// Three-dimensional array. 
int[, ,] array3D = new int[,,] { { { 1, 2, 3 }, { 4, 5, 6 } }, 
                                 { { 7, 8, 9 }, { 10, 11, 12 } } };
// The same array with dimensions specified. 
int[, ,] array3Da = new int[2, 2, 3] { { { 1, 2, 3 }, { 4, 5, 6 } }, 
                                       { { 7, 8, 9 }, { 10, 11, 12 } } };

// Accessing array elements.
System.Console.WriteLine(array2D[0, 0]);
System.Console.WriteLine(array2D[0, 1]);
System.Console.WriteLine(array2D[1, 0]);
System.Console.WriteLine(array2D[1, 1]);
System.Console.WriteLine(array2D[3, 0]);
System.Console.WriteLine(array2Db[1, 0]);
System.Console.WriteLine(array3Da[1, 0, 1]);
System.Console.WriteLine(array3D[1, 1, 2]);

// Getting the total count of elements or the length of a given dimension. 
var allLength = array3D.Length;
var total = 1;
for (int i = 0; i < array3D.Rank; i++) {
    total *= array3D.GetLength(i);
}
System.Console.WriteLine("{0} equals {1}", allLength, total);

// Output: 
// 1 
// 2 
// 3 
// 4 
// 7 
// three 
// 8 
// 12 
// 12 equals 12

Você também pode inicializar a matriz sem especificar a classificação.

int[,] array4 = { { 1, 2 }, { 3, 4 }, { 5, 6 }, { 7, 8 } };

Se você escolher declarar uma variável de matriz sem inicialização, você deve usar o new operador para atribuir uma matriz à variável. O uso de new é mostrado no exemplo a seguir.

int[,] array5;
array5 = new int[,] { { 1, 2 }, { 3, 4 }, { 5, 6 }, { 7, 8 } };   // OK 
//array5 = {{1,2}, {3,4}, {5,6}, {7,8}};   // Error

O exemplo a seguir atribui um valor a um elemento de matriz específico.

array5[2, 1] = 25;

Da mesma forma, o exemplo a seguir obtém o valor de um elemento de matriz específico e atribui a variável elementValue.

int elementValue = array5[2, 1];

O exemplo de código a seguir inicializa os elementos da matriz para valores padrão (exceto para matrizes denteadas).

int[,] array6 = new int[10, 10];

Consulte também

Referência

Matrizes (Guia de Programação em C#)

Matrizes unidimensionais (Guia de Programação em C#)

Matrizes denteadas (Guia de Programação em C#)

Conceitos

Guia de Programação em C#