HOW TO：將 NamedRange 控制項加入至工作表

  • 發行項

更新： 2008 年 7 月

適用於

本主題中的資訊僅適用於指定的 Visual Studio Tools for Office 專案和 Microsoft Office 版本。

文件層級專案

  • Excel 2007

  • Excel 2003

應用程式層級專案

  • Excel 2007

如需詳細資訊，請參閱依應用程式和專案類型提供的功能。

您可以在文件層級專案中，於設計階段和執行階段將 NamedRange 控制項加入至 Microsoft Office Excel 工作表。

從 Visual Studio 2008 Service Pack 1 (SP1) 開始，您可以在應用程式層級增益集專案中，於執行階段加入 NamedRange 控制項。

本主題將說明下列工作：

  • 在設計階段加入 NamedRange 控制項

  • 在文件層級專案中，於執行階段加入 NamedRange 控制項

  • 在應用程式層級專案中，於執行階段加入 NamedRange 控制項

如需 NamedRange 控制項的詳細資訊，請參閱 NamedRange 控制項。

在設計階段加入 NamedRange 控制項

在文件層級專案中，於設計階段將 NamedRange 控制項加入至工作表的方式有下列幾種：從 Excel 中加入、從 Visual Studio [工作箱] 加入，以及從 [資料來源] 視窗加入。

注意事項：

您的電腦可能會在下列說明中，以不同名稱或位置顯示某些 Visual Studio 使用者介面項目。您所擁有的 Visual Studio 版本以及使用的設定會決定這些項目。如需詳細資訊，請參閱 Visual Studio 設定。

若要使用 Excel 中的名稱方塊將 NamedRange 控制項加入至工作表

  1. 選取您要在已命名範圍中加入的儲存格。

  2. 在 [名稱] 方塊中輸入範圍的名稱，並按 ENTER。

    [名稱] 方塊位於資料編輯列的旁邊，就在工作表欄 [A] 的上面。

若要使用工具箱將 NamedRange 控制項加入至工作表

  1. 開啟 [工具箱]，然後按一下 [Excel 控制項] 索引標籤。

  2. 按一下 NamedRange，並將其拖曳至工作表。

    [加入已命名的範圍] 對話方塊便會出現。

  3. 選取您要在已命名範圍中加入的儲存格。

  4. 按一下 [確定]。

    如果不想使用控制項的指定預設名稱，可以在 [屬性] 視窗中變更名稱。

若要使用資料來源視窗將 NamedRange 控制項加入至工作表

  1. 開啟 [資料來源] 視窗，並建立專案的資料來源。如需詳細資訊，請參閱 HOW TO：連接至資料庫中的資料。

  2. 將單一欄位從 [資料來源] 視窗拖曳至工作表。

    資料繫結 NamedRange 控制項隨即加入至工作表。如需詳細資訊，請參閱資料繫結和 Windows Form。

在文件層級專案中，於執行階段加入 NamedRange 控制項

您可以在執行階段，以程式設計的方式將 NamedRange 控制項加入至工作表。這種方法可以讓您建立主控制項，以回應事件。當工作表關閉時，動態建立的已命名範圍不會保存為工作表中的主控制項。如需詳細資訊，請參閱在執行階段將控制項加入至 Office 文件。

若要以程式設計的方式將 NamedRange 控制項加入至工作表

  • 在 Sheet1 的 Startup 事件處理常式中插入下列程式碼，以將 NamedRange 控制項加入至儲存格 [A1]，並將其 Value2 屬性設為 Hello world!

    Dim textInCell As Microsoft.Office.Tools.Excel.NamedRange
textInCell = Me.Controls.AddNamedRange(Me.Range("A1"), "cellText")

textInCell.Value2 = "Hello world!"

    Microsoft.Office.Tools.Excel.NamedRange textInCell;
textInCell = this.Controls.AddNamedRange(this.get_Range("A1", missing), "cellText");

textInCell.Value2 = "Hello world!";

在應用程式層級專案中，於執行階段加入 NamedRange 控制項

您可以在應用程式層級專案中，以程式設計的方式將 NamedRange 控制項加入至任何開啟的工作表。當工作表關閉時，動態建立的已命名範圍不會保存為工作表中的主控制項。如需詳細資訊，請參閱在應用程式層級增益集的執行階段中擴充 Word 文件和 Excel 活頁簿。

若要以程式設計的方式將 NamedRange 控制項加入至工作表

  • 下列程式碼會產生以開啟的工作表為基礎的工作表主項目，然後將 NamedRange 控制項加入至儲存格 [A1]，並將其 Value2 屬性設定為 Hello world。

    Private Sub AddNamedRange()
    Dim textInCell As Microsoft.Office.Tools.Excel.NamedRange

    Dim worksheet As Worksheet = CType(Application.ActiveWorkbook.Worksheets(1),  _
        Excel.Worksheet).GetVstoObject()
    Dim cell As Excel.Range = worksheet.Range("A1")
    textInCell = worksheet.Controls.AddNamedRange(cell, "MyNamedRange")
    textInCell.Value2 = "Hello World"
End Sub

    private void AddNamedRange()
{
    Microsoft.Office.Tools.Excel.NamedRange textInCell;

    Worksheet worksheet =
        ((Excel.Worksheet)Application.
              ActiveWorkbook.Worksheets[1]).GetVstoObject();
    Excel.Range cell = worksheet.Range["A1", missing]; 
    textInCell = worksheet.Controls.AddNamedRange(cell, "MyNamedRange");
    textInCell.Value2 = "Hello World";
 }

請參閱

工作

HOW TO：在設計階段刪除 NamedRange 控制項

HOW TO：調整 NamedRange 控制項的大小

概念

在應用程式層級增益集的執行階段中擴充 Word 文件和 Excel 活頁簿

Excel 應用程式層級增益集開發

NamedRange 控制項

主項目和主控制項概觀

主項目和主控制項的程式設計限制

其他資源

Office 文件上的控制項

Excel 主控制項

變更記錄

日期

記錄

原因

2008 年 7 月

加入新章節，說明如何在應用程式層級增益集中，將已命名範圍控制項加入至工作表。

SP1 功能變更。