Condividi tramite

Metodo WorksheetBase.PivotTableWizard

  • Articolo

Crea un oggetto Microsoft.Office.Interop.Excel.PivotTable.

Spazio dei nomi:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel.v4.0.Utilities (in Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Sintassi

'Dichiarazione
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
)

Parametri

  • sourceData
    Tipo: System.Object
    Dati per il nuovo rapporto.Può essere un oggetto Range, una matrice di intervalli oppure una costante di testo che rappresenta il nome di un altro rapporto.Per un database esterno l'argomento SourceData è una matrice di stringhe che contiene la stringa di query SQL, in cui ciascun elemento è caratterizzato da una lunghezza massima pari a 255 caratteri.Utilizzare l'argomento Connection per specificare la stringa di connessione ODBC.Per garantire la compatibilità con le versioni precedenti di Excel, l'argomento SourceData può essere una matrice a due elementi.Il primo elemento è la stringa di connessione che specifica l'origine ODBC per i dati.Il secondo elemento è la stringa di query SQL utilizzata per ottenere i dati.Se si specifica l'argomento SourceData, sarà necessario specificare anche l'argomento SourceType.Se la cella attiva si trova all'interno dell'intervallo SourceData, sarà necessario specificare anche l'argomento TableDestination.
  • tableDestination
    Tipo: System.Object
    Oggetto Range che specifica il punto in cui inserire il rapporto nel foglio di lavoro.Se si omette questo argomento, il rapporto verrà inserito in corrispondenza della cella attiva.
  • rowGrand
    Tipo: System.Object
    true per visualizzare i totali generali per le righe del rapporto.
  • columnGrand
    Tipo: System.Object
    true per visualizzare i totali generali per le colonne del rapporto.
  • saveData
    Tipo: System.Object
    true per salvare i dati con il rapporto; false per salvare solo la definizione del rapporto.
  • hasAutoFormat
    Tipo: System.Object
    true per formattare automaticamente il rapporto quando questo viene aggiornato o quando vengono spostati dei campi.
  • autoPage
    Tipo: System.Object
    Valido solo se SourceType è xlConsolidation.true per creare automaticamente un campo pagina per il consolidamento.Se l'argomento AutoPage è false, è necessario creare il campo o i campi pagina.
  • backgroundQuery
    Tipo: System.Object
    true per eseguire le query per il rapporto in modo asincrono (in background).Il valore predefinito è false.
  • optimizeCache
    Tipo: System.Object
    true per ottimizzare la cache di tabella pivot quando viene creata.Il valore predefinito è false.
  • pageFieldWrapCount
    Tipo: System.Object
    Numero di campi pagina in ciascuna colonna o riga del rapporto di tabella pivot.Il valore predefinito è 0 (zero).
  • readData
    Tipo: System.Object
    true per creare una cache di tabella pivot che contiene tutti i record dal database esterno; questa cache può essere molto estesa.Se il valore dell'argomento ReadData è false, è possibile impostare alcuni dei campi come campi pagina basati su server prima della lettura effettiva dei dati.
  • connection
    Tipo: System.Object
    Stringa contenente impostazioni ODBC che consentono la connessione di Excel a un'origine dati ODBC.Il formato della stringa di connessione è: "ODBC;<stringa connessione>".Questo argomento esegue l'override di qualsiasi impostazione precedente della proprietà Connection dell'oggetto PivotCache.

Valore restituito

Tipo: Microsoft.Office.Interop.Excel.PivotTable
Oggetto Microsoft.Office.Interop.Excel.PivotTable.

Note

Questo metodo non visualizza la Creazione guidata Tabella pivot e non è disponibile per le origini dati DB OLE. Utilizzare il metodo Add per aggiungere una cache di tabella pivot e creare un rapporto di tabella pivot basato sulla cache.

Parametri facoltativi

Per informazioni sui parametri facoltativi, vedere Parametri facoltativi nelle soluzioni Office.

Esempi

Nell'esempio di codice riportato di seguito viene utilizzato il metodo PivotTableWizard per creare un rapporto di tabella pivot basato sul contenuto dell'intervallo di celle compreso tra A1 e C4 del foglio di lavoro corrente.

Questo esempio è valido per una personalizzazione a livello di documento.

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", missing].Value2 = "Date";
    this.Range["A2", missing].Value2 = "March 1";
    this.Range["A3", missing].Value2 = "March 8";
    this.Range["A4", missing].Value2 = "March 15";

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

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

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

Sicurezza di .NET Framework

Vedere anche

Riferimenti

WorksheetBase Classe

Spazio dei nomi Microsoft.Office.Tools.Excel