Chart.Name-Eigenschaft

Artikel
08/10/2011

Ruft den Namen des Chart-Steuerelements ab.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Syntax

'Declaration
ReadOnly Property Name As String
    Get

string Name { get; }

Eigenschaftswert

Typ: System.String
Der Name des Chart-Steuerelements.

Hinweise

Wenn Sie ein Chart-Steuerelement erstellen, legt Excel die Name-Eigenschaft auf die Zeichenfolge "Arbeitsblattname-Diagramm n" fest, wobei n die Anzahl von eingebetteten Tabellen im Arbeitsblatt ist. Wenn Sie z. B. Blatt1 einen Chart hinzufügen und es ist das zuerst eingebettete Diagramm im Arbeitsblatt, verfügt die Name-Eigenschaft über den Wert Blatt1 Diagramm1.

Obwohl die Name-Eigenschaft schreibgeschützt ist, können Sie mit der Name-Eigenschaft des übergeordneten Microsoft.Office.Interop.Excel.ChartObject-Objekts einen Teil des Namens ändern. Der angegebene neue Name ersetzt die Teilzeichenfolge "Diagramm n" in der von der Name-Eigenschaft zurückgegebenen Zeichenfolge. Der folgende Code ändert z. B. den Name-Eigenschaftswert eines Chart-Steuerelements von Sheet1 Chart 1 in Sheet1 SalesChart.

Private Sub RenameChart()
    ' Set some test data and create a new Chart.
    Globals.Sheet1.Range("A1", "A5").Value2 = 22
    Globals.Sheet1.Range("B1", "B5").Value2 = 55

    Dim Chart1 As Microsoft.Office.Tools.Excel.Chart = _
        Globals.Sheet1.Controls.AddChart(Globals.Sheet1.Range("D2", "H12"), _
        "renameChartExample")
    Chart1.SetSourceData(Me.Range("A1", "B5"), Excel.XlRowCol.xlColumns)
    Chart1.ChartType = Excel.XlChartType.xl3DColumn

    ' Displays "Sheet1 Chart 1".
    MessageBox.Show("The default chart name is: " & Chart1.Name)

    ' Set the name of the parent ChartObject of this embedded Chart.
    Dim ChartObjectParent As Excel.ChartObject = TryCast(Chart1.Parent, Excel.ChartObject)
    ChartObjectParent.Name = "SalesChart"

    ' Displays "Sheet1 SalesChart".
    MessageBox.Show("The default chart name is: " & Chart1.Name)
End Sub

private void RenameChart()
{
    // Set some test data and create a new Chart.
    Globals.Sheet1.Range["A1", "A5"].Value2 = 22;
    Globals.Sheet1.Range["B1", "B5"].Value2 = 55;

    Microsoft.Office.Tools.Excel.Chart chart1 = Globals.Sheet1.Controls.AddChart(
        Globals.Sheet1.Range["D2", "H12"], "renameChartExample");
    chart1.SetSourceData(Globals.Sheet1.Range["A1", "B5"], Excel.XlRowCol.xlColumns);
    chart1.ChartType = Excel.XlChartType.xl3DColumn;

    // This message box displays "Sheet1 Chart 1".
    MessageBox.Show("The default chart name is: " + chart1.Name);

    // Set the name of the parent ChartObject of this embedded Chart.
    Excel.ChartObject chartObjectParent = chart1.Parent as Excel.ChartObject;
    chartObjectParent.Name = "SalesChart";

    // This message box displays "Sheet1 SalesChart".
    MessageBox.Show("The new chart name is: " + chart1.Name);
}

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

Chart Schnittstelle

Microsoft.Office.Tools.Excel-Namespace

Freigeben über