Compartir a través de


ControlCollection.AddListObject (Método) (Range, String)

Agrega a la hoja de cálculo un nuevo control ListObject en el rango especificado.

Espacio de nombres:  Microsoft.Office.Tools.Excel
Ensamblado:  Microsoft.Office.Tools.Excel (en Microsoft.Office.Tools.Excel.dll)

Sintaxis

'Declaración
Function AddListObject ( _
    range As Range, _
    name As String _
) As ListObject
ListObject AddListObject(
    Range range,
    string name
)

Parámetros

Valor devuelto

Tipo: Microsoft.Office.Tools.Excel.ListObject
Control ListObject agregado a la instancia del objeto ControlCollection.

Excepciones

Excepción Condición
ArgumentNullException

El argumento de nombre o rango es nullreferencia null (Nothing en Visual Basic), o el argumento de nombre tiene longitud cero.

ControlNameAlreadyExistsException

Ya existe un control con el mismo nombre en la instancia de ControlCollection.

InvalidRangeException

El intervalo especificado no es válido. No pueden utilizarse rangos multiárea. El rango debe estar en la misma hoja de cálculo que la instancia de ControlCollection.

Comentarios

El método AddListObject permite agregar controles ListObject al final de ControlCollection. Para quitar un control ListObject agregado previamente mediante programación, utilice el método Remove.

Ejemplos

En el siguiente ejemplo de código se agrega un control ListObject a la parte superior de la hoja de cálculo y, a continuación, se muestra un cuadro de mensaje en el que aparece el número de filas del control 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.");
}

Seguridad de .NET Framework

Vea también

Referencia

ControlCollection Interfaz

AddListObject (Sobrecarga)

Microsoft.Office.Tools.Excel (Espacio de nombres)