ListObject.Name-Eigenschaft

Artikel
05/07/2013

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

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.

Siehe auch

Referenz

ListObject Schnittstelle

Microsoft.Office.Tools.Excel-Namespace

Freigeben über