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

Artículo
08/10/2011

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

range
Tipo: Microsoft.Office.Interop.Excel.Range
Objeto Range que proporciona los límites del control.

name
Tipo: System.String
Nombre del control que puede utilizarse para indizar el control en la instancia de ControlCollection.

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

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.