Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Método Array.GetLowerBound (Int32)

 

Obtém o índice do primeiro elemento da dimensão especificada na matriz.

Namespace:   System
Assembly:  mscorlib (em mscorlib.dll)

public int GetLowerBound(
	int dimension
)

Parâmetros

dimension
Type: System.Int32

Uma dimensão com base em zero da matriz cujo índice inicial precisa ser determinada.

Valor Retornado

Type: System.Int32

O índice do primeiro elemento da dimensão especificada na matriz.

Exception Condition
IndexOutOfRangeException

dimension é menor que zero.

-ou-

dimension é maior ou igual a Rank.

GetLowerBound(0) Retorna o índice inicial da primeira dimensão da matriz, e GetLowerBound(Rank - 1) retorna o índice inicial da última dimensão da matriz.

O GetLowerBound método sempre retorna um valor que indica o índice do limite inferior da matriz, mesmo se a matriz está vazia.

Observe que, embora a maioria das matrizes no .NET Framework são baseadas em zero (ou seja, o GetLowerBound método retorna zero para cada dimensão de uma matriz), o .NET Framework oferece suporte a matrizes que não são de base zero. Essas matrizes podem ser criados com o CreateInstance(Type, Int32[], Int32[]) método e também pode ser retornado de código não gerenciado.

Esse método é uma operação (1).

O exemplo a seguir usa a GetLowerBound e GetUpperBound métodos para exibir os limites de uma matriz unidimensional e bidimensional e exibir os valores de seus elementos de matriz.

using System;

public class Example
{
   public static void Main()  
   {
      // Create a one-dimensional integer array.
      int[] integers = { 2, 4, 6, 8, 10, 12, 14, 16, 18, 20 };
      // Get the upper and lower bound of the array.
      int upper = integers.GetUpperBound(0);
      int lower = integers.GetLowerBound(0);
      Console.WriteLine("Elements from index {0} to {1}:", lower, upper);
      // Iterate the array.
      for (int ctr = lower; ctr <= upper; ctr++)
        Console.Write("{0}{1}{2}", ctr == lower ? "   " : "", 
                                  integers[ctr], 
                                  ctr < upper ? ", " : Environment.NewLine);

      Console.WriteLine();

      // Create a two-dimensional integer array.
      int[,] integers2d= { {2, 4}, {3, 9}, {4, 16}, {5, 25}, 
                           {6, 36}, {7, 49}, {8, 64}, {9, 81} }; 
      // Get the number of dimensions.                               
      int rank = integers2d.Rank;  
      Console.WriteLine("Number of dimensions: {0}", rank);      
      for (int ctr = 0; ctr < integers2d.Rank - 1; ctr++)
        Console.WriteLine("   Dimension {0}: from {1} to {2}",
                          ctr, integers2d.GetLowerBound(ctr),
                          integers2d.GetUpperBound(ctr));

      // Iterate the 2-dimensional array and display its values.
      Console.WriteLine("   Values of array elements:");
      for (int outer = integers2d.GetLowerBound(0); outer <= integers2d.GetUpperBound(0);
           outer++)
        for (int inner = integers2d.GetLowerBound(1); inner <= integers2d.GetUpperBound(1);
             inner++)
           Console.WriteLine("      {3}{0}, {1}{4} = {2}", outer, inner,
                             integers2d.GetValue(outer, inner), "{", "}");

   }
}
// The example displays the following output:
//       Elements from index 0 to 9:
//          2, 4, 6, 8, 10, 12, 14, 16, 18, 20
//       
//       Number of dimensions: 2
//          Dimension 0: from 0 to 7
//          Dimension 1: from 0 to 1
//          Values of array elements:
//             {0, 0} = 2
//             {0, 1} = 4
//             {1, 0} = 3
//             {1, 1} = 9
//             {2, 0} = 4
//             {2, 1} = 16
//             {3, 0} = 5
//             {3, 1} = 25
//             {4, 0} = 6
//             {4, 1} = 36
//             {5, 0} = 7
//             {5, 1} = 49
//             {6, 0} = 8
//             {6, 1} = 64
//             {7, 0} = 9
//             {7, 1} = 81

Plataforma Universal do Windows
Disponível desde 8
.NET Framework
Disponível desde 1.1
Biblioteca de Classes Portátil
Com suporte no: plataformas portáteis do .NET
Silverlight
Disponível desde 2.0
Windows Phone Silverlight
Disponível desde 7.0
Windows Phone
Disponível desde 8.1
Retornar ao início
Mostrar: