مشاركة عبر

ControlCollection.AddListObject أسلوب (Range, String)

  • مقالة

قم بإضافة جديد ListObjectعنصر تحكم إلى ورقة عمل في النطاق المحدد.

مساحة الاسم:  Microsoft.Office.Tools.Excel
التجميع:  Microsoft.Office.Tools.Excel (في Microsoft.Office.Tools.Excel.dll)

بناء الجملة

'إقرار
Function AddListObject ( _
    range As Range, _
    name As String _
) As ListObject

ListObject AddListObject(
    Range range,
    string name
)

المعلمات

  • name
    النوع: System.String
    اسم عنصر التحكم الذي يمكن أن تستخدم لفهرسة عنصر التحكم في ControlCollectionمثيل.

القيمة المُرجعة

النوع: Microsoft.Office.Tools.Excel.ListObject
ListObjectعنصر تحكم تمت إضافته إلى ControlCollectionالمثيل.

استثناءات

استثناء: شرط
ArgumentNullException

وسيطة اسم أو النطاق هو nullمرجع خالٍ (لا شيء في Visual Basic)، أو وسيطة "اسم" الطول الصفرية.
ControlNameAlreadyExistsException

عنصر تحكم بنفس الاسم هو موجود بالفعل في ControlCollectionالمثيل.
InvalidRangeException

النطاق الذي تم تحديده هو غير صالح. لا يمكن استخدام نطاقات multi-مساحة. يجب أن يكون النطاق ورقة عمل نفسها ك ControlCollectionمثيل.

ملاحظات

AddListObjectأسلوب تمكنك من إضافة ListObjectعناصر التحكم إلى النهاية ControlCollection. لإزالة ListObjectعنصر تحكم الذي تم مسبقاً إضافته برمجياً، استخدم Removeالأسلوب.

أمثلة

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

Private Sub ExcelAddListObject()
    Dim List1 As Microsoft.Office.Tools.Excel. _
        ListObject = Me.Controls.AddListObject( _
        Me.Range("A1", "C5"), "List1")

    MessageBox.Show("The list object has " _
        & List1.Range.Rows.Count.ToString() + " rows.")

End Sub

private void ExcelAddListObject()
{
    Microsoft.Office.Tools.Excel.ListObject list1 =
        this.Controls.AddListObject(this.Range["A1", "C5"], 
        "list1");
    MessageBox.Show("The list object has " + 
        list1.Range.Rows.Count.ToString() + " rows.");
}

أمن NET Framework.

راجع أيضًَا

المرجع

ControlCollection واجهة

ControlCollection الأعضاء

AddListObject التحميل الزائد

Microsoft.Office.Tools.Excel مساحة الاسم