Método ControlCollection.AddListObject (Range, String)

Adiciona um novo controle de ListObject a planilha no intervalo especificado.

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

Sintaxe

'Declaração
Function AddListObject ( _
    range As Range, _
    name As String _
) As ListObject
ListObject AddListObject(
    Range range,
    string name
)

Parâmetros

Valor de retorno

Tipo: Microsoft.Office.Tools.Excel.ListObject
O controle de ListObject que foi adicionado à instância de ControlCollection .

Exceções

Exceção Condição
ArgumentNullException

O argumento de nome ou do intervalo é nulluma referência nula (Nothing no Visual Basic), ou o nome do argumento tem comprimento zero.

ControlNameAlreadyExistsException

Um controle com o mesmo nome já está na instância de ControlCollection .

InvalidRangeException

O intervalo que foi especificado não é válido.Os intervalos de várias área não podem ser usados.O intervalo deve estar na mesma planilha que a instância de ControlCollection .

Comentários

O método de AddListObject permite que você adicione controles de ListObject ao final de ControlCollection.Para remover ListObject controle que foi adicionado anteriormente por meio de programação, usando o método de Remove .

Exemplos

O exemplo de código a seguir adiciona um controle de ListObject à parte superior da planilha, e exibe em uma caixa de mensagem exibindo o número de linhas em 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.");
}

Segurança do .NET Framework

Consulte também

Referência

ControlCollection Interface

Sobrecargas AddListObject

Namespace Microsoft.Office.Tools.Excel