Condividi tramite


WorksheetBase.PivotTableWizard Metodo

Definizione

Crea un oggetto 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

Parametri

sourceType
Object

Valore XlPivotTableSourceType. Origine dei dati del rapporto.

sourceData
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, SourceData è una matrice di stringhe contenente la stringa di query SQL, in cui ogni elemento ha una lunghezza massima di 255 caratteri. È consigliabile utilizzare l'argomento Connection per specificare il stringa di connessione ODBC. Per la compatibilità con le versioni precedenti di Excel, 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 SourceData, è necessario specificare anche SourceType. Se la cella attiva si trova all'interno dell'intervallo SourceData , è necessario specificare TableDestination anche .

tableDestination
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.

tableName
Object

Nome del nuovo rapporto.

rowGrand
Object

true per visualizzare i totali generali per le righe del rapporto.

columnGrand
Object

true per visualizzare i totali generali per le colonne del rapporto.

saveData
Object

true per salvare i dati con il rapporto; false per salvare solo la definizione del rapporto.

hasAutoFormat
Object

true per formattare automaticamente il rapporto quando questo viene aggiornato o quando vengono spostati dei campi.

autoPage
Object

Valido solo se SourceType è xlConsolidation. true per creare automaticamente un campo pagina per il consolidamento. Se AutoPage è false, è necessario creare il campo o i campi della pagina.

reserved
Object

Non utilizzato in Excel.

backgroundQuery
Object

true per eseguire le query per il rapporto in modo asincrono (in background). Il valore predefinito è false.

optimizeCache
Object

true per ottimizzare la cache di tabella pivot quando viene creata. Il valore predefinito è false.

pageFieldOrder
Object

Ordine in cui i campi pagina vengono aggiunti al layout del rapporto di tabella pivot. Può essere una delle seguenti costanti di XlOrder: xlDownThenOver o xlOverThenDown. Il valore predefinito è xlDownThenOver.

pageFieldWrapCount
Object

Numero di campi pagina in ciascuna colonna o riga del rapporto di tabella pivot. Il valore predefinito è 0 (zero).

readData
Object

true per creare una cache di tabella pivot che contiene tutti i record dal database esterno; questa cache può essere molto estesa. Se ReadData è false, è possibile impostare alcuni campi come campi di pagina basati su server prima che i dati vengano effettivamente letti.

connection
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à PivotCache dell'oggetto Connection.

Restituisce

Oggetto PivotTable.

Esempio

Nell'esempio di codice seguente viene utilizzato il PivotTableWizard metodo per creare un rapporto di tabella pivot in base al contenuto dell'intervallo di celle da A1 a C4 del foglio di lavoro corrente.

Questo esempio è relativo a una personalizzazione a livello di documento.

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

Commenti

Questo metodo non visualizza la Creazione guidata tabella pivot. Questo metodo non è disponibile per le origini dati OLE DB. Utilizzare il Microsoft.Office.Interop.Excel.Worksheets.Add* metodo per aggiungere una cache di tabella pivot e quindi creare un rapporto di tabella pivot basato sulla cache.

Parametri facoltativi

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

Si applica a