Bookmark.InsertDatabase Método

Referência

Definição

Namespace:: Microsoft.Office.Tools.Word

Assembly:: Microsoft.Office.Tools.Word.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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 insere os dados como uma tabela em vez do controle 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

Um formato listado na caixa Formatos na caixa de diálogo Formatação Automática da Tabela. Pode ser qualquer uma das constantes WdTableFormat. Uma borda é aplicada às células na tabela por padrão.

Style: Object

Os atributos da AutoFormatação especificada por Format que são aplicados à tabela. Use a soma de qualquer combinação dos seguintes valores:[1|1] Value[1|2] Meaning[2|1] 0 (zero)[2|2] None[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: Object

true para estabelecer um vínculo entre a nova tabela e a fonte de dados.

Connection: Object

Um intervalo dentro do qual executar a consulta especificada por SQLStatement. A maneira de especificar o intervalo depende de como os dados são recuperados. Por exemplo: ao recuperar dados por meio do ODBC (Open Database Connectivity), especifique um cadeia de conexão. Ao recuperar dados do Microsoft Office Excel usando a DDE (troca dinâmica de dados), você especifica um intervalo nomeado ou "Planilha Inteira". Observação A DDE (troca dinâmica de dados) é uma tecnologia mais antiga que não é segura. Se possível, use uma alternativa mais segura ao DDE, como vinculação de objeto e inserção (OLE). Ao recuperar dados do Microsoft Access, especifique a palavra "Tabela" ou "Consulta" seguida pelo nome de uma tabela ou consulta.

SQLStatement: Object

Uma cadeia de caracteres de consulta opcional que recupera um subconjunto dos dados em uma fonte de dados primária a ser inserida no documento.

SQLStatement1: Object

Se a cadeia de caracteres de consulta tiver mais de 255 caracteres, SQLStatement indicará a primeira parte da cadeia de caracteres e SQLStatement1 indicará a segunda parte.

PasswordDocument: Object

A senha necessária (se houver) para abrir a fonte de dados. (Consulte os comentários abaixo.)

PasswordTemplate: Object

Se a fonte de dados for um documento do Microsoft Office Word, esse argumento será a senha (se houver) necessária para abrir o modelo anexado. (Consulte os comentários abaixo.)

WritePasswordDocument: Object

A senha necessária para salvar as alterações no documento. (Consulte os comentários abaixo.)

WritePasswordTemplate: Object

A senha necessária para salvar as alterações no modelo. (Consulte os comentários abaixo.)

DataSource: Object

O caminho e o nome do arquivo da fonte de dados.

From: Object

O número do primeiro registro de dados no intervalo de registros a ser inserido.

To: Object

O número do último registro de dados no intervalo de registros a ser inserido.

IncludeFields: Object

true para incluir nomes de campo da fonte de dados na primeira linha da nova tabela.

Exemplos

Este exemplo insere uma planilha do Microsoft Excel no Bookmark controle . O valor style (191) é uma combinação dos números 1, 2, 4, 8, 16, 32 e 128. Este exemplo pressupõe que você tenha uma pasta de trabalho chamada Data.xlsx salva na raiz do diretório C com pelo menos duas linhas de dados na planilha.

Este exemplo destina-se a uma personalização no nível 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

Comentários

Evite usar senhas codificadas nos aplicativos. Caso uma senha seja necessária em um procedimento, solicite a senha junto ao usuário, armazene-a em uma variável e, em seguida, use a variável no código.

Evite usar a conta de logon sa (administrador do sistema) interna. Em vez disso, torne os administradores do sistema membros da função de servidor fixa sysadmin e faça com que eles usem suas próprias contas para fazer logon. Use sa somente quando não houver outra maneira de fazer logon. Para impedir o acesso não autorizado por meio da conta de logon sa, você deve atribuir a essa conta uma senha forte e exclusiva.

Quando possível, use a Autenticação do Windows (também conhecida como conexão confiável), que usa uma conta de usuário do Windows para se conectar a SQL Server. Quando um usuário se conecta por meio de uma conta de usuário do Windows, SQL Server usa informações no sistema operacional Windows para validar o nome da conta e a senha. Antes de usar a Autenticação do Windows, um administrador de 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 as informações de logon dos usuários. É mais seguro que os usuários insiram suas informações de logon sempre que fizerem logon.

Parâmetros Opcionais

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

Aplica-se a

Compartilhar via