Partager via

WorksheetBase.PivotTableWizard, méthode

  • Article

Crée un objet Microsoft.Office.Interop.Excel.PivotTable.

Espace de noms :  Microsoft.Office.Tools.Excel
Assembly :  Microsoft.Office.Tools.Excel.v4.0.Utilities (dans Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Syntaxe

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

public 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
)

Paramètres

  • sourceData
    Type : System.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 la chaîne de connexion ODBC.Pour des raisons de compatibilité avec les versions antérieures d'Excel, SourceData peut être 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 également spécifier SourceType.Si la cellule active est à l'intérieur de la plage SourceData, vous devez également spécifier TableDestination.
  • tableDestination
    Type : System.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.
  • rowGrand
    Type : System.Object
    true pour afficher des totaux globaux pour les lignes du rapport.
  • columnGrand
    Type : System.Object
    true pour afficher des totaux globaux pour les colonnes du rapport.
  • saveData
    Type : System.Object
    true pour enregistrer les données avec le rapport ; false pour enregistrer uniquement la définition de rapport.
  • hasAutoFormat
    Type : System.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
    Type : System.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.
  • backgroundQuery
    Type : System.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
    Type : System.Object
    true pour optimiser le cache PivotTable lorsqu'il est construit.La valeur par défaut est false.
  • pageFieldWrapCount
    Type : System.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
    Type : System.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 est false, vous pouvez définir certains champs comme des champs de page serveur pour que les données puissent être réellement lues.
  • connection
    Type : System.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 a la forme "ODBC;<chaîne de connexion>".Cet argument se substitue à tout paramètre antérieur pour la propriété Connection de l'objet PivotCache.

Valeur de retour

Type : Microsoft.Office.Interop.Excel.PivotTable
Objet Microsoft.Office.Interop.Excel.PivotTable.

Notes

Cette méthode n'affiche pas l'Assistant PivotTable. Cette méthode est non disponible pour les sources de données OLE DB. Utilisez la méthode Add pour ajouter un cache PivotTable, puis créez un rapport PivotTable selon le cache.

Paramètres optionnels

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

Exemples

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

Cet exemple illustre une personnalisation au niveau du document.

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

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);
}

Sécurité .NET Framework

Voir aussi

Référence

WorksheetBase Classe

Microsoft.Office.Tools.Excel, espace de noms