Propriedade ListObject.Name

Obtém ou define o nome da ListObject de controle.

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

Sintaxe

'Declaração
Property Name As String
    Get
    Set
string Name { get; set; }

Valor de propriedade

Tipo: System.String
O nome da ListObject de controle.

Comentários

Esse nome é usado unicamente como um identificador exclusivo para o ListObjects.Item propriedade da Microsoft.Office.Interop.Excel.ListObjects coleção. Essa propriedade só pode ser definida por meio do modelo de objeto.

Por padrão, cada ListObject nome do controle começa com a palavra "List", seguida por um número (sem espaços). Se for feita uma tentativa de definir o Name propriedade para um nome já usado por outro ListObject o controle, uma exceção é lançada.

Exemplos

O exemplo de código a seguir cria um ListObject a planilha atual e usa o Name propriedade para definir o nome da ListObject como "Funcionários".

Este exemplo é para uma personalização em nível de documento.

    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() + ".");
}

Segurança do .NET Framework

Consulte também

Referência

ListObject Interface

Namespace Microsoft.Office.Tools.Excel