diff --git a/xml/System/Array.xml b/xml/System/Array.xml index 7b926113681..178c80a3a69 100644 --- a/xml/System/Array.xml +++ b/xml/System/Array.xml @@ -70,8 +70,10 @@ An element is a value in an . The length of an is the total number of elements it can contain. The lower bound of an is the index of its first element. An can have any lower bound, but it has a lower bound of zero by default. A different lower bound can be defined when creating an instance of the class using .A multidimensional can have different bounds for each dimension. An array can have a maximum of 32 dimensions. Unlike the classes in the namespaces, has a fixed capacity. To increase the capacity, you must create a new object with the required capacity, copy the elements from the old object to the new one, and delete the old . + + The array size is limited to a total of 4 billion elements, and to a maximum index of 0X7FEFFFFF in any given dimension (0X7FFFFFC7 for byte arrays and arrays of single-byte structures). - By default, the maximum size of an is 2 gigabytes (GB). In a 64-bit environment, you can avoid the size restriction by setting the `enabled` attribute of the [gcAllowVeryLargeObjects](~/docs/framework/configure-apps/file-schema/runtime/gcallowverylargeobjects-element.md) configuration element to `true` in the run-time environment. However, the array will still be limited to a total of 4 billion elements, and to a maximum index of 0X7FEFFFFF in any given dimension (0X7FFFFFC7 for byte arrays and arrays of single-byte structures). + **.NET Framework only:** By default, the maximum size of an is 2 gigabytes (GB). In a 64-bit environment, you can avoid the size restriction by setting the `enabled` attribute of the [gcAllowVeryLargeObjects](~/docs/framework/configure-apps/file-schema/runtime/gcallowverylargeobjects-element.md) configuration element to `true` in the run-time environment. Single-dimensional arrays implement the , , , and generic interfaces. The implementations are provided to arrays at run time, and as a result, the generic interfaces do not appear in the declaration syntax for the class. In addition, there are no reference topics for interface members that are accessible only by casting an array to the generic interface type (explicit interface implementations). The key thing to be aware of when you cast an array to one of these interfaces is that members which add, insert, or remove elements throw . @@ -9936,4 +9938,4 @@ int[,,] TDArray = new int[1,1,1]; - \ No newline at end of file +