ControlCollection.AddChart Yöntem (Range, String)

Makale
02/17/2014

Yeni bir ekler Chart denetimini çalışma sayfasına belirtilen aralıkta.

Ad alanı: Microsoft.Office.Tools.Excel
Derleme: Microsoft.Office.Tools.Excel (Microsoft.Office.Tools.Excel.dll içinde)

Sözdizimi

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

Chart AddChart(
    Range range,
    string name
)

Parametreler

range
Tür: Microsoft.Office.Interop.Excel.Range
A Range , sınırları için denetim sağlar.

name
Tür: System.String
Denetimde dizini oluşturmak için kullanılan denetimin adını ControlCollection örneği.

Dönüş Değeri

Tür: Microsoft.Office.Tools.Excel.Chart
Chart Eklenmiştir denetim ControlCollection örneği.

Özel Durumlar

Exception	Koşul
ArgumentNullException	Ad veya aralık bağımsız değişkeni nullnull başvuru (Visual Basic'te Nothing), veya sıfır uzunluk değişkeni vardır.
ControlNameAlreadyExistsException	Aynı ada sahip bir denetim zaten kullanılıyor ControlCollection örneği.
InvalidRangeException	Belirtilen aralık geçersiz.Multi-Area aralıkları kullanılamaz.Aralığı aynı çalışma sayfasında olması gerekir ControlCollection örneği.

Notlar

AddChart Yöntemi eklemenizi sağlar Chart denetimleri sonuna kadar ControlCollection.Kaldırmak için bir Chart önceden programlı olarak eklenen Denetim, kullanım Remove yöntem.

Örnekler

Aşağıdaki kod örnek Numara 16 hücre ekler E1 ile E3 ve hücrelere sayı 24 F1 üzerinden F3.Sonra kod oluşturur bir Chart hücreleri denetime A1 ile C8 ve hücre geçirir E1 üzerinden F3 için SetSourceData grafik verilerle doldurmak için yöntem.

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;
}

.NET Framework Güvenliği

Anında arayanlar için tam güven. Bu üye kısmen güvenilen kodla kullanılamaz. Daha fazla bilgi için bkz. Kısmen Güvenilen Koddan Kitaplıkları Kullanma.