WorksheetBase.PivotTableWizard Méthode

Référence

Définition

Espace de noms:: Microsoft.Office.Tools.Excel

Assembly:: Microsoft.Office.Tools.Excel.v4.0.Utilities.dll

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.

Crée un objet PivotTable.

public Microsoft.Office.Interop.Excel.PivotTable PivotTableWizard (object sourceType, object sourceData, object tableDestination, object tableName, object rowGrand, object columnGrand, object saveData, object hasAutoFormat, object autoPage, object reserved, object backgroundQuery, object optimizeCache, object pageFieldOrder, object pageFieldWrapCount, object readData, object connection);

member this.PivotTableWizard : obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj -> Microsoft.Office.Interop.Excel.PivotTable

Public Function PivotTableWizard (Optional sourceType As Object, Optional sourceData As Object, Optional tableDestination As Object, Optional tableName As Object, Optional rowGrand As Object, Optional columnGrand As Object, Optional saveData As Object, Optional hasAutoFormat As Object, Optional autoPage As Object, Optional reserved As Object, Optional backgroundQuery As Object, Optional optimizeCache As Object, Optional pageFieldOrder As Object, Optional pageFieldWrapCount As Object, Optional readData As Object, Optional connection As Object) As PivotTable

Paramètres

sourceType: Object

Valeur XlPivotTableSourceType. Source des données du rapport.

sourceData: Object

Données du nouveau rapport. Peut être un objet Range, un tableau de plages ou une constante de texte qui représente le nom d'un autre rapport. Pour une base de données externe, SourceData est un tableau de chaînes contenant la chaîne de requête SQL, où chaque élément contient jusqu’à 255 caractères. Vous devez utiliser l’argument Connection pour spécifier le chaîne de connexion ODBC. Pour la compatibilité avec les versions antérieures d’Excel, SourceData il peut s’agir d’un tableau à deux éléments. Le premier élément est la chaîne de connexion spécifiant la source ODBC pour les données. Le deuxième élément est la chaîne de requête SQL utilisée pour obtenir les données. Si vous spécifiez SourceData, vous devez aussi spécifier SourceType. Si la cellule active se trouve à l’intérieur de la SourceData plage, vous devez également spécifier TableDestination .

tableDestination: Object

Objet Range qui spécifie l'endroit où le rapport doit être placé sur la feuille de calcul. Si cet argument est omis, le rapport est placé au niveau de la cellule active.

tableName: Object

Nom du nouveau rapport.

rowGrand: Object

true pour afficher des totaux globaux pour les lignes du rapport.

columnGrand: Object

true pour afficher des totaux globaux pour les colonnes du rapport.

saveData: Object

true pour enregistrer les données avec le rapport ; false pour enregistrer uniquement la définition de rapport.

hasAutoFormat: Object

true pour que Microsoft Office Excel mette en forme automatiquement le rapport lorsqu'il est actualisé ou lorsque des champs sont déplacés.

autoPage: Object

Valide uniquement si SourceType est xlConsolidation. true pour qu'Excel crée un champ de page pour la consolidation. Si AutoPage est false, vous devez créer le ou les champs de page.

reserved: Object

Non utilisé par Excel.

backgroundQuery: Object

true pour qu'Excel exécute des requêtes de façon asynchrone (en arrière-plan) pour le rapport. La valeur par défaut est false.

optimizeCache: Object

true pour optimiser le cache PivotTable lorsqu'il est construit. La valeur par défaut est false.

pageFieldOrder: Object

Ordre dans lequel les champs de page sont ajoutés à la disposition du rapport PivotTable. Il peut s'agir de l'une des constantes XlOrder suivantes : xlDownThenOver ou xlOverThenDown. La valeur par défaut est xlDownThenOver.

pageFieldWrapCount: Object

Nombre de champs de page dans chaque colonne ou ligne dans le rapport PivotTable. La valeur par défaut est 0 (zéro).

readData: Object

true pour créer un cache PivotTable qui contient tous les enregistrements de la base de données externe ; ce cache peut être très grand. Si ReadData a la valeur false, vous pouvez définir certains des champs en tant que champs de page basés sur le serveur avant que les données ne sont réellement lues.

connection: Object

Chaîne qui contient les paramètres ODBC qui permettent à Excel de se connecter à une source de données ODBC. La chaîne de connexion est au format « ODBC;<chaîne_de_connexion>». Cet argument se substitue à tout paramètre antérieur pour la propriété PivotCache de l'objet Connection.

Retours

PivotTable

Objet PivotTable.

Exemples

L’exemple de code suivant utilise la PivotTableWizard méthode pour créer un rapport de tableau croisé dynamique basé sur le contenu de la plage de cellules de A1 à C4 de la feuille de calcul active.

Cet exemple concerne une personnalisation au niveau du document.

private void CreatePivotTable()
{  
    this.Range["A1"].Value2 = "Date";
    this.Range["A2"].Value2 = "March 1";
    this.Range["A3"].Value2 = "March 8";
    this.Range["A4"].Value2 = "March 15";

    this.Range["B1"].Value2 = "Customer";
    this.Range["B2"].Value2 = "Smith";
    this.Range["B3"].Value2 = "Jones";
    this.Range["B4"].Value2 = "James";

    this.Range["C1"].Value2 = "Sales";
    this.Range["C2"].Value2 = "23";
    this.Range["C3"].Value2 = "17";
    this.Range["C4"].Value2 = "39";

    Excel.PivotTable table1 = this.PivotTableWizard(
        Excel.XlPivotTableSourceType.xlDatabase, this.Range["A1", "C4"],
        "PivotTable1", false, false, true, false, false, false, Excel.XlOrder.xlDownThenOver);
}

Private Sub CreatePivotTable()
    Me.Range("A1").Value2 = "Date"
    Me.Range("A2").Value2 = "March 1"
    Me.Range("A3").Value2 = "March 8"
    Me.Range("A4").Value2 = "March 15"

    Me.Range("B1").Value2 = "Customer"
    Me.Range("B2").Value2 = "Smith"
    Me.Range("B3").Value2 = "Jones"
    Me.Range("B4").Value2 = "James"

    Me.Range("C1").Value2 = "Sales"
    Me.Range("C2").Value2 = "23"
    Me.Range("C3").Value2 = "17"
    Me.Range("C4").Value2 = "39"

    Dim table1 As Excel.PivotTable = _
        Me.PivotTableWizard(Excel.XlPivotTableSourceType.xlDatabase, _
            Me.Range("A1", "C4"), TableName:="PivotTable1", RowGrand:=False, _
            ColumnGrand:=False, SaveData:=True, HasAutoFormat:=False, _
            PageFieldOrder:=Excel.XlOrder.xlDownThenOver)
End Sub

Remarques

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 Microsoft.Office.Interop.Excel.Worksheets.Add* méthode pour ajouter un cache de tableau croisé dynamique, puis créez un rapport de tableau croisé dynamique basé sur le cache.

Paramètres facultatifs

Pour plus d’informations sur les paramètres facultatifs, consultez Paramètres facultatifs dans les solutions Office.

S’applique à