Compartilhar via


Matrizes multidimensionais (guia de programação de 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 array

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]);

// Output:
// 1
// 2
// 3
// 4
// 7
// three
// 8
// 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 o operador para atribuir uma matriz para a 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 para 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 os valores padrão (exceto para matrizes denteadas).

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

Consulte também

Referência

Arrays (C# Programming Guide)

O único-de matrizes unidimensionais (guia de programação de C#)

Matrizes denteadas (guia de programação de C#)

Conceitos

C# Programming Guide