Procedura: aggiungere controlli NamedRange a fogli di lavoro

È possibile aggiungere controlli NamedRange in un foglio di lavoro di Microsoft Office Excel in fase di progettazione e in progetti a livello di documento in fase di esecuzione.

Si applica a: le informazioni fornite in questo argomento sono valide per i progetti a livello di documento e di applicazione per Excel 2007 ed Excel 2010. Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazioni di Office.

È inoltre possibile aggiungere controlli NamedRange nei progetti di componenti aggiuntivi a livello di applicazione.

In questo argomento vengono descritte le attività seguenti:

• Aggiunta di controlli NamedRage in fase di progettazione

• Aggiunta di controlli NamedRage in fase di esecuzione in un progetto a livello di documento

• Aggiunta di controlli NamedRage in fase di esecuzione in un progetto a livello di applicazione

Per ulteriori informazioni sui controlli NamedRange, vedere Controllo NamedRange.

Aggiunta di controlli NamedRage in fase di progettazione

Esistono diversi modi per aggiungere in fase di progettazione controlli NamedRange in un foglio di lavoro di un progetto a livello di documento: da Excel, dalla Casella degli strumenti di Visual Studio e dalla finestra Origini dati.

Per aggiungere un controllo NamedRange a un foglio di lavoro mediante la casella Nome di Excel

1. Selezionare la cella o le celle che si desidera includere nell'intervallo denominato.

2. Nella casella Nome, digitare un nome per l'intervallo e premere INVIO.

   La casella Nome si trova accanto alla barra della formula, sopra la colonna A del foglio di lavoro.

Per aggiungere un controllo NamedRange a un foglio di lavoro mediante la Casella degli strumenti

1. Aprire la Casella degli strumenti e selezionare la scheda Controlli Excel.

2. Fare clic su NamedRange e trascinarlo su un foglio di lavoro.

   Verrà visualizzata la finestra di dialogo Aggiungi intervallo denominato.

3. Selezionare la cella o le celle che si desidera includere nell'intervallo denominato.

4. Scegliere OK.

   Se non si desidera assegnare al controllo il nome predefinito, è possibile modificare il nome nella finestra Proprietà.

Per aggiungere un controllo NamedRange a un foglio di lavoro mediante la finestra Origini dati

1. Aprire la finestra Origini dati e creare un'origine dati per il progetto. Per ulteriori informazioni, vedere Procedura: connettersi ai dati di un database.

2. Trascinare un solo campo dalla finestra Origini dati al foglio di lavoro.

   Un controllo NamedRange associato a dati viene aggiunto al foglio di lavoro. Per ulteriori informazioni, vedere Associazione dati e Windows Form.

Aggiunta di controlli NamedRage in fase di esecuzione in un progetto a livello di documento

È possibile aggiungere a livello di codice e in fase di esecuzione un controllo NamedRange al foglio di lavoro. In questo modo, si possono creare i controlli host in risposta agli eventi. Gli oggetti NamedRange creati dinamicamente non sono mantenuti nel foglio di lavoro come controlli host quando il foglio di lavoro viene chiuso. Per ulteriori informazioni, vedere Aggiunta di controlli ai documenti di Office in fase di esecuzione.

Per aggiungere un controllo NamedRange a un foglio di lavoro a livello di codice

• Nel gestore eventi Startup di Sheet1, inserire il codice seguente per aggiungere il controllo NamedRange alla cella A1 e impostare la relativa proprietà Value2 su 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!";
  

Aggiunta di controlli NamedRage in fase di esecuzione in un progetto a livello di applicazione

È possibile aggiungere a livello di codice un controllo NamedRange a qualsiasi foglio di lavoro aperto di un progetto a livello di applicazione. Gli oggetti NamedRange creati dinamicamente non sono mantenuti nel foglio di lavoro come controlli host quando il foglio di lavoro viene chiuso. Per ulteriori informazioni, vedere Estensione in fase di esecuzione di documenti di Word e di cartelle di lavoro di Excel in componenti aggiuntivi a livello di applicazione.

Per aggiungere un controllo NamedRange a un foglio di lavoro a livello di codice

• Nel codice seguente viene generato un elemento host foglio di lavoro basato sul foglio di lavoro aperto e viene aggiunto un controllo NamedRange nella cella A1. La proprietà Value2 di questo controllo viene quindi impostata su Hello world.

  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)
  
      ' Use the following line of code in projects that target the .NET Framework 4.
      Dim worksheet As Microsoft.Office.Tools.Excel.Worksheet =
          Globals.Factory.GetVstoObject(NativeWorksheet)
  
      ' In projects that target the .NET Framework 3.5, use the following line of code.
      ' Dim worksheet = CType(Globals.ThisAddIn.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;
  
      // Use the following line of code in projects that target the .NET Framework 4.
      Worksheet worksheet = Globals.Factory.GetVstoObject(
          Globals.ThisAddIn.Application.ActiveWorkbook.Worksheets[1]);
  
      // In projects that target the .NET Framework 3.5, use the following line of code.
      // Worksheet worksheet = 
      //     ((Excel.Worksheet)Globals.ThisAddIn.Application.ActiveWorkbook.Worksheets[1]).GetVstoObject();
  
      Excel.Range cell = worksheet.Range["A1", missing]; 
      textInCell = worksheet.Controls.AddNamedRange(cell, "MyNamedRange");
      textInCell.Value2 = "Hello World";
   }
  

Vedere anche

Attività

Procedura: ridimensionare i controlli NamedRange

Concetti

Estensione in fase di esecuzione di documenti di Word e di cartelle di lavoro di Excel in componenti aggiuntivi a livello di applicazione

Controllo NamedRange

Automazione di Excel utilizzando oggetti estesi

Cenni preliminari sugli elementi e sui controlli host

Limitazioni a livello di codice degli elementi e dei controlli host

Altre risorse

Controlli nei documenti di Office