Bookmark.InsertDatabase(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object) Método
Definição
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);
Parâmetros
- Format
- Object
Um formato listado na caixa Formatos da caixa de diálogo AutoFormatação 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 pelo Format que são aplicados à tabela. Use a soma de qualquer combinação dos seguintes valores:
[1|1] Valor
[1|2] Significado
[2 | 1] 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 Cabeçalho
[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 de ODBC, você pode especificar uma cadeia de conexão.
Ao recuperar dados do Microsoft Office Excel usando DDE (troca dinâmica de dados), você especifica um intervalo nomeado ou “Toda a Planilha”.
Observação A DDE (troca dinâmica de dados) é uma tecnologia antiga que não é segura. Se possível, use uma alternativa ao DDE mais segura, como o OLE (vinculação e incorporação de objeto).
Ao recuperar dados do Microsoft Access, você especifica a palavra “Table” ou “Query” seguido pelo nome da 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 for maior que 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 de 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 Data.xlsx de trabalho chamada 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 do SA (administrador do sistema) interna. Em vez disso, torne os administradores de sistema membros da função de servidor fixa sysadmin e faça com que eles usem suas próprias contas para fazer logon. Use o 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 ao 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. Para poder 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 cada vez que fizerem logon.
Parâmetros opcionais
Para obter informações sobre parâmetros opcionais, consulte parâmetros opcionais em soluções do Office.