ControlCollection.AddListObject – metoda (Range, String)

Článek
08/11/2011

Přidá nový ListObject řízení v rozsahu určeném listu.

Obor názvů: Microsoft.Office.Tools.Excel
Sestavení: Microsoft.Office.Tools.Excel (v Microsoft.Office.Tools.Excel.dll)

Syntaxe

'Deklarace
Function AddListObject ( _
    range As Range, _
    name As String _
) As ListObject

ListObject AddListObject(
    Range range,
    string name
)

Parametry

range
Typ: Microsoft.Office.Interop.Excel.Range
A Range , který poskytuje hranice ovládacího prvku.

name
Typ: System.String
Název ovládacího prvku, který lze použít k řízení v rejstříku ControlCollection instance.

Vrácená hodnota

Typ: Microsoft.Office.Tools.Excel.ListObject
ListObject Ovládací prvek, který byl přidán ControlCollection instance.

Výjimky

Výjimka	Podmínka
ArgumentNullException	Oblast nebo název argument je nullodkaz Null (Nothing v jazyce Visual Basic), nebo argument název má nulovou délku.
ControlNameAlreadyExistsException	Ovládací prvek se stejným názvem je již v ControlCollection instance.
InvalidRangeException	Určený rozsah je platný. Multi -oblast rozsahy nelze použít. Rozsah by měl být na stejném list jako ControlCollection instance.

Poznámky

AddListObject Metoda umožňuje přidat ListObject ovládací prvky na konci ControlCollection. Odebrání ListObject , které dříve přidali programově, použijte Remove metody.

Příklady

Následující příklad kódu přidá ListObject řízení na začátek lista potom zobrazí okno zobrazující počet řádků v 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.");
}

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.