WorkbookConnection Interface

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 pasta de trabalho 1st_Excel12.

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 pasta de trabalho é aberta, o Excel cria uma cópia na memória da conexão que é chamada de objeto de conexão. 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 – conexões ODBC, conexões OLEDB e Consultas 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 inclui um ponteiro para um arquivo de conexão externa. 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	Uma conexão é um conjunto de informações necessárias para obter dados de uma fonte de dados externa diferente de uma pasta de trabalho 1st_Excel12.
Application	Quando usada sem um qualificador de objeto, essa propriedade retorna um _Application objeto que representa o aplicativo do Microsoft Office Excel. 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 aos feeds de dados. Somente leitura
Description	Retorna ou define uma breve descrição de um WorkbookConnection objeto. String de leitura/gravação.
InModel	Especifica se o objeto WorkbookConnection foi ou não adicionado ao modelo. Bool (bool em 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	Reajusta os detalhes da Conexão ODBC para o objeto especificado WorkbookConnection . Somente ODBCConnectionleitura .
OLEDBConnection	Reajusta os detalhes da Conexão OLEDB para o objeto especificado WorkbookConnection . Somente OLEDBConnectionleitura .
Parent	Retorna o objeto pai do objeto especificado. Somente leitura.
Ranges	Retorna o intervalo de objeto para o objeto especificado WorkbookConnection . Somente Rangesleitura .
RefreshWithRefreshAll	Determina se a conexão deve ser atualizada quando a atualização é executada. Bool (bool em C#). Leitura/gravação.
TextConnection	Retorna um TextConnection objeto que contém as informações em uma consulta para um arquivo de texto. Somente leitura.
Type	Retorna o tipo de conexão da pasta de trabalho. Somente XlConnectionTypeleitura .
WorksheetDataConnection	Retorna um objeto que contém informações para uma conexão do Modelo do PowerPivot para dados dentro da pasta de trabalho, como um intervalo, intervalo nomeado ou 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.