Partager via


QueryTable Interface

Définition

Représente une table de feuille de calcul générée à partir de données retournées à partir d’une source de données externe, telle qu’un serveur SQL ou une base de données Microsoft Access. L’objet QueryTable est membre de la QueryTables collection.

public interface class QueryTable : Microsoft::Office::Interop::Excel::_QueryTable, Microsoft::Office::Interop::Excel::RefreshEvents_Event
[System.Runtime.InteropServices.Guid("00024428-0000-0000-C000-000000000046")]
public interface QueryTable : Microsoft.Office.Interop.Excel._QueryTable, Microsoft.Office.Interop.Excel.RefreshEvents_Event
Public Interface QueryTable
Implements _QueryTable, RefreshEvents_Event
Dérivé
Attributs
Implémente

Remarques

Il s’agit d’une interface .NET dérivée d’une coclasse COM requise par le code managé pour l’interopérabilité avec l’objet COM correspondant. Utilisez cette interface dérivée pour accéder à tous les membres de méthode, de propriété et d’événement de l’objet COM. Toutefois, si la méthode ou l’événement que vous souhaitez utiliser partage le même nom sous le même objet COM, vous devez effectuer une conversion de type (transtypage) vers l’interface principale correspondante pour appeler la méthode, puis effectuer une conversion de type (transtypage) vers l’interface d’événements les plus récents pour vous connecter à l’événement. Reportez-vous à cette rubrique pour plus d’informations sur l’objet COM. Pour plus d’informations sur les membres de la méthode et de la propriété de l’objet COM, consultez _QueryTable.

Utilisez QueryTables(index), où index est le numéro d’index de la table de requête, pour renvoyer un seul objet QueryTable .

Propriétés

AdjustColumnWidth

Cette propriété a la valeur True si les largeurs de colonne sont automatiquement ajustées pour la meilleure ajustement chaque fois que vous actualisez la table de requête ou le mappage XML spécifié. 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).

(Hérité de _QueryTable)
Application

Renvoie un Application objet qui représente l’application Microsoft Excel. En lecture seule.

(Hérité de _QueryTable)
BackgroundQuery

True si les requêtes pour le rapport ou la table de requête de tableau croisé dynamique sont exécutées de manière asynchrone (en arrière-plan). Boolean (en lecture/écriture).

(Hérité de _QueryTable)
CommandText

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

(Hérité de _QueryTable)
CommandType

Renvoie ou définit une XlCmdType constante qui décrit le type de commande associé à la CommandText propriété . La valeur par défaut est xlCmdSQL. En lecture/écriture XlCmdType.

(Hérité de _QueryTable)
Connection

Renvoie ou définit une chaîne qui contient des informations de connexion pour la table de requête. Objet en lecture/écriture.

(Hérité de _QueryTable)
Creator

Retourne une constante dans l’énumération XlCreator qui indique l’application dans laquelle cet objet a été créé. Si l'objet a été créé dans Microsoft Excel, cette propriété renvoie la chaîne XCEL, qui équivaut au nombre hexadécimal 5843454C. En lecture seule XlCreator.

(Hérité de _QueryTable)
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 se trouver dans la feuille de calcul qui contient l’objet QueryTable . En lecture seule de plage.

(Hérité de _QueryTable)
EditWebPage

Renvoie ou définit l’URL (Uniform Resource Locator) d’une page web pour une requête web. Objet en lecture/écriture.

(Hérité de _QueryTable)
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).

(Hérité de _QueryTable)
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).

(Hérité de _QueryTable)
FetchedRowOverflow

True si le nombre de lignes retournées par la dernière utilisation de la Refresh(Object) méthode est supérieur au nombre de lignes disponibles dans la feuille de calcul. Boolean (en lecture seule).

(Hérité de _QueryTable)
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).

(Hérité de _QueryTable)
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).

(Hérité de _QueryTable)
HasAutoFormat

Réservé à une utilisation interne.

