Bookmark.InsertDatabase Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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.