共用方式為

Chart.Name 屬性

  • 發行項

取得 Chart 控制項的名稱。

命名空間：  Microsoft.Office.Tools.Excel
組件：  Microsoft.Office.Tools.Excel (在 Microsoft.Office.Tools.Excel.dll 中)

語法

'宣告
ReadOnly Property Name As String

string Name { get; }

屬性值

型別：System.String
Chart 控制項的名稱。

備註

當您建立 Chart 控制項時，Excel 會將 Name 屬性設為字串 "sheetname Chart n"，其中 n 是工作表上內嵌圖表的數目。例如，如果您將 ChartSheet1 加入，而且它是工作表上的第一個內嵌圖表，Name 屬性就會具有 Sheet1 Chart1 的值。

雖然 Name 屬性是唯讀的，您還是可以使用父代 Microsoft.Office.Interop.Excel.ChartObject 的 Name 屬性來修改名稱的一部分。您指定新名稱會取代由在 Name 屬性所傳回之字串中的 "Chart n" 子字串。例如，下列程式碼會將 Chart 控制項的 Name 屬性值，從 Sheet1 Chart 1 變更為 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 安全性

請參閱

參考

Chart 介面

Microsoft.Office.Tools.Excel 命名空間