Metoda ControlCollection.AddChart — (Range, String)
Dodaje nowy Chart formantu do arkusza, w zakresie określonym.
Przestrzeń nazw: Microsoft.Office.Tools.Excel
Zestaw: Microsoft.Office.Tools.Excel (w Microsoft.Office.Tools.Excel.dll)
Składnia
'Deklaracja
Function AddChart ( _
range As Range, _
name As String _
) As Chart
Chart AddChart(
Range range,
string name
)
Parametry
- range
Typ: Microsoft.Office.Interop.Excel.Range
A Range do celów kontroli i zapewniających granice.
- name
Typ: System.String
Nazwa formantu, który może być używane do indeksowania formantu znajdującego się w ControlCollection wystąpienie.
Wartość zwracana
Typ: Microsoft.Office.Tools.Excel.Chart
Chart Kontroli, który został dodany do ControlCollection wystąpienie.
Wyjątki
| Wyjątek | Warunek |
|---|---|
| ArgumentNullException | Argument Nazwa lub zakres jest nullodwołanie o wartości null (Nothing w języku Visual Basic), albo argumentu Nazwa ma zerową długość. |
| ControlNameAlreadyExistsException | Formant o tej samej nazwie jest już w ControlCollection wystąpienie. |
| InvalidRangeException | Określony zakres jest nieprawidłowy.Nie można użyć Multi-Area zakresów.Zakres powinien być na tym samym arkuszu co ControlCollection wystąpienie. |
Uwagi
AddChart Metoda umożliwia dodanie Chart formanty na koniec ControlCollection.Aby usunąć Chart kontroli, jakie zostały uprzednio dodane programowo, użyj Remove metody.
Przykłady
Poniższy kod wstawia numer 16 do komórek E1 przez E3 oraz numer 24 do komórek F1 przez F3.Następnie tworzony Chart formantu do komórek A1 przez C8 i przekazuje komórek E1 przez F3 do SetSourceData metoda zapełnić wykres z danymi.
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;
}
Zabezpieczenia programu .NET Framework
- Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Używanie bibliotek pochodzących z częściowo zaufanego kodu.