Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Connection - Classe

Office 2013 et versions ultérieures

Cette documentation est préliminaire et peut changer.

Connexion. Lorsque l'objet est sérialisé en XML, son nom qualifié est x: connexion.

Espace de noms :  DocumentFormat.OpenXml.Spreadsheet
Assembly :  DocumentFormat.OpenXml (dans DocumentFormat.OpenXml.dll)

[ChildElementInfoAttribute(typeof(DatabaseProperties))]
[ChildElementInfoAttribute(typeof(TextProperties))]
[ChildElementInfoAttribute(typeof(WebQueryProperties))]
[ChildElementInfoAttribute(typeof(OlapProperties))]
[ChildElementInfoAttribute(typeof(Parameters))]
[ChildElementInfoAttribute(typeof(ConnectionExtensionList))]
public class Connection : OpenXmlCompositeElement

[ISO/IEC 29500-1 1st Edition]

connexion (connexion)

Cet élément contient à la fois la définition de la façon d'accéder à une source de données externe, ainsi que les informations décrivant l'utilisation de la connexion dans le classeur. Constructions de spécifique dans une feuille de calcul, tel que des formules OLAP, QueryTables, ou de tableaux croisés dynamiques permettent l'utilisation d'informations de la connexion pour récupérer ou actualiser les données basé sur les événements par défaut ou demande explicite de l'utilisateur.

Éléments parents

connexions (§18.13.2)

Élements enfants

Sous-clause

dbPr (propriétés de base de données)

§18.13.3

extLst (futur fonctionnalité de zone de stockage)

§18.2.10

olapPr (propriétés OLAP)

§18.13.5

paramètres (paramètres de la requête)

§18.13.7

