Bookmark.InsertDatabase (Método)
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.
Espacio de nombres: Microsoft.Office.Tools.Word
Ensamblado: Microsoft.Office.Tools.Word (en Microsoft.Office.Tools.Word.dll)
Sintaxis
'Declaración
Sub InsertDatabase ( _
ByRef Format As Object, _
ByRef Style As Object, _
ByRef LinkToSource As Object, _
ByRef Connection As Object, _
ByRef SQLStatement As Object, _
ByRef SQLStatement1 As Object, _
ByRef PasswordDocument As Object, _
ByRef PasswordTemplate As Object, _
ByRef WritePasswordDocument As Object, _
ByRef WritePasswordTemplate As Object, _
ByRef DataSource As Object, _
ByRef From As Object, _
ByRef To As Object, _
ByRef IncludeFields As Object _
)
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
)
Parámetros
- Format
Tipo: System.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
Tipo: System.Object%
Atributos del Autoformato especificados por Format que se aplican a la tabla.Utilice la suma de cualquier combinación de los valores siguientes:
[1|1] Valor
[1|2] Significado
[2|1] 0 (cero)
[2|2] Ninguna
[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ítulos
[9|1] 64
[9|2] Última fila
[10|1] 128
[10|2] Primera columna
[11|1] 256
[11|2] Última columna
- LinkToSource
Tipo: System.Object%
Es true para establecer un vínculo entre la nueva tabla y el origen de datos.
- Connection
Tipo: System.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 los datos a través del protocolo de conectividad abierta de bases de datos (ODBC), se especifica una cadena de conexión.
Al recuperar los datos de Microsoft Office Excel mediante el intercambio dinámico de datos (DDE), especifique un rango con nombre o "Entire Spreadsheet" (toda la hoja de cálculo).
NotaIntercambio dinámico de datos (DDE) es una tecnología antigua que no es segura.Si es posible, utilice una alternativa a DDE más segura, como la vinculación e incrustación de objetos (OLE).
Al recuperar los datos de Microsoft Access, especifique la palabra "Table" (tabla) o "Query" (consulta) seguida del nombre de una tabla o consulta.
- SQLStatement
Tipo: System.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
Tipo: System.Object%
Si la cadena de consulta supera los 255 caracteres, SQLStatement denota la primera parte de la cadena y SQLStatement1 denota la segunda parte.
- PasswordDocument
Tipo: System.Object%
Contraseña (si la hubiera) necesaria para abrir el origen de datos.Vea la sección Comentarios más adelante.
- PasswordTemplate
Tipo: System.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
Tipo: System.Object%
Contraseña necesaria para guardar los cambios del documento.Vea la sección Comentarios más adelante.
- WritePasswordTemplate
Tipo: System.Object%
Contraseña necesaria para guardar los cambios de la plantilla.Vea la sección Comentarios más adelante.
- DataSource
Tipo: System.Object%
Ruta de acceso y nombre de archivo del origen de datos.
- From
Tipo: System.Object%
Número del primer registro de datos del intervalo de registros que se va a insertar.
- To
Tipo: System.Object%
Número del último registro de datos del intervalo de registros que se va a insertar.
- IncludeFields
Tipo: System.Object%
true , para incluir los nombres de campo del origen de datos en la primera fila de la nueva tabla.
Comentarios
Evite el uso de contraseñas incluidas en el código de las aplicaciones.Si se requiere una contraseña en un procedimiento, solicite al usuario la contraseña, almacénela en una variable y, a continuación, utilice la variable en el código.
Evite el uso de la cuenta de inicio de sesión del administrador del sistema integrada.En su lugar, haga que los administradores del sistema sean miembros de la función fija del servidor sysadmin y que utilicen sus propias cuentas para iniciar sesión.Sólo utilice la cuenta del administrador del sistema 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 del administrador del sistema, debe asignar a dicha cuenta una contraseña única y segura.
Cuando sea posible, utilice Autenticación de Windows (a la que también se hace referencia como conexión de confianza), que utiliza una cuenta de usuario de Windows para conectarse a SQL Server.Cuando un usuario se conecte a través de una cuenta de usuario de Windows, SQL Server utiliza la información del sistema operativo Windows para validar la contraseña y el nombre de cuenta.Antes de poder utilizar Autenticación de Windows, un administrador del servidor debe configurar SQL Server para que utilice este modo de autenticación.Si 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 especifiquen la información de inicio de sesión cada vez que la inician.
Parámetros opcionales
Para obtener información sobre parámetros opcionales, vea Parámetros opcionales en las soluciones de Office.
Ejemplos
Este ejemplo inserta una hoja de cálculo de Microsoft Excel en el control Bookmark.El valor de 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 por lo menos dos filas de datos en la hoja de cálculo.
Se trata de un ejemplo para una personalización en el nivel del documento.
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
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);
}
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.