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
- 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.