ControlCollection.AddListObject-Methode (Range, String)

Artikel
08/10/2011

Fügt dem Arbeitsblatt im angegebenen Bereich ein neues ListObject-Steuerelement hinzu.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Syntax

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

ListObject AddListObject(
    Range range,
    string name
)

Parameter

range
Typ: Microsoft.Office.Interop.Excel.Range
Ein Range, der die Begrenzungen des Steuerelements angibt.

name
Typ: System.String
Der Name des Steuerelements, der zum Indizieren des Steuerelements in der ControlCollection-Instanz verwendet werden kann.

Rückgabewert

Typ: Microsoft.Office.Tools.Excel.ListObject
Das ListObject-Steuerelement, das der ControlCollection-Instanz hinzugefügt wurde.

Ausnahmen

Ausnahme	Bedingung
ArgumentNullException	Das Argument für den Namen oder den Bereich ist nullNULL-Verweis (Nothing in Visual Basic), oder das Argument für den Namen hat die Länge 0 (null).
ControlNameAlreadyExistsException	Ein Steuerelement mit dem gleichen Namen ist bereits in der ControlCollection-Instanz vorhanden.
InvalidRangeException	Der angegebene Bereich ist nicht gültig. Bereiche, die mehrere Bereiche enthalten, können nicht verwendet werden. Der Bereich muss sich auf dem gleichen Arbeitsblatt wie die ControlCollection-Instanz befinden.

Hinweise

Mithilfe der AddListObject-Methode können Sie ListObject-Steuerelemente am Ende der ControlCollection hinzufügen. Um ein ListObject-Steuerelement zu entfernen, das zuvor programmgesteuert hinzugefügt wurde, verwenden Sie die Remove-Methode.

Beispiele

Im folgenden Codebeispiel wird oben im Arbeitsblatt ein ListObject-Steuerelement hinzugefügt, und dann wird ein Meldungsfeld mit der Anzahl der Zeilen im ListObject angezeigt.

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-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.