WorkbookConnection Interface
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 1st_Excel12 de travail.
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
Remarques
Les connexions peuvent être stockées à l'intérieur d'un classeur Excel. Lorsque le workbook 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 enregistrée dans un fichier de connexion distinct. La plupart des connexions d'un classeur Excel incluent un pointeur vers un fichier de connexion externe. Les fichiers de connexion ont des extensions (*.ODC, *.IQY, etc.) qui les identifient clairement en tant que fichiers de connexion. Ils peuvent être stockés sur l'ordinateur local de l'utilisateur ou dans tout emplacement connu ou approuvé, tel que WSS (Bibliothèque de connexions de données), ou dans tout autre serveur de l'entreprise. Les fichiers de connexion permettent à plusieurs utilisateurs au sein de la même organisation de réutiliser des connexions. Les administrateurs réseau sont en mesure de changer la manière dont l'ensemble d'une organisation se connecte à une source de données principale en modifiant un seul fichier de connexion. 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 | |
| Application |
Utilisée sans qualificateur d’objet, cette propriété renvoie un objet qui représente _Application l’Microsoft Office Excel application. 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 WorkbookConnection d’un objet. String en lecture/écriture. |
| InModel |
Spécifie si l’objet WorkbookConnection a été ajouté au modèle ou non. Booléen (booléen C#) En lecture seule. |
| ModelConnection |
Renvoie un objet qui contient des informations pour 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 |
Renvoie 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 |
Retuns the ODBC Connection details for the specified WorkbookConnection object. En lecture ODBCConnection seule. |
| OLEDBConnection |
Retuns the OLEDB Connection details for the specified WorkbookConnection object. En lecture OLEDBConnection seule. |
| Parent |
Renvoie l'objet parent de l'objet spécifié. En lecture seule. |
| Ranges |
Renvoie la plage d’objets de l’objet WorkbookConnection spécifié. En lecture Ranges seule. |
| RefreshWithRefreshAll |
Détermine si la connexion doit être actualisée lors de l’exécution de l’ensemble de l’actualisation. Booléen (booléen en C#). Lecture/écriture. |
| TextConnection |
Renvoie 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 XlConnectionType seule. |
| WorksheetDataConnection |
Renvoie un objet qui contient des informations pour une connexion entre le modèle PowerPivot et les données du manuel, telles qu’une plage, une plage nommée ou un tableau. En lecture seule. |
Méthodes
| Delete() |
Cette méthode supprime une connexion de classeur. |
| Refresh() |
Actualise la connexion d’un classeur. |