Método Bookmark.InsertDatabase

Artigo
05/21/2013

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

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 listados na caixa de Formatos na caixa de diálogo de AutoFormatação da tabela .Podem ser algumas das constantes de WdTableFormat .Uma borda é aplicada às células na tabela por padrão.

Style
Tipo: System.Object%
Atributos de autoformatação especificado por Format que são aplicados à tabela.Use a soma de qualquer combinação dos seguintes valores:
[1|Valor 1]
[1|2 Significar]
[2|1 0 (zero)]
[2|Nenhum 2]
[3|1] 1
[3|2 Bordas]
[4|1] 2
[4|Protegendo 2]
[5|1] 4
[5|2 Fonte]
[6|1] 8
[6|2 Cor]
[7|1] 16
[7|Ajuste de carro 2]
[8|1] 32
[8|Linhas de título 2]
[9|1] 64
[9|2] A última linha
[10|1] 128
[10|Primeira coluna 2]
[11|1] 256
[11|2] A última coluna

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

Connection
Tipo: System.Object%
Um intervalo dentro do qual deseja executar a consulta especificado por SQLStatement.Como você especificar o intervalo depende de como os dados são recuperados.Por exemplo:
Para recuperar dados com o ODBC ODBC (), você especifica uma cadeia de conexão.
Para recuperar dados do Microsoft Office Excel usando dinâmicas troca de dados (DDE), você especifica um intervalo nomeado “ou uma planilha inteira.”
ObservaçãoAs dinâmicas troca de dados (DDE) é uma tecnologia mais antigo que não está seguro.Se possível, use uma alternativa mais segura a DDE, como o objeto que vinculam e incorpora (OLE.)
Para recuperar dados do Microsoft Access, você especifica a palavra “tabela” ou “consulte” seguida do nome de uma tabela ou de uma consulta.

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

SQLStatement1
Tipo: System.Object%
Se a cadeia de caracteres de consulta é maior de 255 caracteres, SQLStatement indica a primeira parte da cadeia de caracteres e SQLStatement1 indica a segunda parte.

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

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

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

WritePasswordTemplate
Tipo: System.Object%
A senha necessária para salvar as alterações para o modelo.Comentários (consulte 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 serem inseridos.

To
Tipo: System.Object%
O número de registro de dados mais recente no intervalo de registros a serem inseridos.

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

Comentários

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

Evite usar a conta de logon interno de (sa) de administrador do sistema.Em vez disso, faça aos administradores de sistema membros da função de servidor de sysadmin fixa, e mande-os usar suas próprias contas para fazer logon.Use o sa somente quando não há nenhuma outra maneira de fazer logon.Para impedir o acesso não autorizado com a conta de logon de sa, você deve atribuir que explica uma senha forte, exclusivo.

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 conectar com uma conta de usuário do Windows, o SQL Server usa as informações no sistema operacional Windows para validar o nome e a senha da conta.Antes que você possa usar a Autenticação do Windows, um administrador do servidor deve configurar o SQL Server para usar este modo de autenticação.Se a Autenticação do Windows não estiver disponível, evite salvar informações de logon de usuário.É mais seguro para que os usuários digitem suas informações de logon cada vez que fazem logon.

Parâmetros Opcionais

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

Exemplos

Este exemplo insere uma planilha do Excel no controle de Bookmark .O valor de estilo (191) é uma combinação de números 1, 2, 4, 8, 16, 32, e 128.Este exemplo assume que possui uma pasta de trabalho chamada Data.xlsx salvo para a raiz do diretório de C com pelo menos duas linhas de dados na planilha.

Este exemplo é para uma personalização da nível.

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

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