Compartir a través de


Bookmark.InsertDatabase Método

Definición

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

public void InsertDatabase (ref object Format, ref object Style, ref object LinkToSource, ref object Connection, ref object SQLStatement, ref object SQLStatement1, ref object PasswordDocument, ref object PasswordTemplate, ref object WritePasswordDocument, ref object WritePasswordTemplate, ref object DataSource, ref object From, ref object To, ref object IncludeFields);
abstract member InsertDatabase : obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj -> unit
Public Sub InsertDatabase (Optional ByRef Format As Object, Optional ByRef Style As Object, Optional ByRef LinkToSource As Object, Optional ByRef Connection As Object, Optional ByRef SQLStatement As Object, Optional ByRef SQLStatement1 As Object, Optional ByRef PasswordDocument As Object, Optional ByRef PasswordTemplate As Object, Optional ByRef WritePasswordDocument As Object, Optional ByRef WritePasswordTemplate As Object, Optional ByRef DataSource As Object, Optional ByRef From As Object, Optional ByRef To As Object, Optional ByRef IncludeFields As Object)

Parámetros

Format
Object

Formato enumerado en el cuadro Formatos del cuadro de diálogo Autoformato de tablas. Puede ser una de las constantes WdTableFormat. Los bordes se aplican a las celdas de la tabla de forma predeterminada.

Style
Object

Atributos del autoformato especificado por Format que se aplican a la tabla. Utilice la suma de cualquier combinación de los siguientes valores:[1|1] Valor[1|2] Significado[2|1] 0 (cero)[2|2] None[3|1] 1[3|2] Bordes[4|1] 2[4|2] Sombreado[5|1] 4[5|2] Fuente[6|1] 8[6|2] Color[7|1] 16[7|2] Ajuste automático[8|1] 32[8|2] Filas de título[9|1] 64[9|2] Última fila[10|1] 128[10|2] Primera columna[ 11|1] 256[11|2] Última columna

LinkToSource
Object

Es true para establecer un vínculo entre la nueva tabla y el origen de datos.

Connection
Object

Intervalo en el que se va a realizar la consulta especificada por SQLStatement. Cómo especifica que el intervalo depende de la forma en que se recuperan los datos. Por ejemplo: al recuperar datos a través de conectividad abierta de base de datos (ODBC), especifique un cadena de conexión. Al recuperar datos de Microsoft Office Excel mediante el intercambio dinámico de datos (DDE), se especifica un rango con nombre o "Hoja de cálculo completa". Nota    El intercambio dinámico de datos (DDE) es una tecnología anterior que no es segura. Si es posible, use una alternativa más segura a DDE, como la vinculación de objetos y la inserción (OLE). Al recuperar datos de Microsoft Access, especifique la palabra "Table" o "Query" seguida del nombre de una tabla o consulta.

SQLStatement
Object

Cadena de consulta opcional que recupera un subconjunto de los datos de un origen de datos primario que se va a insertar en el documento.

SQLStatement1
Object

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
Object

Contraseña (si la hubiera) necesaria para abrir el origen de datos. Vea la sección Comentarios más adelante.

PasswordTemplate
Object

Si el origen de datos es un documento de Microsoft Office Word, este argumento es la contraseña (si la hubiera) necesaria para abrir la plantilla adjunta. Vea la sección Comentarios más adelante.

WritePasswordDocument
Object

Contraseña necesaria para guardar los cambios del documento. Vea la sección Comentarios más adelante.

WritePasswordTemplate
Object

Contraseña necesaria para guardar los cambios de la plantilla. Vea la sección Comentarios más adelante.

DataSource
Object

Ruta de acceso y nombre de archivo del origen de datos.

From
Object

Número del primer registro de datos del intervalo de registros que se va a insertar.

To
Object

Número del último registro de datos del intervalo de registros que se va a insertar.

IncludeFields
Object

true, para incluir los nombres de campo del origen de datos en la primera fila de la nueva tabla.

Ejemplos

En este ejemplo se inserta una hoja de cálculo de Microsoft Excel en el Bookmark control . El valor Style (191) es una combinación de los números 1, 2, 4, 8, 16, 32 y 128. En este ejemplo se supone que tiene un libro denominado Data.xlsx guardado en la raíz del directorio C con al menos dos filas de datos en la hoja de cálculo.

Este ejemplo es para una personalización de nivel de documento.

private void BookmarkInsertDatabase()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Bookmark bookmark1 =
        this.Controls.AddBookmark(this.Paragraphs[1].Range,
        "bookmark1");
    bookmark1.Text = "This is sample bookmark text";

    object Format = Word.WdTableFormat.wdTableFormatClassic1;
    object Style = 191;
    object LinkToSource = false;
    object Connection = "Entire Spreadsheet";
    object DataSource = "C:\\Data.xlsx";

    bookmark1.InsertDatabase(ref Format, ref Style, ref LinkToSource,
        ref Connection, ref missing, ref missing, ref missing,
        ref missing, ref missing, ref missing, ref DataSource,
        ref missing, ref missing, ref missing);
}
Private Sub BookmarkInsertDatabase()

    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim Bookmark1 As Microsoft.Office.Tools.Word.Bookmark = _
        Me.Controls.AddBookmark(Me.Paragraphs(1).Range, "Bookmark1")

    Bookmark1.Text = "This is sample bookmark text"
    Bookmark1.InsertDatabase(Format:=Word.WdTableFormat _
        .wdTableFormatClassic1, Style:=191, LinkToSource:=False, _
        Connection:="Entire Spreadsheet", DataSource:="C:\Data.xlsx")

End Sub

Comentarios

Evite usar contraseñas codificadas de forma rígida en las aplicaciones. Si se requiere una contraseña en un procedimiento, solicite la contraseña del usuario, almacénela en una variable y, a continuación, use la variable en el código.

Evite usar la cuenta de inicio de sesión del administrador del sistema (sa) integrada. En su lugar, haga que los administradores del sistema sean miembros del rol fijo de servidor sysadmin y haga que usen sus propias cuentas para iniciar sesión. Use sa solo cuando no haya ninguna otra manera de iniciar sesión. Para evitar el acceso no autorizado a través de la cuenta de inicio de sesión sa, debe asignar a esa cuenta una contraseña segura y única.

Cuando sea posible, use la autenticación de Windows (también denominada conexión de confianza), que usa una cuenta de usuario de Windows para conectarse a SQL Server. Cuando un usuario se conecta a través de una cuenta de usuario de Windows, SQL Server usa información en el sistema operativo Windows para validar el nombre y la contraseña de la cuenta. Para poder usar la autenticación de Windows, un administrador del servidor debe configurar SQL Server para usar este modo de autenticación. Si la autenticación de Windows no está disponible, evite guardar la información de inicio de sesión de los usuarios. Es más seguro que los usuarios escriban su información de inicio de sesión cada vez que inicien sesión.

Parámetros opcionales

Para obtener información sobre los parámetros opcionales, vea Parámetros opcionales en soluciones de Office.

Se aplica a