Range.InsertDatabase Método

Definição

Namespace:

Microsoft.Office.Interop.Word

Assembly:

Microsoft.Office.Interop.Word.dll

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

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

Objeto opcional. Um formato listado na caixa Formatos da caixa de diálogo AutoFormatação da tabela (menu Tabela). Pode ser qualquer uma das WdTableFormat constantes. Por padrão, uma borda é aplicada às células da tabela.

Style

Object

Objeto opcional. Os atributos do AutoFormat especificados por Format que são aplicados à tabela. Use a soma de qualquer combinação dos seguintes valores:ValueMeaning0 (zero)None1Borders2Shading4Font8Color16Auto Fit32Heading Rows64Last Row128First Column256Last Column

LinkToSource

Object

Objeto opcional. True para estabelecer um vínculo entre a nova tabela e a fonte de dados.

Connection

Object

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

SQLStatement

Object

Cadeia de caracteres opcional. Uma sequência de consulta opcional que recupera um subconjunto dos dados de uma fonte de dados principal a ser inserido no documento.

SQLStatement1

Object

Cadeia de caracteres opcional. Se a cadeia de caracteres de consulta for maior que 255 caracteres, SQLStatement denota a primeira parte da cadeia de caracteres e SQLStatement1 denota a segunda parte.

PasswordDocument

Object

Objeto opcional. A senha (caso haja alguma) necessária para abrir a fonte de dados. (Consulte os Comentários abaixo.)

PasswordTemplate

Object

Objeto opcional. Se a fonte de dados for um documento do Word, esse argumento será a senha (caso haja uma) necessária para abrir o modelo anexado. (Consulte os Comentários abaixo.)

WritePasswordDocument

Object

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

WritePasswordTemplate

Object

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

DataSource

Object

Objeto opcional. O caminho e o nome de arquivo da fonte de dados.

From

Object

Objeto opcional. O número do primeiro registro de dados no intervalo de registros a serem inseridos.

To

Object

Objeto opcional. O número do último registro de dados no intervalo de registros a serem inseridos.

IncludeFields

Object

Objeto opcional. True para incluir nomes de campo da fonte de dados na primeira linha da nova tabela.

Comentários

Evite usar senhas codificadas em seus aplicativos. Se um aplicativo for necessário em um procedimento, solicite a senha do usuário, armazene-a em uma variável e então use a variável em seu código.

Evite usar a conta de logon do administrador do sistema interno (sa). Em vez disso, crie membros dos administradores do sistema da função de servidor fixo sysadmin e então faça-os usar suas próprias contas para fazer logon. Use o sa somente quando não houver outra forma de fazer logon. Para impedir o acesso não autorizado por meio da conta de logon sa, atribua a essa conta uma senha forte e exclusiva.

Quando for 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, o SQL Server usa informações do sistema operacional Windows para validar o nome e a senha da conta. Antes de poder usar a Autenticação do Windows, um administrador de servidor deverá configurar o 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. Será mais seguro para os usuários inserir as informações de logon deles sempre que fizerem logon.