Compartir a través de


Método Range.InsertDatabase (Word)

Recupera los datos de un origen de datos (por ejemplo, un documento de Microsoft Word diferente, una hoja de cálculo de Microsoft Excel o una base de datos de Microsoft Access) e inserta los datos como una tabla en lugar del intervalo especificado.

Sintaxis

expresión. InsertDatabase (Format, Style, LinkToSource, Connection, SQLStatement, SQLStatement1, PasswordDocument, PasswordTemplate, WritePasswordDocument, WritePasswordTemplate, DataSource, From, To, IncludeFields)

expresión requerida. Variable que representa un objeto Range.

Parameters

Nombre Obligatorio/opcional Tipo de datos Descripción
Format Opcional Variant Un formato de la lista en el cuadro Formatos del cuadro de diálogo Autoformato de tablas (menú Tabla). Puede ser cualquiera de las constantes WdTableFormat. Se aplica un borde a las celdas de la tabla de forma predeterminada.
Style Opcional Variant Los atributos de Autoformato especificados en Formato que se aplican a la tabla.
LinkToSource Opcional Variant True para establecer un vínculo entre la nueva tabla y el origen de datos.
Connection Opcional Variant Intervalo dentro del cual se va a realizar la consulta especificada por SQLStatement.
SQLStatement Opcional String Una cadena de consulta opcional que recupera un subconjunto de los datos en el origen de datos primario que se insertará en el documento.
SQLStatement1 Opcional Cadena Si la cadena de consulta tiene más de 255 caracteres, SQLStatement denota la primera parte de la cadena y SQLStatement1 denota la segunda parte.
PasswordDocument Opcional Variant La contraseña, si se requiere una, que se usa para abrir el origen de datos. (Ver los comentarios abajo).
PasswordTemplate Opcional Variant Si el origen de datos es un documento de Word, este argumento es la contraseña (si hay una) requerida para abrir la plantilla adjunta. (Ver los comentarios abajo).
WritePasswordDocument Opcional Variant La contraseña que se usa para guardar cambios realizados en el documento. (Ver los comentarios abajo).
WritePasswordTemplate Opcional Variant La contraseña requerida para guardar cambios realizados en la plantilla. (Ver los comentarios abajo).
DataSource Opcional Variant Ruta de acceso y nombre de archivo del origen de datos.
From Opcional Variant El número del primer registro en el intervalo de registros que se va a insertar.
To Opcional Variant El número del último registro en el intervalo de registros que se va a insertar.
IncludeFields Opcional Variant True para incluir nombres de campo del origen de datos en la primera fila de la nueva tabla.

Seguridad

Importante

No use contraseñas codificadas de forma rígida en las aplicaciones. Si se requiere la contraseña en un procedimiento, pídale la contraseña al usuario, almacénela en una variable y luego use la variable en el código. Para conocer los procedimientos recomendados sobre cómo hacerlo, consulte Notas de seguridad para desarrolladores de soluciones de Office.

Comentarios

El valor del argumento Style puede ser la suma de cualquier combinación de los siguientes valores:

Valor Descripción
0 (cero) Ninguno
1 Bordes
2 Sombreado.
4 Fuente
8 Color
16 Autoajuste
32 Filas de título
64 Última fila.
128 Primera columna
256 Última columna

El modo en que se especifica el argumento Connection depende del modo en que se recuperan los datos. Por ejemplo:

  • Cuando se recuperan datos mediante la conectividad abierta de bases de datos (ODBC), se especifica una cadena de conexión.

  • Cuando se recuperan datos desde Excel mediante el intercambio dinámico de datos (DDE), se especifica un rango con nombre o "Toda la hoja de cálculo".

  • Cuando se recuperan datos desde Access, se especifica la palabra "Tabla" o "Consulta" seguida del nombre de una tabla o consulta.

Ejemplo:

En este ejemplo se inserta una hoja de cálculo de Excel denominada "Data.xls" después de la selección. El valor Style (191) es una combinación de los números 1, 2, 4, 8, 16, 32 y 128.

With Selection 
    .Collapse Direction:=wdCollapseEnd 
    .Range.InsertDatabase _ 
        Format:=wdTableFormatSimple2, Style:=191, _ 
        LinkToSource:=False, Connection:="Entire Spreadsheet", _ 
        DataSource:="C:\MSOffice\Excel\Data.xls" 
End With

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.