Freigeben über


ListObject.Name-Eigenschaft

Ruft den Namen des ListObject-Steuerelements ab oder legt ihn fest.

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

Syntax

'Declaration
Property Name As String
string Name { get; set; }

Eigenschaftswert

Typ: System.String
Der Name des ListObject-Steuerelements.

Hinweise

Dieser Name wird ausschließlich als eindeutiger Bezeichner für die ListObjects.Item-Eigenschaft der Microsoft.Office.Interop.Excel.ListObjects-Auflistung verwendet.Diese Eigenschaft kann nur durch das Objektmodell festgelegt werden.

Standardmäßig beginnt der Name jedes ListObject-Steuerelements mit dem Wort "List", gefolgt von einer Zahl (ohne Leerzeichen).Wenn die Name-Eigenschaft auf einen Namen festgelegt werden soll, der bereits von einem anderen ListObject-Steuerelement verwendet wird, wird eine Ausnahme ausgelöst.

Beispiele

Im folgenden Codebeispiel wird ein ListObject im aktuellen Arbeitsblatt erstellt. Anschließend wird mithilfe der Name-Eigenschaft der Name des ListObject auf "Employees" festgelegt.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

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

        List1.Name = "Employees"
        List1.Tag = "Employee data"

        MessageBox.Show("The list name is " + List1.Name.ToString() & _
            " and the tag is " & List1.Tag.ToString() + ".")

    End Sub

private void ListObject_Metadata()
{
    Microsoft.Office.Tools.Excel.ListObject list1 =
        this.Controls.AddListObject(this.Range["A1", "D4"], "Employees");

    list1.Name = "Employees";
    list1.Tag = "Employee data";

    MessageBox.Show("The list name is " + list1.Name.ToString() +
        " and the tag is " + list1.Tag.ToString() + ".");
}

.NET Framework-Sicherheit

Siehe auch

Referenz

ListObject Schnittstelle

Microsoft.Office.Tools.Excel-Namespace