Méthode Worksheet.PivotTableWizard (Excel)

Article
04/07/2023

Cette méthode crée un rapport de tableau croisé dynamique. Cette méthode n’affiche pas l’Assistant Tableau croisé dynamique. Cette méthode n’est pas disponible pour les sources de données OLE DB. Utilisez la méthode Add pour ajouter un cache de tableau croisé dynamique, puis créez un rapport de tableau croisé dynamique basé sur le cache.

Syntaxe

expression. PivotTableWizard (SourceType, SourceData, TableDestination, TableName, RowGrand, ColumnGrand, SaveData, HasAutoFormat, AutoPage, Reserved, BackgroundQuery, OptimizeCache, PageFieldOrder, PageFieldWrapCount, ReadData, Connection)

expression Variable qui représente un objet Feuille de calcul.

Parameters

Nom	Requis/Facultatif	Type de données	Description
SourceType	Facultatif	Variant	Valeur XlPivotTableSourceType qui représente la source des données du rapport. Si vous spécifiez cet argument, vous devez également spécifier SourceData. Si SourceType et SourceData sont omis, Microsoft Excel suppose que le type de source est xlDatabase et que les données sources proviennent de la plage nommée Database. Si cette plage nommée n’existe pas, Excel utilise la région actuelle si la sélection actuelle se trouve dans une plage de plus de 10 cellules contenant des données. Si ce n’est pas le cas, cette méthode échoue.
SourceData	Facultatif	Variant	Données du nouveau rapport. Il peut s’agir d’un objet Range , d’un tableau de plages ou d’une constante de texte qui représente le nom d’un autre rapport. Pour une base de données externe, DonnéesSources est un tableau de chaînes contenant la chaîne de requête SQL (Structured Query Language), dans laquelle la longueur maximale de chaque élément est de 255 caractères. Utilisez l'argument Connexion pour spécifier la chaîne de connexion ODBC. Afin d'assurer la compatibilité avec les versions antérieures de Excel, DonnéesSources peut être un tableau à deux éléments. Le premier élément est la chaîne de connexion spécifiant la source ODBC des données. Le second élément est la chaîne de requête SQL utilisée pour obtenir les données. Si vous spécifiez DonnéesSources, vous devez également spécifier TypeSource. Si la cellule active se trouve à l'intérieur de la plage DonnéesSources, vous devez aussi spécifier DestinationTableau.
TableDestination	Facultatif	Variant	Objet Range spécifiant où le rapport doit être placé dans la feuille de calcul. Si cet argument est omis, le rapport est placé dans la cellule active.
TableName	Facultatif	Variant	Chaîne qui indique le nom du nouveau rapport.
RowGrand	Facultatif	Variant	True pour afficher les totaux généraux des lignes du rapport.
ColumnGrand	Facultatif	Variant	True pour afficher les totaux généraux des colonnes du rapport.
SaveData	Facultatif	Variant	True pour enregistrer les données avec le rapport. False pour enregistrer uniquement la définition du rapport.
HasAutoFormat	Facultatif	Variant	True pour qu’Excel formate automatiquement le rapport lorsqu’il est actualisé ou lorsque les champs sont déplacés.
Page automatique	Facultatif	Variant	Valide uniquement si TypeSource a la valeur xlConsolidation. True pour qu’Excel crée un champ de page pour la consolidation. Si PageAuto a la valeur False, vous devez créer le ou les champs de page.
Reserved	Facultatif	Variant	Non utilisé par Excel.
BackgroundQuery	Facultatif	Variant	True pour qu'Excel exécute des requêtes de manière asynchrone (en arrière-plan) pour le rapport. La valeur par défaut est False.
OptimizeCache	Facultatif	Variant	True pour optimiser le cache de tableau croisé dynamique lors de sa création. La valeur par défaut est False.
PageFieldOrder	Facultatif	Variant	Ordre dans lequel les champs de page sont ajoutés à la disposition du rapport de tableau croisé dynamique. Il peut s’agir de l’une des constantes XlOrder suivantes : xlDownThenOver (par défaut) ou xlOverThenDown.
PageFieldWrapCount	Facultatif	Variant	Nombre de champs de page contenus dans chaque colonne ou ligne du rapport de tableau croisé dynamique. La valeur par défaut est 0 (zéro).
ReadData	Facultatif	Variant	True pour créer un cache de tableau croisé dynamique contenant tous les enregistrements issus de la base de données externe ; ce cache peut être très volumineux. Si ReadData a la valeur False, vous pouvez définir certains champs en tant que champs de page basés sur le serveur avant que les données ne sont réellement lues.
Connection	Facultatif	Variant	Chaîne qui contient les paramètres ODBC permettant à Excel de se connecter à une source de données ODBC. La chaîne de connexion a la forme `ODBC;<connection string>`. Cet argument remplace tout paramètre précédent pour la propriété Connection de l’objet PivotCache.

Valeur renvoyée

Objet PivotTable qui représente le nouveau rapport de tableau croisé dynamique.

Exemple

Cet exemple crée un rapport de tableau croisé dynamique à partir d’une base de données Excel (contenue dans la plage A1:C100).

ActiveSheet.PivotTableWizard xlDatabase, Range("A1:C100")

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.