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.