Classe QueryTable - un tableau de feuille de calcul créé à partir de données renvoyées à partir d’une source de données externe (Excel VBA)

La classe QueryTable représente un tableau de feuille de calcul créé à partir de données renvoyées à partir d’une source de données externe, telle qu’une base de données Microsoft Access ou SQL Server.

Les classes suivantes donnent accès à la classe QueryTable

Pour utiliser une variable de classe QueryTable, elle doit d'abord être instanciée, par exemple

Dim qrytbl as QueryTable
Set qrytbl = ActiveCell.QueryTable

Les procédures suivantes peuvent être utilisés pour définir des variables de la classe QueryTable : ListObject.QueryTable, QueryTables.Add, QueryTables.Item et Range.QueryTable.

For Each

Voici un exemple de traitement des éléments QueryTable dans une collection

Dim qrytbl As QueryTable
For Each qrytbl In Application.QueryTables
	
Next qrytbl

Méthodes

CancelRefresh - Cette méthode supprime toutes les requêtes d'arrière-plan de la table de requête spécifiée. Utilisez la propriété refreshing pour déterminer si une requête d’arrière-plan est en cours d’utilisation.

Delete - Cette méthode supprime l'objet.

Refresh - Met à jour une plage de données externe dans un objet QueryTable .

ResetTimer - Réinitialise le minuteur d’actualisation pour la table de requête spécifiée ou le rapport de tableau croisé dynamique au dernier intervalle que vous avez défini à l’aide de la propriété RefreshPeriod .

SaveAsODC - Enregistre la source du cache QueryTable en tant que fichier de connexion de données Microsoft Office.

Propriétés

AdjustColumnWidth Cette propriété a la valeur True si la largeur des colonnes est automatiquement modifiée pour obtenir un ajustement optimal chaque fois qu'une table de requête spécifiée est actualisée. Elle a la valeur False si la largeur des colonnes n'est pas automatiquement ajustée à chaque actualisation. La valeur par défaut est True. Boolean (en lecture/écriture).

BackgroundQuery Cette propriété a la valeur True si les requêtes destinées à la table de requêtes sont exécutées de manière asynchrone (en arrière-plan). Boolean (en lecture/écriture).

CommandText Renvoie ou définit la chaîne de commande de la source de données spécifiée. Variant en lecture/écriture.

CommandType Cette propriété renvoie ou définit l’une des constantes XlCmdType suivantes: xlCmdCube, xlCmdDefault, xlCmdSqlou xlCmdTable. La constante qui est renvoyée ou définie décrit la valeur de la propriété CommandText . La valeur par défaut est xlCmdSQL. Énumération XlCmdType en lecture-écriture.

Connection Cette propriété renvoie ou définit une chaîne qui contient l’un des éléments suivants:.

Destination Renvoie la cellule située dans le coin supérieur gauche de la plage de destination de la table de requête (plage où sera placée la table de requête résultante). La plage de destination doit être située sur la feuille de calcul qui contient l'objet QueryTable. En lecture seule Range.

EditWebPage Cette propriété renvoie ou définit l’URL (Uniform Resource Locator) de page Web pour une requête sur le Web. Variant en lecture/écriture.

EnableEditing True si l’utilisateur peut modifier la table de requête spécifiée. False si l’utilisateur peut uniquement actualiser la table de requête. Boolean (en lecture/écriture).

EnableRefresh Cette propriété a la valeur True si la table de requête ou le cache du tableau croisé dynamique peut être actualisé par l’utilisateur. La valeur par défaut est True. Boolean (en lecture/écriture).

FetchedRowOverflow Cette propriété a la valeur True si le nombre de lignes renvoyées par la dernière utilisation de la méthode Refresh est supérieur au nombre de lignes disponibles sur la feuille de calcul. Boolean (en lecture seule).

FieldNames Cette propriété a la valeur True si le nom des champs de la source de données apparaissent en en-tête de colonnes des données renvoyées. La valeur par défaut est True. Boolean (en lecture/écriture).

FillAdjacentFormulas Cette propriété a la valeur True si les formules situées à droite de la table de requête spécifiée sont automatiquement mises à jour à chaque mise à jour de la table. Boolean (en lecture/écriture).

ListObject Cette propriété renvoie un objet ListObject pour l’objet QueryTable . Objet ListObject en lecture seule.

MaintainConnection Cette propriété a la valeur True si la connexion à la source de données spécifiée est conservée après l’actualisation et jusqu’à la fermeture du classeur. La valeur par défaut est True. Boolean (en lecture/écriture).

Name Cette propriété renvoie ou définit une valeur de type String qui représente le nom de l'objet.

Parameters Renvoie une collection Parameters qui représente les paramètres de la table de requête. En lecture seule.

PostText Cette propriété renvoie ou définit la chaîne utilisée avec la méthode post pour l’entrée de données dans un serveur Web pour renvoyer des données à partir d’une requête sur le Web. String en lecture/écriture.

