Método ListObjects.Add (Excel)
Crea un nuevo objeto de lista.
Sintaxis
expresión. Add (SourceType, Source, LinkSource, XlListObjectHasHeaders, Destination, TableStyleName)
Expresión Variable que representa un objeto ListObjects .
Parameters
| Nombre | Obligatorio/opcional | Tipo de datos | Descripción |
|---|---|---|---|
| SourceType | Opcional | XlListObjectSourceType | Indica el tipo de origen de la consulta. |
| Source | Optional | Variant | When SourceType = xlSrcRange: objeto Range que representa el origen de datos. Si se omite, el valor predeterminado de Source será el intervalo devuelto por el código de detección de intervalos de lista. When SourceType = xlSrcExternal: matriz de valores String que especifica una conexión al origen, que contiene los siguientes elementos:
When SourceType = xlSrcModel: acepta un objeto WorkbookConnection (vea TableObject por ejemplo). |
| LinkSource | Opcional | Boolean | Indica si un origen de datos externo debe vincularse al objeto ListObject. Si SourceType es xlSrcExternal, el valor predeterminado es True. No es válido si SourceType es xlSrcRange y devolverá un error si no se omite. |
| XlListObjectHasHeaders | Opcional | Variant | Constante XlYesNoGuess que indica si los datos importados tienen etiquetas de columna. Si el origen no contiene encabezados, Excel generará automáticamente encabezados. Valor predeterminado: xlGuess. |
| Destino | Opcional | Variant | Objeto Range que especifica una referencia de celda única como destino de la esquina superior izquierda del nuevo objeto de lista. Si el objeto Range hace referencia a más de una celda, se genera un error. El argumento Destination debe especificarse cuando SourceType se establece en xlSrcExternal. El argumento Destination se omite si SourceType está establecido en xlSrcRange. El intervalo de destino debe estar en la hoja de cálculo que contiene la colección ListObjects especificada por expression. Las nuevas columnas se insertarán en el destino para ajustarse a la nueva lista. Por lo tanto, no se sobrescribirán los datos existentes. |
| TableStyleName | Opcional | Cadena | Nombre de un objeto TableStyle; por ejemplo, "TableStyleLight1". |
Valor devuelto
Objeto ListObject que representa el nuevo objeto list.
Comentarios
Cuando la lista contiene encabezados, la primera fila de celdas se convertirá en Texto, si todavía no está establecida en texto. La conversión se basará en el texto visible de la celda. Esto significa que si hay un valor de fecha con el formato Fecha que cambia con la configuración regional, la conversión a una lista podría producir resultados diferentes en función de la configuración regional del sistema actual. Además, si hay dos celdas en la fila de encabezado con el mismo texto visible, se anexará un Entero incremental para que cada encabezado de columna sea único.
Ejemplo:
En el ejemplo siguiente se agrega un nuevo objeto ListObject basado en datos de un sitio de Microsoft SharePoint Foundation a la colección ListObjects predeterminada y se coloca la lista en la celda A1 de la primera hoja de cálculo del libro.
Nota:
En el ejemplo de código siguiente se supone que sustituirá un nombre de servidor válido y el guid de lista en las variables strServerName y strListGUID. Además, el nombre del servidor debe ir seguido "/_vti_bin" (strListName) de o el ejemplo no funcionará.
Set objListObject = ActiveWorkbook.Worksheets(1).ListObjects.Add(SourceType:= xlSrcExternal, _
Source:= Array(strServerName, strListName, strListGUID), LinkSource:=True, _
XlListObjectHasHeaders:=xlGuess, Destination:=Range("A1")),
TableStyleName:=xlGuess, Destination:=Range("A10"))
Soporte técnico y comentarios
¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.