(Hérité de _QueryTable)
ListObject

Renvoie un ListObject objet pour l’objet ou QueryTable l’objet Range . Objet ListObject en lecture seule.

(Hérité de _QueryTable)
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).

(Hérité de _QueryTable)
Name

Cette propriété renvoie ou définit le nom de l'objet. String en lecture/écriture.

(Hérité de _QueryTable)
Parameters

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

(Hérité de _QueryTable)
Parent

Renvoie l’objet parent pour l’objet spécifié. En lecture seule.

(Hérité de _QueryTable)
PostText

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

(Hérité de _QueryTable)
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 False. Boolean (en lecture/écriture).

(Hérité de _QueryTable)
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 à de nouvelles lignes de données dans la table de requête. La mise en forme n'est pas appliquée aux cellules inutilisées. 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 (sauf si la table de requêtes a été créée dans Microsoft Excel 97 et que la propriété a la HasAutoFormat valeur True, auquel cas PreserveFormatting a la valeur False). Boolean (en lecture/écriture).

(Hérité de _QueryTable)
QueryType

Indique le type de requête utilisé par Microsoft Excel pour remplir la table de requête ou le cache de tableau croisé dynamique. En lecture seule XlQueryType.

(Hérité de _QueryTable)
Recordset

Renvoie ou définit un objet Recordset utilisé comme source de données pour la table de requête ou le cache de tableau croisé dynamique spécifié. Lecture-écriture.

(Hérité de _QueryTable)
Refreshing

True si une requête en arrière-plan est en cours pour la table de requête spécifiée. Boolean (en lecture/écriture).

(Hérité de _QueryTable)
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).

(Hérité de _QueryTable)
RefreshPeriod

Renvoie ou définit le nombre de minutes entre deux actualisations. Entier en lecture/écriture.

(Hérité de _QueryTable)
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.

(Hérité de _QueryTable)
ResultRange

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

(Hérité de _QueryTable)
RobustConnect

Cette propriété renvoie ou définit comment le cache d'un tableau croisé dynamique se connecte à sa source de données. En lecture/écriture XlRobustConnect.

(Hérité de _QueryTable)
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).

(Hérité de _QueryTable)
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).

(Hérité de _QueryTable)
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).

(Hérité de _QueryTable)
Sort

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

(Hérité de _QueryTable)
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 tableau croisé dynamique. Lecture-écriture.

(Hérité de _QueryTable)
SourceDataFile

Renvoie ou définit une valeur de type String indiquant le fichier de données source d’une table de requête.

(Hérité de _QueryTable)
Sql

Réservé à une utilisation interne.

(Hérité de _QueryTable)
TablesOnlyFromHTML

Cette méthode crée une table de données à partir des valeurs d'entrée et des formules que vous définissez dans une feuille de calcul.

(Hérité de _QueryTable)
TextFileColumnDataTypes

Renvoie ou définit un tableau ordonné de constantes qui spécifient les types de données appliqués aux colonnes correspondantes dans le fichier texte que vous importez dans une table de requête. La constante par défaut de chaque colonne est xlGeneral. Objet en lecture/écriture.

(Hérité de _QueryTable)
TextFileCommaDelimiter

True si la virgule est le délimiteur 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).

(Hérité de _QueryTable)
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).

(Hérité de _QueryTable)
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.

(Hérité de _QueryTable)
TextFileFixedColumnWidths

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

(Hérité de _QueryTable)
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.

(Hérité de _QueryTable)
TextFileParseType

Renvoie ou définit le format de colonne pour les données contenues dans le fichier texte que vous importez dans une table de requête. En lecture/écriture XlTextParsingType.

(Hérité de _QueryTable)
TextFilePlatform

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. La valeur par défaut correspond au paramètre utilisé dans l'option Origine du fichier de l'Assistant Importation de texte. En lecture/écriture XlPlatform.

(Hérité de _QueryTable)
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).