textPr (paramètres d'importation de texte)

§18.13.12

webPr (propriétés de la requête Web)

§18.13.13

Attributs

Description

arrière-plan (actualisation de l'arrière-plan)

Indique si la connexion peut être actualisée en arrière-plan (de façon asynchrone). est Vrai si vous préférez l'utilisation de la connexion à actualiser de façon asynchrone à l'arrière-plan ; false si vous préférez l'utilisation de la connexion est d'actualiser de façon synchrone au premier plan.

Cet indicateur doit être ignoré intentionnellement dans des cas particuliers.

[Exemple: en est un exemple de lorsque l'indicateur est ignoré dans le cas d'une connexion aux données OLAP de Microsoft SQL Server Analysis Services, où la connexion est utilisée par les deux un tableau croisé dynamique ainsi que par les fonctions CUBE dans le classeur. Cette connexion sera toujours actualisée synchrone par le tableau croisé dynamique et sera toujours actualisée en mode asynchrone par les fonctions CUBE. exemple de fin]

Les valeurs possibles pour cet attribut sont définies par le type de données boolean W3C XML Schema.

informations d'identification (méthode de reconnexion)

Spécifie la méthode d'authentification à utiliser lors de l'établissement (ou rétablir) la connexion.

Les valeurs possibles pour cet attribut sont définies par le type simple ST_CredMethod (§18.18.16).

(Supprimer connexion supprimée)

Indique si la connexion de classeur associé a été supprimée. true si la connexion a été supprimée ; Sinon, false.

Supprimez les connexions contiennent seulement les attributs nom et supprimés =true, toutes les autres informations sont supprimées du fichier SpreadsheetML.

Si une nouvelle connexion est créée avec le même nom qu'une connexion supprimée, puis la connexion supprimée est remplacée par la nouvelle connexion.

Les valeurs possibles pour cet attribut sont définies par le type de données boolean W3C XML Schema.

Description (Description de la connexion)

Spécifie la description de l'utilisateur pour cette connexion.

Les valeurs possibles pour cet attribut sont définies par le type simple ST_Xstring (§22.9.2.19).

ID (Id de connexion)

Spécifie l'identificateur unique de cette connexion.

Les valeurs possibles de cet attribut sont définies par le type de données unsignedInt du schéma XML du W3C.

Interval (intervalle d'actualisation automatique)

Spécifie le nombre de minutes entre les actualisations automatiques de la connexion. Lorsque cet attribut n'est pas présent, la connexion n'est pas automatiquement actualisée.

Les valeurs possibles de cet attribut sont définies par le type de données unsignedInt du schéma XML du W3C.

keepAlive (conserver connexion ouverte)

true lorsque l'application de la feuille de calcul devrait s'efforcer de conserver la connexion ouverte. False, lorsque l'application doit fermer la connexion après l'extraction des informations. Cela correspond à la propriété MaintainConnection d'un objet PivotCache.

Les valeurs possibles pour cet attribut sont définies par le type de données boolean W3C XML Schema.

minRefreshableVersion (Version de Minimum requis pour actualiser)

Pour assurer la compatibilité avec les applications héritées de feuille de calcul. Ceci représente la version minimale # doit être en mesure d'actualiser correctement la connexion de données. Cet attribut s'applique aux connexions qui sont utilisées par une table de requête.

Les valeurs possibles pour cet attribut sont définies par le type de données unsignedByte W3C XML Schema.

nom (connexion)

Spécifie le nom de la connexion. Chaque connexion doit avoir un nom unique.

Lorsqu'une connexion a été marquée comme étant supprimé, et ensuite une nouvelle connexion est ajoutée avec le même nom, la connexion supprimée est remplacée par la nouvelle connexion.

Les valeurs possibles pour cet attribut sont définies par le type simple ST_Xstring (§22.9.2.19).

Nouveau (nouvelle connexion)

true si la connexion n'a pas été actualisée pour la première fois ; Sinon, false. Cet état peut se produire lorsque l'utilisateur enregistre le fichier avant de retourner d'une requête.

Les valeurs possibles pour cet attribut sont définies par le type de données boolean W3C XML Schema.

odcFile (fichier de connexion)

Spécifie le chemin d'accès complet au fichier de connexion externe à partir de laquelle cette connexion a été créée. Si une connexion échoue lors d'une tentative d'actualisation des données et reconnectionMethod =1, l'application de la feuille de calcul va essayer à nouveau en utilisant les informations du fichier de connexion externe plutôt que l'objet de connexion incorporée dans le classeur.

Il s'agit d'un avantage pour les données source et spreadsheetML document la facilité de gestion. Si la définition dans le fichier de connexion externe est modifiée (par exemple, en raison d'un changement de nom de serveur de base de données), les classeurs qui utilisent des que connexion ne pourra pas se connecter avec leurs informations de connexion internes et recharger les nouvelles informations de connexion à partir de ce fichier.

Cet attribut est désactivé par l'application de la feuille de calcul lorsque l'utilisateur modifie manuellement la définition de la connexion dans le classeur. Peut être exprimé en ou spécifiques au système de notation de chemin d'accès de fichier.

[Remarque: les Applications peuvent décider ce que forms de leur prise en charge, et que les notations de chemin d'accès de fichiers spécifiques au système sont pris en charge. fin de la Remarque]

Les valeurs possibles pour cet attribut sont définies par le type simple ST_Xstring (§22.9.2.19).

onlyUseConnectionFile (fichier de connexion d'utilisation uniquement)

Indique si l'application doit toujours et utiliser uniquement les informations de connexion dans le fichier de connexion externe indiqué par l'attribut odcFile lors de l'actualisation de la connexion.

Si false, puis l'application de la feuille de calcul doit suivre la procédure indiquée par l'attribut reconnectionMethod décrit ci-dessous.

S'applique uniquement aux connexions OLE DB et ODBC, cet attribut est ignoré pour les autres types de connexions.

Les valeurs possibles pour cet attribut sont définies par le type de données boolean W3C XML Schema.

reconnectionMethod (méthode de reconnexion)

Spécifie que l'application de la feuille de calcul doit faire en cas d'échec d'une connexion.

Les valeurs sont comme suit :

1 = requis: lors de l'actualisation, utiliser les informations de connexion existantes. Si les informations existantes ne peut pas être utilisées pour établir une connexion, obtenir des informations de connexion à jour, s'il est disponible à partir du fichier de connexion externe.

2 = toujours: sur chaque actualisation obtenir des informations de connexion mises à jour à partir du fichier de connexion externe, le cas échéant et l'utiliser au lieu des informations de connexion existantes. Dans ce cas, l'actualisation de données échoue si le fichier de connexion externe n'est pas disponible.

3 = ne jamais: jamais get et mis à jour les informations de connexion à partir du fichier de connexion externe même si elle est disponible même si les informations de connexion existantes ne peuvent pas être utilisées.

Les valeurs possibles de cet attribut sont définies par le type de données unsignedInt du schéma XML du W3C.

refreshedVersion (dernière Version Actualiser)

À des fins de compatibilité descendante, cet attribut indique la version de l'application de la feuille de calcul que la dernière actualisation de la connexion.

Cet attribut s'applique aux connexions qui sont utilisées par une table de requête.

Les valeurs possibles pour cet attribut sont définies par le type de données unsignedByte W3C XML Schema.

refreshOnLoad (actualisation à l'ouverture)

true si cette connexion doit être actualisée lors de l'ouverture du fichier ; Sinon, false.

Les valeurs possibles pour cet attribut sont définies par le type de données boolean W3C XML Schema.

saveData (enregistrer les données)

true si les données externes extraites via la connexion pour remplir une table doit être enregistré avec le classeur ; Sinon, false.

Il existe des données des raisons de sécurité - si aucune donnée externe n'est enregistrée dans (ou « cache ») dans le classeur, puis les informations d'identification utilisateur actuel peuvent être demandées chaque fois pour récupérer les données pertinentes et les personnes ne sont pas voir les données de que l'auteur du classeur dernier utilisait avant d'enregistrer le fichier.

Les valeurs possibles pour cet attribut sont définies par le type de données boolean W3C XML Schema.

savePassword (enregistrer le mot de passe)

true si le mot de passe doit être enregistré en tant que partie de la chaîne de connexion ; Sinon, False.

Les valeurs possibles pour cet attribut sont définies par le type de données boolean W3C XML Schema.

singleSignOnId (authentification unique Id)

Identificateur pour seul Sign On (SSO) utilisé pour l'authentification entre un serveur intermédiaire spreadsheetML et la source de données externe.

[Remarque: connectivité de données peut utiliser un certain nombre de technologies différentes. Vous trouverez un exemple de valeurs potentielles stockée dans cet attribut à: http://msdn.microsoft.com/library/default.asp?url=/ library/en-us/spptsdk/html/cSSOReturnCodes_SV01001109.asp fin de la Remarque]

Les valeurs possibles pour cet attribut sont définies par le type simple ST_Xstring (§22.9.2.19).

sourceFile (fichier de base de données Source)

Utilisé lorsque la source de données externe est basé sur le fichier. En cas d'échec d'une connexion à une source de données, l'application tente de se connecter directement à ce fichier. Peut être exprimé en ou spécifiques au système de notation de chemin d'accès de fichier.

[Remarque: les Applications peuvent décider ce que forms de leur prise en charge, et que les notations de chemin d'accès de fichiers spécifiques au système sont pris en charge. fin de la Remarque]

Les valeurs possibles pour cet attribut sont définies par le type simple ST_Xstring (§22.9.2.19).

type (Type de base de données Source)

Spécifie le type de source de données.

Les valeurs sont comme suit :

1. source basées sur ODBC

2. DAO basé sur la source

3. source de base de données basés sur des fichiers

4. requête sur le web

5. OLE DB source basée sur

6. texte basé sur la source

7. jeu enregistrement

8. DSP

Les valeurs possibles de cet attribut sont définies par le type de données unsignedInt du schéma XML du W3C.

[Remarque: le W3C XML Schema definition de cet élément modèle de contenu (CT_Connection) se trouve dans §A.2. fin de la Remarque]

© ISO/IEC29500: 2008.

Tous les membres statique (Partagé dans Visual Basic)s publics de ce type sont thread-safe. Cela n’est pas garanti pour les membres d’instance.
Afficher: