كيفية القيام بما يلي: إضافة، حذف و استرداد عناصر المجموعة

الفئة Visual Basic Collection تحتوي على وظيفة مضمنة للسماح لك بإضافة و حذف و استرداد العناصر.

  • قد تحتاج إلى إضافة عنصر إلى مجموعة بمجرد إنشاء العنصر أو الحصول على إنترنت، مثل عميل جديد حديثاً.

  • قد تحتاج إلى حذف العنصر من مجموعة عند ينتمي لم يعد في المجموعة، على سبيل المثال عندما يترك أحد الموظفين شركتك.

  • قد تحتاج إلى استرداد العنصر من مجموعة لتحرير محتوياته على سبيل المثال لتغيير رقم هاتف الطالب.

ملاحظة

كائنات Collection تقوم بتحديث أرقام فهرس الرقمي بهم تلقائياً بينما تضيف و يحذف العناصر. لهذا السبب، يمكن تغيير الفهرس الرقمي للعنصر المعيّن غالباً. ولذلك، لا تقم بحفظ قيمة الفهرس الرقمي ثم تتوقع أن استرداد نفس عنصر فيما بعد في برنامج البريد. استخدم مفاتيح لهذا الغرض.

لإضافة علامة إلى عنصر:

  • استخدام أسلوب Add وتحديد العنصر بواسطة الخاصة به Key.

    object.Add(Item, Key [, {Before | After}])

    على سبيل المثال، لإضافة ترتيب عمل كائن إلى مجموعة العمل الطلبيات باستخدام ترتيب العمل ID خاصية كمفتاح يمكنك إجراء ما يلي يتصل.

    workOrders.Add(woNew, woNew.ID)
    

    الاتصال السابق يفترض ان خاصية السلسلة هي ID . إذا كان رقم (على سبيل المثال، Long عدد صحيح) ، استخدم الخاصة به ToString أسلوب لتحويله إلى String القيمة المطلوبة Key وسيطة.

    workOrders.Add(woNew, woNew.ID.ToString())
    

    الاستخدام الاختياري لمصادقة مسبقة. إذا كنت لا تريد إرفاق المفتاح مع كائن في المجموعة, قد إضافته بدون المفتاح.

    workOrders.Add(woNew)
    

    يمكنك استخدام الوسيطات الاختياريةBefore و After إلى المحافظة على مجموعة مرتبة من الكائنات. يتم وضع العنصر المطلوب إضافته في مجموعة قبل أو بعد العنصر المعرفة من قبل وسيطة Before أو After ، على التوالي. على سبيل المثال، تعيين Before تساوي 1 إدراج العنصر في بداية المجموعة، لأنه Collection الكائنات المستندة إلى 1.

    workOrders.Add(woNew, woNew.ID, 1)
    

    وبشكل مماثل، After يضيف وسيطة العنصر بعد الفهرس المحدد. في المثال التالي على إضافة العنصر كعنصر الثالث.

    workOrders.Add(woNew, woNew.ID,,2)
    

    يمكنك تحديد القيمة من أجل Before أو After، وليس كلاهما.

لحذف عنصرا من مجموعة

  • استخدم اسلوب Remove و قم بتحديد العنصر بواسطة إما الخاصة به Index أو الخاصة به Key.

    object.Remove({Index | Key})

    وسيطة Index هو موضع العنصر الذي تريده إلى يحذف. الوسيطة Key هي السلسلة المستخدمة لإضافة العنصر إلى المجموعة. إذا كان المفتاح الثالثة عنصر في مجموعة "W017493" ، يمكنك استخدام أي من العبارات التالية جهازي لحذفه.

    workOrders.Remove(3)
    workOrders.Remove("W017493")
    

لحذف كل العناصر من مجموعة

  • استخدم الأسلوب Clear.

    object.Clear()

    الاسلوب Clear empties مجموعة.

لاسترداد عنصر ما من مجموعة

  1. استخدم اسلوب Item و قم بتحديد العنصر بواسطة إما الخاصة به Index أو الخاصة به Key.

    variable = object.Item({Index | Key})

    كما مع الاسلوب Remove وسيطة Index هي موضع العنصر في مجموعة, و الوسيطة Key هي السلسلة المستخدمة عندما تم تمت الإضافة العنصر. باستخدام المثال نفس عن الاسلوب Remove أي من العبارات التالية باسترداد العنصر الثالث في مجموعة.

    woCurrent = workOrders.Item(3)
    woCurrent = workOrders.Item("W017493")
    

    ملاحظة

    إذا كنت تستخدم الأرقام كمفاتيح يجب عليك استخدام الخاصة بهمToString أساليب لتحويلها إلى سلاسل قبل تمريرها إلى Add أو اسلوب Remove, أو لخاصية Item خاصية. كائن Visual Basic Collection دوماً يفترض أن رقم فهرس بدلاً من سلسلة مفاتيح.

  2. إذا كنت تعرف المفتاح في وقت يحول برمجياً يمكنك بدلاً من استخدام العامل الوصول القاموس (!) الوصول إلى عنصر في المجموعة دون إحاطة المفتاح بعلامات اقتباس أو أقواس. قد تتم كتابة استدعاء السابق كما يلي.

    woCurrent = workOrders!W017493
    

راجع أيضًا:

المبادئ

فئة مجموعة Visual Basic

الصفائف في Visual Basic

الـمجموعات في Visual Basic