ControlCollection.AddListObject Metoda

Definice

Přetížení

AddListObject(ListObject)

Přidá sadu Visual Studio ListObject do kolekce ovládacích prvků na základě zadaného nativního typu ListObject .

AddListObject(Range, String)

Přidá nový ListObject ovládací prvek do listu v zadaném rozsahu.

AddListObject(ListObject)

Přidá sadu Visual Studio ListObject do kolekce ovládacích prvků na základě zadaného nativního typu ListObject .

public Microsoft.Office.Tools.Excel.ListObject AddListObject (Microsoft.Office.Interop.Excel.ListObject listObject);

Parametry

listObject
ListObject

Nativní ListObject .

Návraty

ListObject

Sada Visual Studio ListObject , která byla přidána do kolekce ovládacích prvků.

Výjimky

listObjectArgument je null nebo má nulovou délku.

ListObjectDo instance již byl přidán ovládací prvek se stejným názvem ControlCollection .

Poznámky

Tuto metodu byste neměli volat přímo z vašeho kódu. Místo toho zavolejte Microsoft.Office.Tools.Excel.Extensions.ListObjectExtensions.GetVstoObject metodu rozšíření pro získání sady Visual Studio Microsoft.Office.Tools.Excel.ListObject .

Microsoft.Office.Tools.Excel.Extensions.ListObjectExtensions.GetVstoObjectMetoda rozšíření používá tuto metodu k vygenerování sady Visual Studio Microsoft.Office.Tools.Excel.ListObject , která odpovídá instanci nativního Microsoft.Office.Interop.Excel.ListObject .

Microsoft.Office.Tools.Excel.Extensions.ListObjectExtensions.GetVstoObjectMetoda rozšíření vytvoří rozšířenou Microsoft.Office.Tools.Excel.ListObject pouze jednou. Vrací stejnou instanci existujícího rozšířeného objektu v následných voláních. Naproti tomu AddListObject nově vytvoří nový rozšířený Microsoft.Office.Tools.Excel.ListObject čas.

Platí pro

AddListObject(Range, String)

Přidá nový ListObject ovládací prvek do listu v zadaném rozsahu.

public Microsoft.Office.Tools.Excel.ListObject AddListObject (Microsoft.Office.Interop.Excel.Range range, string name);

Parametry

range
Range

Range, Který poskytuje meze pro ovládací prvek.

name
String

Název ovládacího prvku, který lze použít k indexování ovládacího prvku v ControlCollection instanci.

Návraty

ListObject

ListObjectOvládací prvek, který byl přidán do ControlCollection instance.

Výjimky

Argument name nebo Range je null , nebo má argument name nulovou délku.

V instanci již je ovládací prvek se stejným názvem ControlCollection .

Zadaný rozsah není platný. Rozsahy s více oblastmi nelze použít. Rozsah by měl být na stejném listu jako ControlCollection instance.

Příklady

Následující příklad kódu přidá ListObject ovládací prvek do horní části listu a potom zobrazí okno se zprávou, které zobrazuje počet řádků v ListObject .

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.");
}
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

Poznámky

AddListObjectMetoda umožňuje přidat ListObject ovládací prvky na konec ControlCollection . Chcete-li odebrat ListObject ovládací prvek, který byl dříve přidán programově, použijte Remove metodu.

Platí pro