كائن صفيفة

مقالة
11/01/2010

توفير الدعم صفائف expando أي نوع بيانات. هناك ثلاثة نماذج من Arrayالدالة الإنشائية.

function Array( [size : int] )
function Array( [... varargs : Object[]] ) 
function Array( [array : System.Array )

الوسيطات

size
اختياري. الحجم صفيفة. كـ صفائف zero-bكـed، سيكون العناصر التي تم إنشاؤها من الفهارس من الصفر إلى size-1.
varargs
اختياري. صفيفة مصنف يحتوي على الجميع المعلمات التي تم تمريرها إلى الدالة الإنشائية. يتم استخدام هذه المعلمات كعناصر الأولى صفيفة.
صفيف
اختياري. صفيفة ليتم نسخها إلى الصفيف الذي يتم بناء.

ملاحظات

إذا كان يتم تمرير وسيطة واحدة إلى Arrayالدالة الإنشائية والوسيطة عبارة عن رقم، يجب أن يكون عددا صحيحاً 32 بت غير موقعة (أي عدد صحيح أصغر من من تقريبا من أربع مليارات). القيمة التي تم تمريرها هو الحجم الصفيف. إذا كانت القيمة رقماً أصغر من من الصفر أو ليس عددا صحيحاً، يحدث خطأ وقت التشغيل.

يمكن تمرير متغير من نوع بيانات النظام.صفيفة إلى Arrayالمنشئ. وينتج هذا صفيفة JScript هو نسخ من صفيفة إدخال. يجب أن يكون النظام.صفيفة بعد واحد فقط.

If a مفرد القيمة هو passed إلى the Array الدالة الإنشائية و it ليس a رقم أو an صفيفة, the الطول خاصية of the صفيفة هو التعيين إلى 1, و the القيمة of the أول عنصر of the صفيفة (عنصر 0) becomes the مفرد, passed-في وسيطة. If several الوسيطات are passed إلى the الدالة الإنشائية, the الطول of the صفيفة هو التعيين إلى the رقم of الوسيطات, و those الوسيطات will be the أول عناصر في the جديد صفيفة.

Notice that JScript arrays are sparse arrays; that هو, although you can يخصص an صفيفة مع many عناصر, فقط the عناصر that actually contain بيانات exist. This reduces the المقدار of ذاكرة used بواسطة the صفيفة.

The Array كائن interoperates مع النظام.صفيفة نوع بيانات. Consequently, an Array كائن can يتصل the وظائف و خصائص of the النظام.صفيفة نوع بيانات, و a النظام.صفيفة نوع بيانات can يتصل the وظائف و خصائص of the Array كائن. Furthermore, Array الكائنات are accepted بواسطة دالات that take النظام.صفيفة بيانات أنواع, و vice versa. للحصول على مزيد من المعلومات، راجع صفيفة الأعضاء .

عند Arrayالكائن هو الذي تم تمريره إلى دالة التي تأخذ النظام.صفيفة أو عند يتم استدعاء وظائف النظام.صفيفة من Arrayالكائن، المحتويات Arrayيتم نسخ. وهكذا، الأصلي Arrayلا يمكن ‏‏تاريخ التعديل كائن وظائف النظام.صفيفة أو بتمرير فإنه إلى دالة يقبل النظام.صفيفة. فقط nondestructive Arrayوظائف يمكن استدعاء تشغيل النظام.صفيفة.

تلميح
Arrayالكائنات ملائمة عند الحاجة كدسة عامة أو lهوt العناصر والأداء هو لا أحد العليا مهما. في الجميع سياقات غير ذلك، كتبت صفيفة يجب استخدام أنواع بيانات. صفيفة مكتوب، والذي يحتوي على الكثير من نفس الوظيفة Arrayالكائن، وأيضا على توفير نوع أمان وتحسينات أداء أفضل من التفاعل مع غير ذلك اللغات.

Arrayالكائنات ملائمة عند الحاجة كدسة عامة أو lهوt العناصر والأداء هو لا أحد العليا مهما. في الجميع سياقات غير ذلك، كتبت صفيفة يجب استخدام أنواع بيانات. صفيفة مكتوب، والذي يحتوي على الكثير من نفس الوظيفة Arrayالكائن، وأيضا على توفير نوع أمان وتحسينات أداء أفضل من التفاعل مع غير ذلك اللغات.

ملاحظة

Arrayكائن يتعاون مع.NET Framework النظام.صفيفة نوع بيانات بداخل JScript. ومع ذلك، لا يمكن للغات غير ذلك مواصفة اللغة العامة (CLS) استخدام Arrayالكائن لأن JScript فقط يوفر الكائن؛ فإنه هو غير مشتق من نوع إطار عمل.NET. وبالتالي، عند إدخال تعليق نوع-توضيحي المعلمات ثم رجوع أنواع الطرق متوافق مع CLS، تأكد من أنك تستخدم نوع بيانات النظام.صفيفة بدلاً من Arrayالكائن. ومع ذلك، يمكنك استخدام Arrayالكائن إلى نوع تعليقاً توضيحياً على معرفات غير المعلمات أو إرجاع نوع s. للحصول على مزيد من المعلومات، راجع كتابة تعليمات برمجية المتوافق مع CLS.

مثال

عناصر فردية صفيفة يمكن الوصول إلى استخدام منهج []. فعلى سبيل المثال:

var my_array = new Array();
for (var i = 0; i < 10; i++) {
   my_array[i] = i;
}
var x = my_array[4];

وبما أن تكون صفائف في JScript Microsoft Office 2010 Suite zero-based، العبارة الأخيرة في يسبق مثال الوصول إلى العنصر الخامس من الصفيف. هذا العنصر يحتوي على القيمة 4.