WorkbookConnection Interface

Définition

Espace de noms:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

Une connexion est un ensemble d’informations nécessaires pour obtenir des données à partir d’une source de données externe autre qu’un classeur 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

Attributs

GuidAttribute InterfaceTypeAttribute

Remarques

Les connexions peuvent être stockées à l'intérieur d'un classeur Excel. Lorsque le classeur est ouvert, Excel crée une copie en mémoire de la connexion appelée objet de connexion. Un objet de connexion contient des informations, telles que le nom du serveur et le nom de l'objet à ouvrir sur ce serveur. L'objet de connexion peut également éventuellement inclure les informations d'authentification et/ou une commande qui doit être transmise au serveur et exécutée ( exemple : une instruction SELECT que SQL Server doit exécuter).

Remarque : La forme exacte de la connexion dépend du mécanisme utilisé pour récupérer des données : les connexions ODBC, les connexions OLEDB et les requêtes web contiennent des informations différentes.

Une connexion peut également être stockée dans un fichier de connexion distinct. La plupart des connexions dans un classeur Excel incluent un pointeur vers un fichier de connexion externe. Les fichiers de connexion ont des extensions qui les étiquetent clairement comme fichiers de connexion (*). ODC*. IQY, etc.) et peuvent se trouver sur l’ordinateur local de l’utilisateur ou dans d’autres emplacements connus ou approuvés tels que WSS (Data Connection Library) ou d’autres serveurs d’entreprise. Les fichiers de connexion permettent à plusieurs utilisateurs au sein d’un même organization de réutiliser les connexions. Les administrateurs réseau peuvent modifier la façon dont l’ensemble du organization se connecte à une source de données back-end en modifiant un fichier de connexion unique. Un fichier de connexion n’est pas toujours requis lors de la connexion à une source de données externe.

Les noms de connexion sont des chaînes qui identifient de façon unique les connexions à l'intérieur du classeur dans lequel elles sont utilisées. Toutes les propriétés d'une connexion qui ne sont pas uniques. Chaque fois qu'une formule dans Excel prend un argument qui est une connexion, il sera suffisant de faire référence au nom de cette connexion, soit directement (sous forme de chaîne), soit indirectement (par référence à une cellule qui contient le nom de connexion sous forme de chaîne).

Propriétés

_Default	Une connexion est un ensemble d’informations nécessaires pour obtenir des données à partir d’une source de données externe autre qu’un classeur 1st_Excel12.
Application	Lorsqu’elle est utilisée sans qualificateur d’objet, cette propriété renvoie un _Application objet qui représente l’application Microsoft Office Excel. Lorsqu’elle est utilisée avec un qualificateur d’objet, elle renvoie un objet Application qui représente l’auteur de l’objet spécifié. En lecture seule.
Creator	Renvoie un nombre entier de 32 bits qui indique l’application dans laquelle cet objet a été créé. Entier en lecture seule.
DataFeedConnection	Renvoie un objet DataFeedConnection qui contient les données et les fonctionnalités nécessaires pour se connecter aux flux de données. Lecture seule
Description	Renvoie ou définit une brève description d’un WorkbookConnection objet. String en lecture/écriture.
InModel	Spécifie si l’objet WorkbookConnection a été ajouté ou non au modèle. Boolean (bool en C#) En lecture seule.
ModelConnection	Retourne un objet qui contient des informations sur le nouveau type de connexion de modèle introduit dans Excel 2013 pour interagir avec le modèle de données intégré. Lecture seule
ModelTables	Retourne un ModelTables objet associé à la connexion particulière. Lecture seule
Name	Cette propriété renvoie ou définit le nom de la connexion de classeur. String en lecture/écriture.
ODBCConnection	Réassommer les détails de connexion ODBC pour l’objet spécifié WorkbookConnection . En lecture seule ODBCConnection.
OLEDBConnection	Réassommer les détails de connexion OLEDB pour l’objet spécifié WorkbookConnection . En lecture seule OLEDBConnection.
Parent	Renvoie l’objet parent pour l’objet spécifié. En lecture seule.
Ranges	Retourne la plage de l’objet pour l’objet spécifié WorkbookConnection . En lecture seule Ranges.
RefreshWithRefreshAll	Détermine si la connexion doit être actualisée lors de l’exécution de l’actualisation de tout. Boolean (bool en C#). Lecture/écriture.
TextConnection	Retourne un TextConnection objet qui contient les informations d’une requête dans un fichier texte. En lecture seule.
Type	Cette propriété renvoie le type de connexion de classeur. En lecture seule XlConnectionType.
WorksheetDataConnection	Retourne un objet qui contient des informations pour une connexion du modèle PowerPivot à des données dans le classeur, telles qu’une plage, une plage nommée ou une table. En lecture seule.

Méthodes

Delete()	Cette méthode supprime une connexion de classeur.
Refresh()	Actualise la connexion d’un classeur.