Menambahkan kontrol NamedRange ke lembar kerja

Anda bisa menambahkan NamedRange kontrol ke lembar kerja Microsoft Office Excel pada waktu desain dan pada waktu proses dalam proyek tingkat dokumen.

Berlaku untuk: Informasi dalam topik ini berlaku untuk proyek tingkat dokumen dan proyek Add-in VSTO untuk Excel. Untuk informasi selengkapnya, lihat Fitur yang tersedia berdasarkan aplikasi Office likasi dan jenis proyek.

Anda juga dapat menambahkan NamedRange kontrol pada waktu proses di proyek Add-in VSTO.

Topik ini menjelaskan tugas-tugas berikut:

• Menambahkan kontrol NamedRange pada waktu desain

• Menambahkan kontrol NamedRange pada waktu proses dalam proyek tingkat dokumen

• Menambahkan kontrol NamedRange pada waktu proses dalam proyek Add-in VSTO

  Untuk informasi selengkapnya tentang NamedRange kontrol, lihat Kontrol namedRange.

Menambahkan kontrol NamedRange pada waktu desain

Ada beberapa cara untuk menambahkan NamedRange kontrol ke lembar kerja dalam proyek tingkat dokumen pada waktu desain: dari dalam Excel, dari Kotak Alat Visual Studio, dan dari jendela Sumber Data.

Catatan

Komputer Anda mungkin memperlihatkan nama atau lokasi yang berbeda untuk beberapa elemen antarmuka pengguna Visual Studio dalam petunjuk berikut. Edisi Visual Studio yang Anda miliki dan setelan yang Anda gunakan menentukan elemen-elemen ini. Untuk informasi selengkapnya, lihat Mempersonalisasi IDE.

Untuk menambahkan kontrol NamedRange ke lembar kerja menggunakan Kotak Nama di Excel

1. Pilih sel atau sel yang ingin Anda sertakan dalam rentang bernama.

2. Di Kotak Nama, ketik nama untuk rentang dan tekan Enter.

   Kotak Nama terletak di samping bilah rumus, tepat di atas kolom A lembar kerja.

Untuk menambahkan kontrol NamedRange ke lembar kerja menggunakan Kotak Alat

1. Buka Kotak Alat dan klik tab Kontrol Excel.

2. Klik NamedRange dan seret ke lembar kerja.

   Kotak dialog Tambahkan Rentang Bernama muncul.

3. Pilih sel atau sel yang ingin Anda sertakan dalam rentang bernama.

4. Klik OK.

   Jika Anda tidak ingin nama default yang diberikan ke kontrol, Anda bisa mengubah nama di jendela Properti .

Untuk menambahkan kontrol NamedRange ke lembar kerja menggunakan jendela Sumber Data

1. Buka jendela Sumber Data dan buat sumber data untuk proyek Anda. Untuk informasi selengkapnya, lihat Tambahkan pengguna baru.

2. Seret satu bidang dari jendela Sumber Data ke lembar kerja Anda.

   Kontrol terikat NamedRange data ditambahkan ke lembar kerja. Untuk informasi selengkapnya, lihat Pengikatan dan Formulir Windows data.

Menambahkan kontrol NamedRange pada waktu proses dalam proyek tingkat dokumen

Anda bisa menambahkan NamedRange kontrol secara terprogram ke lembar kerja Anda pada waktu proses. Ini memungkinkan Anda membuat kontrol host sebagai respons terhadap peristiwa. Rentang bernama yang dibuat secara dinamis tidak disimpan dalam lembar kerja sebagai kontrol host saat lembar kerja ditutup. Untuk informasi selengkapnya, lihat Menambahkan kontrol ke dokumen Office pada waktu proses.

Untuk menambahkan kontrol NamedRange ke lembar kerja secara terprogram

1. Di penanganan Startup Sheet1aktivitas , sisipkan kode berikut untuk menambahkan NamedRange kontrol ke sel A1 dan atur propertinya Value2 ke Hello world!

   C#

   Microsoft.Office.Tools.Excel.NamedRange textInCell;
   textInCell = this.Controls.AddNamedRange(this.get_Range("A1"), "cellText");
   
   textInCell.Value2 = "Hello world!";
   

   VB

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

Menambahkan kontrol NamedRange pada waktu proses dalam proyek Add-in VSTO

Anda dapat menambahkan NamedRange kontrol secara terprogram ke lembar kerja yang terbuka dalam proyek Add-in VSTO. Rentang bernama yang dibuat secara dinamis tidak disimpan dalam lembar kerja sebagai kontrol host saat lembar kerja ditutup. Untuk informasi selengkapnya, lihat Memperluas dokumen Word dan buku kerja Excel di Add-in VSTO pada waktu proses.

Untuk menambahkan kontrol NamedRange ke lembar kerja secara terprogram

1. Kode berikut menghasilkan item host lembar kerja yang didasarkan pada lembar kerja yang terbuka, lalu menambahkan NamedRange kontrol ke sel A1 dan mengatur propertinya Value2 ke Hello world.

   C#

   private void AddNamedRange()
   {
       Microsoft.Office.Tools.Excel.NamedRange textInCell;
   
       Worksheet worksheet = Globals.Factory.GetVstoObject(
           Globals.ThisAddIn.Application.ActiveWorkbook.Worksheets[1]);
   
   
       Excel.Range cell = worksheet.Range["A1"]; 
       textInCell = worksheet.Controls.AddNamedRange(cell, "MyNamedRange");
       textInCell.Value2 = "Hello World";
    }
   

   VB

   Private Sub AddNamedRange()
       Dim textInCell As Microsoft.Office.Tools.Excel.NamedRange
   
       Dim NativeWorksheet As Microsoft.Office.Interop.Excel.Worksheet =
           Globals.ThisAddIn.Application.ActiveWorkbook.Worksheets(1)
   
       Dim worksheet As Microsoft.Office.Tools.Excel.Worksheet =
           Globals.Factory.GetVstoObject(NativeWorksheet)
   
       Dim cell As Excel.Range = worksheet.Range("A1")
       textInCell = worksheet.Controls.AddNamedRange(cell, "MyNamedRange")
       textInCell.Value2 = "Hello World"
   End Sub
   

Konten terkait

• Memperluas dokumen Word dan buku kerja Excel di Add-in VSTO pada waktu proses
• Kontrol pada dokumen Office
• Kontrol NamedRange
• Mengotomatiskan Excel dengan menggunakan objek yang diperluas
• Gambaran umum item host dan kontrol host
• Cara: Mengubah ukuran kontrol NamedRange
• Batasan terprogram item host dan kontrol host