PreserveColumnInfo Cette propriété a la valeur True si les informations de tri, de filtrage et de disposition des colonnes sont conservées lors de l'actualisation d'une table de requête. La valeur par défaut est True. Boolean (en lecture/écriture).

PreserveFormatting Cette propriété a la valeur True si une mise en forme commune aux cinq premières lignes de données est appliquée aux nouvelles lignes de données de la table de requête. Les cellules inutilisées ne sont pas mises en forme. La propriété a la valeur False si la dernière mise en forme automatique, appliquée à la table de requête, est appliquée aux nouvelles lignes de données. La valeur par défaut est True.

QueryType Indique le type de requête utilisée par Microsoft Excel pour remplir le tableau de requête. En lecture seule XlQueryType.

Recordset

Refreshing True si une requête d’arrière-plan est en cours dans la table de requête spécifiée. Boolean (en lecture seule).

RefreshOnFileOpen Cette propriété a la valeur True si la table de requête ou le cache du tableau croisé est automatiquement mis à jour à chaque ouverture du classeur. La valeur par défaut est False. Boolean (en lecture/écriture).

RefreshPeriod Renvoie ou définit le nombre de minutes entre deux actualisations. Long (en lecture/écriture).

RefreshStyle Renvoie ou définit la manière dont les lignes de la feuille de calcul spécifiée sont ajoutées ou supprimées pour recevoir le nombre de lignes contenues dans un jeu d’enregistrements renvoyé par une requête. En lecture/écriture XlCellInsertionMode.

ResultRange Renvoie un objet Range qui représente la zone de la feuille de calcul occupée par la table de requête spécifiée. En lecture seule.

RobustConnect Cette propriété renvoie ou définit le mode de connexion de la table de requête à sa source de données. En lecture/écriture XlRobustConnect.

RowNumbers Cette propriété a la valeur True si le numéro des lignes est ajouté comme première colonne de la table de requête spécifiée. Boolean (en lecture/écriture).

SaveData Cette propriété a la valeur True si les données du rapport de tableau croisé dynamique sont enregistrées avec le classeur. Elle a la valeur False si seule la définition du rapport est enregistrée. Boolean (en lecture/écriture).

SavePassword True si le mot de passe d’une chaîne de connexion ODBC est enregistré avec la requête spécifiée. False si le mot de passe est supprimé. Boolean (en lecture/écriture).

Sort Cette propriété renvoie les critères de tri de la plage de la table de requête. En lecture seule.

SourceConnectionFile Cette propriété renvoie ou définit un objet de type String désignant le fichier ODC (Microsoft Office Data Connection) ou un fichier similaire qui a été utilisé pour créer le QueryTable. Lecture-écriture.

SourceDataFile Cette propriété renvoie ou définit une valeur de type String qui indique le fichier de données sources pour une table de requête.

TextFileColumnDataTypes Cette propriété renvoie ou définit un tableau de constantes classées spécifiant les types de données appliqués aux colonnes correspondantes du fichier texte que vous importez dans une table de requête. La constante par défaut de chaque colonne est xlGeneral. Variant en lecture/écriture.

TextFileCommaDelimiter True si la virgule est le séparateur lorsque vous importez un fichier texte dans une table de requête. False si vous souhaitez utiliser un autre caractère comme délimiteur. La valeur par défaut est False. Boolean (en lecture/écriture).

TextFileConsecutiveDelimiter Cette propriété a la valeur True si les séparateurs consécutifs sont interprétés comme un séparateur unique lorsque vous importez un fichier texte dans une table de requête. La valeur par défaut est False. Boolean (en lecture/écriture).

TextFileDecimalSeparator Cette propriété renvoie ou définit le caractère séparateur décimal utilisé par Microsoft Excel lorsque vous importez un fichier texte dans une table de requête. La valeur par défaut correspond au caractère séparateur décimal du système. String en lecture/écriture.

TextFileFixedColumnWidths Cette propriété renvoie ou définit un tableau d’entiers correspondant aux largeurs des colonnes (en caractères) dans le fichier texte que vous importez dans une table de requête. Les largeurs valides sont comprises entre 1 et 32 767 caractères. Variant en lecture/écriture.

TextFileOtherDelimiter Cette propriété renvoie ou définit le caractère utilisé en tant que séparateur lors de l'importation d'un fichier texte dans une table de requête. La valeur par défaut est null. String en lecture/écriture.

TextFileParseType Cette propriété renvoie ou définit le format de colonne pour les données du fichier texte que vous importez dans une table de requête. En lecture/écriture XlTextParsingType.

TextFilePlatform Cette propriété renvoie ou définit l’origine du fichier texte que vous importez dans la table de requête. Détermine aussi quelle page de codes est utilisée pendant cette importation. En lecture/écriture XlPlatform.

