WorksheetBase.PivotTableWizard Metodo

Riferimento

Definizione

Spazio dei nomi:: Microsoft.Office.Tools.Excel

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

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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

PivotTable

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

Condividi tramite