Método Bookmark.InsertDatabase

Artigo
08/01/2011

Recupera dados de uma fonte de dados (por exemplo, um documento do Word de Microsoft Office separado, uma planilha do Excel de Microsoft Office ou um banco de dados do Microsoft Access) e insere os dados como uma tabela em vez do Bookmark de controle.

Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (em Microsoft.Office.Tools.Word.dll)

Sintaxe

'Declaração
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%
Um formato listado na formatos caixa a AutoFormatação da tabela caixa de diálogo.Pode ser qualquer um de WdTableFormat constantes.Uma borda é aplicada às células da tabela, por padrão.

Style
Tipo: System.Object%
Os atributos da AutoFormatação especificada por Format que são aplicadas à tabela.Use a soma de qualquer combinação dos seguintes valores:
[1|1] Valor
[1|2] Significado
[2], 0 (zero)
[2|2] Nenhum
[3|1] 1
[3|2] Bordas
[4|1] 2
[4|2] Sombreamento
[5|1] 4
[5|2] Fonte
[6|1] 8
[6|2] Cor
[7|1] 16
[7|2] Ajuste automático
[8|1] 32
[8|2] Linhas de título
[9|1] 64
[9|2] Última linha
[10|1] 128
[10|2] Primeira coluna
[11|1] 256
[11|2] Última coluna

LinkToSource
Tipo: System.Object%
true para estabelecer um vínculo entre a nova tabela e a fonte de dados.

Connection
Tipo: System.Object%
Um intervalo no qual executar a consulta especificada por SQLStatement.Como você pode especificar o intervalo depende de como os dados são recuperados.For example:
Ao recuperar dados através de Open Database Connectivity (ODBC), você pode especificar uma seqüência de conexão.
Ao recuperar dados do Excel de Microsoft Office usando intercâmbio dinâmico de dados (DDE), você especificar um intervalo nomeado ou "Entire Spreadsheet".
Note Intercâmbio dinâmico de dados (DDE) é uma tecnologia mais antiga que não é segura.Se possível, use uma alternativa mais segura para DDE, como, por exemplo, object linking and embedding (OLE).
Ao recuperar dados do Microsoft Access, você especificar a palavra "Table" ou "Query" seguido pelo nome de uma tabela ou consulta.

SQLStatement
Tipo: System.Object%
Uma seqüência de caracteres de consulta opcional que recupera um subconjunto dos dados de uma fonte de dados primária a ser inserido no documento.

SQLStatement1
Tipo: System.Object%
Se a seqüência de caracteres de consulta for maior que 255 caracteres, SQLStatement indica a primeira parte da seqüência de caracteres e SQLStatement1 indica a segunda parte.

PasswordDocument
Tipo: System.Object%
A senha (se houver) necessária para abrir a fonte de dados.(Consulte comentários abaixo).

PasswordTemplate
Tipo: System.Object%
Se a fonte de dados for um documento do Word de Microsoft Office, este argumento é a senha (se houver) necessária para abrir o modelo anexado.(Consulte comentários abaixo).

WritePasswordDocument
Tipo: System.Object%
A senha necessária para salvar as alterações no documento.(Consulte comentários abaixo).

WritePasswordTemplate
Tipo: System.Object%
A senha necessária para salvar as alterações no modelo.(Consulte comentários abaixo).

DataSource
Tipo: System.Object%
O caminho e o nome da fonte de dados.

From
Tipo: System.Object%
O número do primeiro registro de dados no intervalo de registros a ser inserido.

To
Tipo: System.Object%
O número do último registro de dados no intervalo de registros a ser inserido.

IncludeFields
Tipo: System.Object%
true para incluir os nomes de campo da fonte de dados na primeira linha da nova tabela.

Comentários

Evite usar senhas embutidas em seus aplicativos. Se for necessária uma senha em um procedimento, solicite a senha do usuário, armazená-lo em uma variável e, em seguida, use a variável no seu código.

Evite usar a conta de logon de administrador (sa) do sistema interno. Em vez disso, verifique o sistema membros de administradores de servidor fixa sysadmin e tê-los a usar suas próprias contas para fazer logon. Use sa somente quando não há outra maneira de fazer logon. Para evitar acesso não autorizado através da conta de logon do sa, atribua a essa conta uma senha forte exclusiva.

Quando possível, use a autenticação do Windows (também conhecida como uma conexão confiável), que usa uma conta de usuário do Windows para se conectar ao SQL Server. Quando um usuário se conecta por meio de uma conta de usuário do Windows, o SQL Server usa informações no sistema operacional Windows para validar o nome de conta e senha. Antes de usar autenticação do Windows, o administrador do servidor deve configurar SQL Server para usar esse modo de autenticação. Se a autenticação do Windows não estiver disponível, evite salvar o dos usuários. informações de logon. É mais seguro para os usuários insiram suas informações de logon de cada vez que fizerem logon.

Optional Parameters

Para obter informações sobre os parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

Exemplos

Este exemplo insere uma planilha do Microsoft Excel para o Bookmark de controle. O valor do estilo (191) é uma combinação dos números 1, 2, 4, 8, 16, 32 e 128. Este exemplo assume que você tem uma pasta de trabalho denominada Data.xls salvos para a raiz do diretório c com pelo menos duas linhas de dados na planilha.

Este exemplo é para uma personalização em nível de 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.xls")

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.xls";

    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);
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

Bookmark Interface

Namespace Microsoft.Office.Tools.Word

Compartilhar via