TextFilePromptOnRefresh Cette propriété a la valeur True si vous voulez spécifier le nom du fichier texte importé à chaque actualisation de la table de requête. La boîte de dialogue Importer Fichier Texte vous permet de spécifier le chemin d'accès et le nom du fichier. La valeur par défaut est False. Boolean (en lecture/écriture).

TextFileSemicolonDelimiter True si le point-virgule est le caractère séparateur lorsque vous importez un fichier texte dans une table de requête et si la propriété TextFileParseType a la valeur xlDelimited. La valeur par défaut est False. Boolean (en lecture/écriture).

TextFileSpaceDelimiter Cette propriété a la valeur True si le caractère d'espacement constitue le caractère séparateur lors de l'importation d'un fichier texte dans une table de requête. La valeur par défaut est False. Boolean (en lecture/écriture).

TextFileStartRow Cette propriété renvoie ou définit le numéro de ligne à partir duquel commence l'analyse du texte lors de l'importation d'un fichier texte dans une table de requête. Les valeurs valides sont des nombres entiers compris entre 1 et 32 767. La valeur par défaut est 1. Long (en lecture/écriture).

TextFileTabDelimiter Cette propriété a la valeur True si le caractère de tabulation constitue le caractère séparateur lors de l'importation d'un fichier texte dans une table de requête. La valeur par défaut est False. Boolean (en lecture/écriture).

TextFileTextQualifier Renvoie ou définit l'identificateur de texte lorsque vous importez un fichier texte dans une table de requête. Cet identificateur indique que les données qu'il encadre sont au format texte. En lecture/écriture XlTextQualifier.

TextFileThousandsSeparator Cette propriété renvoie ou définit le caractère de séparation des milliers utilisé par Microsoft Excel lorsque vous importez un fichier texte dans une table de requête. La valeur par défaut est le caractère séparateur des milliers du système. String en lecture/écriture.

TextFileTrailingMinusNumbers True pour que Microsoft Excel traite les nombres importés en tant que - texte commençant par un signe (moins) comme un symbole négatif. False pour qu’Excel traite les nombres importés en tant - que texte commençant par un symbole en tant que texte. Boolean (en lecture/écriture).

TextFileVisualLayout Cette propriété renvoie ou définit une énumération XlTextVisualLayoutType qui indique si la disposition visuelle du texte importé est de gauche à droite ou de droite à gauche.

WebConsecutiveDelimitersAsOne True si les séparateurs consécutifs sont traités comme un seul séparateur lorsque vous importez des données à partir de balises HTML sur une page Web dans une table de requête, et si les données doivent être analysées en colonnes. Elle prend la valeur False si les séparateurs consécutifs sont interprétés comme des séparateurs distincts. La valeur par défaut est True. Boolean (en lecture/écriture).

WebDisableDateRecognition True si les données qui ressemblent à des dates sont analysées en tant que texte lorsque vous importez une page Web dans une table de requête. False si la reconnaissance de date est utilisée. La valeur par défaut est False. Boolean (en lecture/écriture).

WebDisableRedirections True si les redirections de requête Web sont désactivées pour un objet QueryTable . La valeur par défaut est False. Boolean (en lecture/écriture).

WebFormatting Cette propriété renvoie ou définit une valeur qui détermine la proportion de mise en forme d’une page Web, le cas échéant, appliquée lorsque vous importez la page dans une table de requête. En lecture/écriture XlWebFormatting.

WebPreFormattedTextToColumns Cette propriété renvoie ou définit si les données contenues dans les balises HTML de la page Web sont analysées en colonnes lorsque vous importez la page dans une table de requête. La valeur par défaut est True. Boolean (en lecture/écriture).

WebSelectionType Cette propriété renvoie ou définit une valeur qui détermine si une page Web entière, toutes les tables de la page Web ou uniquement des tables spécifiques de la page Web sont importées dans une table de requête. En lecture/écriture XlWebSelectionType.

WebSingleBlockTextImport True si les données des balises HTML sur la page Web spécifiée sont traitées en une seule fois lorsque vous importez la page dans une table de requête. False si les données sont importées dans des blocs de lignes contiguës de sorte que les lignes d’en-tête soient reconnues comme telles. La valeur par défaut est False. Boolean (en lecture/écriture).

WebTables Cette propriété renvoie ou définit une liste délimitée par des virgules des noms de tableaux ou des index de tableau lorsque vous importez une page Web dans une table de requête. String en lecture/écriture.

WorkbookConnection Renvoie l’objet WorkbookConnection que la table de requête utilise. En lecture seule.

ListObject - Représente une liste d’objets de la collection ListObjects.

Parameters - Collection d'objets Parameter pour la table de requête spécifiée.

Range - Cette collection représente une cellule, une ligne, une colonne ou une sélection de cellules contenant un ou plusieurs blocs contigus de cellules ou une plage 3D.

Sort - Représente le tri d'une plage de données.

WorkbookConnection - 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 Microsoft Excel.