ControlCollection.AddListObject – metoda (Range, String)

Článek
01/03/2014

Přidá nový ListObject ovládací prvek na list na zadaný rozsah.

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	Argument název nebo rozsah 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ž ControlCollection instance.
InvalidRangeException	Zadaný rozsah je neplatný.Nelze použít s rozsahy.Rozsah by měl být na stejném listu jako ControlCollection instance.

Poznámky

AddListObject Metoda umožňuje přidat ListObject ovládacích prvků na konec ControlCollection.Chcete-li odebrat ListObject ovládací prvek, který byl dříve přidán programově, použijte Remove metody.

Příklady

Následující příklad kódu přidá ListObject na začátek listu a potom zobrazí ovládací prvek zobrazující počet řádků v okně se zprávou 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.