İngilizce dilinde oku

Aracılığıyla paylaş


Array.GetLength(Int32) Yöntem

Tanım

öğesinin belirtilen boyutundaki Arrayöğelerin sayısını temsil eden 32 bitlik bir tamsayı alır.

C#
public int GetLength (int dimension);

Parametreler

dimension
Int32

Uzunluğunun belirlenmesi gereken öğesinin Array sıfır tabanlı boyutu.

Döndürülenler

Int32

Belirtilen boyuttaki öğelerin sayısını temsil eden 32 bitlik bir tamsayı.

Özel durumlar

dimension, sıfırdan küçüktür.

-veya-

dimension eşittir veya değerinden Rankbüyüktür.

Örnekler

Aşağıdaki örnekte, farklı derecelere sahip iki dizinin boyutlarını görüntülemek için nasıl kullanılacağı GetLength gösterilmektedir.

C#
using System;

public class SamplesArray
{
    public static void Main()
    {
        // make a single dimension array
        Array MyArray1 = Array.CreateInstance(typeof(int), 5);

        // make a 3 dimensional array
        Array MyArray2 = Array.CreateInstance(typeof(int), 5, 3, 2);

        // make an array container
        Array BossArray = Array.CreateInstance(typeof(Array), 2);
        BossArray.SetValue(MyArray1, 0);
        BossArray.SetValue(MyArray2, 1);

        int i = 0, j, rank;
        foreach (Array anArray in BossArray)
        {
            rank = anArray.Rank;
            if (rank > 1)
            {
                Console.WriteLine("Lengths of {0:d} dimension array[{1:d}]", rank, i);
                // show the lengths of each dimension
                for (j = 0; j < rank; j++)
                {
                    Console.WriteLine("    Length of dimension({0:d}) = {1:d}", j, anArray.GetLength(j));
                }
            }
            else
            {
                Console.WriteLine("Lengths of single dimension array[{0:d}]", i);
            }
            // show the total length of the entire array or all dimensions
            Console.WriteLine("    Total length of the array = {0:d}", anArray.Length);
            Console.WriteLine();
            i++;
        }
    }
}

/*
This code produces the following output:

Lengths of single dimension array[0]
    Total length of the array = 5

Lengths of 3 dimension array[1]
    Length of dimension(0) = 5
    Length of dimension(1) = 3
    Length of dimension(2) = 2
    Total length of the array = 30
*/

Açıklamalar

Örneğin GetLength , GetLength(0)öğesinin ilk boyutundaki öğelerin sayısını döndüren değeridir Array.

Bu yöntem bir O(1) işlemidir.

Şunlara uygulanır

Ürün Sürümler
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Ayrıca bkz.