Metodo ControlCollection.AddChart (Range, String)

Articolo
05/17/2013

Aggiunge un nuovo controllo Chart al foglio di lavoro in corrispondenza dell'intervallo specificato.

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

Sintassi

'Dichiarazione
Function AddChart ( _
    range As Range, _
    name As String _
) As Chart

Chart AddChart(
    Range range,
    string name
)

Parametri

range
Tipo: Microsoft.Office.Interop.Excel.Range
Oggetto Range che fornisce i limiti per il controllo.

name
Tipo: System.String
Nome del controllo che può essere utilizzato per indicizzare il controllo nell'istanza di ControlCollection.

Valore restituito

Tipo: Microsoft.Office.Tools.Excel.Chart
Controllo Chart aggiunto all'istanza di ControlCollection.

Eccezioni

Eccezione	Condizione
ArgumentNullException	L'argomento relativo al nome o all'intervallo è nullriferimento null (Nothing in Visual Basic) oppure la lunghezza dell'argomento relativo al nome è zero.
ControlNameAlreadyExistsException	Nell'istanza di ControlCollection è già presente un controllo con lo stesso nome.
InvalidRangeException	L'intervallo specificato non è valido.Impossibile utilizzare gli intervalli di più aree.L'intervallo deve trovarsi nello stesso foglio di lavoro dell'istanza di ControlCollection.

Note

Il metodo AddChart consente di aggiungere controlli Chart alla fine dell'oggetto ControlCollection.Per rimuovere un controllo Chart aggiunto in precedenza a livello di codice, utilizzare il metodo Remove.

Esempi

Nell'esempio di codice riportato di seguito vengono aggiunti il numero 16 nelle celle comprese tra E1 e E3 e il numero 24 nelle celle comprese tra F1 e F3.Il codice crea quindi un controllo Chart nelle celle comprese tra A1 e C8 e passa le celle comprese tra E1 e F3 al metodo SetSourceData per inserire dati nel grafico.

Private Sub ExcelAddRangeChart()
    Me.Range("E1", "E3").Value2 = 16
    Me.Range("F1", "F3").Value2 = 24

    Dim Chart1 As Microsoft.Office.Tools.Excel.Chart _
        = Me.Controls.AddChart(Me.Range("A1", "C8"), _
        "Chart1")

    Chart1.SetSourceData(Me.Range("E1", "F5"), _
        Excel.XlRowCol.xlColumns)
    Chart1.ChartType = Excel.XlChartType. _
        xlColumnClustered

End Sub

private void ExcelAddRangeChart()
{
    this.Range["E1", "E3"].Value2 = 16;
    this.Range["F1", "F3"].Value2 = 24;

    Microsoft.Office.Tools.Excel.Chart chart1 =
        this.Controls.AddChart(this.Range["A1", "C8"], "Chart1");

    chart1.SetSourceData(this.Range["E1", "F5"], Excel.XlRowCol.xlColumns);
    chart1.ChartType = Excel.XlChartType.xlColumnClustered;
}

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.