WorkbookConnection Interface

  • Referência

Definição

Namespace:
Microsoft.Office.Interop.Excel
Assembly:
Microsoft.Office.Interop.Excel.dll

Uma conexão é um conjunto de informações necessárias para obter dados de uma fonte de dados externa diferente de uma 1st_Excel12 de trabalho.

public interface class WorkbookConnection
[System.Runtime.InteropServices.Guid("00024485-0000-0000-C000-000000000046")]
[System.Runtime.InteropServices.InterfaceType(2)]
public interface WorkbookConnection
Public Interface WorkbookConnection
Atributos
GuidAttribute InterfaceTypeAttribute

Comentários

As conexões podem ser armazenadas em uma pasta de trabalho do Excel. Quando a workbook é aberta, Excel cria uma cópia na memória da conexão que é chamada de objeto connection. Um objeto de conexão contém informações como o nome do servidor e o nome do objeto a ser aberto nesse servidor. Como opção, o objeto da conexão também pode incluir credenciais de autenticação e/ou um comando a ser passado ao servidor e executado (exemplo: uma instrução SELECT a ser executada pelo SQL Server).

Observação: a forma exata da conexão depende do mecanismo que está sendo usado para recuperar dados – as conexões ODBC, as conexões OLEDB e as Consultas da Web conterão informações diferentes.

Uma conexão também pode ser armazenada em um arquivo de conexão separado. A maioria das conexões em uma pasta de trabalho do Excel incluem um ponteiro para um arquivo de conexão externo. Os arquivos de conexão possuem extensões que claramente os rotulam como arquivos de conexão (*.ODC, *.IQY etc.) e podem estar localizados na máquina local do usuário ou em outros locais conhecidos ou confiáveis tais como o WSS (Biblioteca de Conexões de Dados) ou outros servidores corporativos. Os arquivos de conexão permitem que vários usuários na mesma organização reutilizem conexões. Os administradores de rede podem alterar a forma como toda a organização se conecta a uma fonte de dados back-end alterando um único arquivo de conexão. Um arquivo de conexão não é obrigatório ao conectar-se a uma fonte de dados externa.

Os nomes de conexão são sequências que identificam exclusivamente conexões na pasta de trabalho em que são usadas. Há outras propriedades de uma conexão que não são exclusivas. Sempre que uma fórmula no Excel pegar um argumento que seja uma conexão, ele será suficiente para fazer referência ao nome dessa conexão, seja diretamente (como uma sequência) ou indiretamente (fazendo referência a uma célula que contém o nome de conexão como sequência).

Propriedades

_Default
Application

Quando usada sem um qualificador de objeto, essa propriedade retorna um _Application objeto que representa o Microsoft Office Excel aplicativo. Quando usado com um qualificador de objeto, essa propriedade retorna um objeto Application que representa o criador do objeto especificado. Somente leitura.
Creator

Retorna um inteiro de 32 bits que indica o aplicativo no qual esse objeto foi criado. Integer somente leitura.
DataFeedConnection

Retorna um objeto DataFeedConnection que contém os dados e a funcionalidade necessários para se conectar a feeds de dados. Somente leitura
Description

Retorna ou define uma breve descrição para um WorkbookConnection objeto. String de leitura/gravação.
InModel

Especifica se o objeto WorkbookConnection foi adicionado ou não ao modelo. Boolean (bool no C#) Somente leitura.
ModelConnection

Retorna um objeto que contém informações para o novo Tipo de Conexão de Modelo introduzido no Excel 2013 para interagir com o Modelo de Dados integrado. Somente leitura
ModelTables

Retorna um ModelTables objeto associado à conexão específica. Somente leitura
Name

Retorna ou define o nome do objeto de conexão da pasta de trabalho. String de leitura/gravação.
ODBCConnection

Retuns the ODBC Connection details for the WorkbookConnection specified object. Somente leitura ODBCConnection .
OLEDBConnection

Retuns the OLEDB Connection details for the WorkbookConnection specified object. Somente leitura OLEDBConnection .
Parent

Retorna o objeto pai para o objeto especificado. Somente leitura.
Ranges

Retorna o intervalo de objetos do objeto WorkbookConnection especificado. Somente leitura Ranges .
RefreshWithRefreshAll

Determina se a conexão deve ser atualizada quando a atualização de tudo é executada. Boolean (bool no C#). Leitura/gravação.
TextConnection

Retorna um TextConnection objeto que contém as informações de uma consulta para um arquivo de texto. Somente leitura.
Type

Retorna o tipo de conexão da pasta de trabalho. Somente leitura XlConnectionType .
WorksheetDataConnection

Retorna um objeto que contém informações para uma conexão do modelo PowerPivot para dados dentro da agenda de trabalho, como um intervalo, um intervalo nomeado ou uma tabela. Somente leitura.

Métodos

Delete()

Exclui a conexão de uma pasta de trabalho.
Refresh()

Atualiza a conexão de uma pasta de trabalho.

Aplica-se a