(Hérité de _QueryTable)
TextFileSemicolonDelimiter

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

(Hérité de _QueryTable)
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).

(Hérité de _QueryTable)
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 entiers compris entre 1 et 32 767. La valeur par défaut est 1. Entier en lecture/écriture.

(Hérité de _QueryTable)
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).

(Hérité de _QueryTable)
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.

(Hérité de _QueryTable)
TextFileThousandsSeparator

Renvoie ou définit le caractère séparateur de 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.

(Hérité de _QueryTable)
TextFileTrailingMinusNumbers

True pour que Microsoft Excel traite les nombres importés comme du texte commençant par un symbole « - » comme un nombre négatif. Cette propriété a la valeur False pour qu'Excel traite les nombres importés et commençant par un symbole « - » en tant que texte. Boolean (en lecture/écriture).

(Hérité de _QueryTable)
TextFileVisualLayout

Renvoie ou définit une XlTextVisualLayoutType constante qui indique si la disposition visuelle du texte importé est de gauche à droite ou de droite à gauche.

(Hérité de _QueryTable)
WebConsecutiveDelimitersAsOne

True si les délimiteurs consécutifs sont traités comme un délimiteur unique lorsque vous importez des données à partir de balises HTML <PRE> dans 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).

(Hérité de _QueryTable)
WebDisableDateRecognition

Cette propriété a la valeur 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).

(Hérité de _QueryTable)
WebDisableRedirections

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

(Hérité de _QueryTable)
WebFormatting

Renvoie ou définit une valeur qui détermine le niveau de mise en forme appliqué à une page Web, le cas échéant, lorsque vous importez la page dans une table de requête. En lecture/écriture XlWebFormatting.

(Hérité de _QueryTable)
WebPreFormattedTextToColumns

Renvoie ou définit si les données contenues dans les balises HTML <PRE> 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).

(Hérité de _QueryTable)
WebSelectionType

Renvoie ou définit une valeur qui détermine si une page Web entière, tous les tableaux ou uniquement certains tableaux contenus de la page, sont importés dans une table de requête. En lecture/écriture XlWebSelectionType.

(Hérité de _QueryTable)
WebSingleBlockTextImport

Cette propriété a la valeur True si les données des balises HTML <PRE> de la page Web spécifiée sont traitées en même temps 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 afin que les lignes d’en-tête soient reconnues comme telles. La valeur par défaut est False. Boolean (en lecture/écriture).

(Hérité de _QueryTable)
WebTables

Cette propriété renvoie ou définit une liste, délimitée par des virgules, de noms de table ou de numéros d'index de table lors de l'importation d'une page Web dans une table de requête. String en lecture/écriture.

(Hérité de _QueryTable)
WorkbookConnection

Retourne l’objet WorkbookConnection utilisé par la table de requête. En lecture seule.

(Hérité de _QueryTable)

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 Refreshing propriété pour déterminer si une requête en arrière-plan est en cours.

(Hérité de _QueryTable)
Delete()

Supprime l'objet.

(Hérité de _QueryTable)
Refresh(Object)

Mises à jour une plage de données externe (QueryTable). Boolean.

(Hérité de _QueryTable)
ResetTimer()

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

(Hérité de _QueryTable)
SaveAsODC(String, Object, Object)

Enregistre la source du cache de tableau croisé dynamique en tant que fichier de connexion de données Microsoft Office.

(Hérité de _QueryTable)

Événements

AfterRefresh

Cet événement se produit après l'exécution ou l'annulation d'une requête.

(Hérité de RefreshEvents_Event)
BeforeRefresh

Cet événement se produit avant toute actualisation de la table de requêtes. Ceci comprend les actualisations résultant de l'appel de la méthode Refresh, celles dues aux actions de l'utilisateur dans le produit et celles dues à l'ouverture du classeur contenant la table de requêtes.

(Hérité de RefreshEvents_Event)

S’applique à