C# 中数组的 LongLength 属性有什么作用？

在C#的数组操作中，获取数组长度是高频需求，除了常用的Length属性，还有一个LongLength属性，它主要用来处理超大数组的长度获取场景，避免长度值超出普通整型的范围。

LongLength 属性的基本定义

LongLength是System.Array类的一个只读属性，返回类型为long（即Int64），表示数组中所有维度的元素总数。它的设计初衷是解决Length属性的返回类型为int（即Int32）的问题，当数组的元素总数超过int类型的最大值2147483647时，Length属性会出现溢出，而LongLength可以正确返回完整的元素数量。

LongLength 与 Length 的区别

两者的核心差异体现在返回类型和适用场景上，具体对比如下：

LongLength 的使用示例

下面通过两个示例分别展示普通数组和超大数组场景下两个属性的表现：

示例1：普通数组的使用

对于元素数量较少的普通数组，两个属性返回的结果一致：

using System;

class Program
{
    static void Main()
    {
        // 定义一个包含5个元素的int数组
        int[] normalArray = new int[5] { 1, 2, 3, 4, 5 };
        
        Console.WriteLine("普通数组Length值：" + normalArray.Length);
        Console.WriteLine("普通数组LongLength值：" + normalArray.LongLength);
        // 输出结果均为5，两者一致
    }
}

示例2：超大数组的场景说明

由于普通开发环境很难直接创建超过int最大值的数组（需要极大的内存支持），我们可以通过模拟场景理解LongLength的作用：

using System;

class Program
{
    static void Main()
    {
        // 模拟一个元素数量超过int最大值的数组场景
        // 假设数组元素总数为int.MaxValue + 1L
        long totalElements = (long)int.MaxValue + 1L;
        
        // 如果此时用Length属性获取长度，会发生溢出，返回错误值
        // 而LongLength可以正确返回totalElements的值
        Console.WriteLine("模拟超大数组的元素总数：" + totalElements);
        Console.WriteLine("如果Length属性返回会溢出，LongLength可正确返回：" + totalElements);
    }
}

使用注意事项

• 如果是常规业务中的普通数组，优先使用Length属性即可，LongLength的使用场景非常有限，仅在确定数组元素可能超过int最大值时才需要使用。
• LongLength返回的是数组所有维度的元素总数量，对于多维数组同样适用，比如二维数组的LongLength就是行数乘列数的结果。
• 不要为了统一代码风格在所有数组场景下都使用LongLength，因为返回值是long类型，如果后续和int类型的索引做运算，可能需要额外的类型转换，反而增加不必要的代码复杂度。

总结

C#数组的LongLength属性是对Length属性的补充，专门用于处理超大数组的长度获取问题，避免整型溢出。大部分日常开发场景中，Length属性已经足够满足需求，开发者可以根据数组的实际规模选择合适的属性，既保证代码的正确性，也维持代码的简洁性。

C#数组LongLength属性数组长度修改时间：2026-06-09 18:00:28