Procedura: aggiungere controlli NamedRange a fogli di lavoro

Aggiornamento: Luglio 2008

Si applica a
Le informazioni contenute in questo argomento riguardano solo i progetti Visual Studio Tools per Office e le versioni di Microsoft Office specificati. Progetti a livello di documento Excel 2007 Excel 2003 Progetti a livello di applicazione Excel 2007 Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazione.

È 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.

A partire da Visual Studio 2008 Service Pack 1 (SP1) è possibile aggiungere in fase di esecuzione controlli NamedRange nei progetti componente aggiuntivo 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.

Nota:
Nel computer in uso è possibile che vengano visualizzati nomi o percorsi diversi per alcuni elementi dell'interfaccia utente di Visual Studio nelle istruzioni seguenti. La versione di Visual Studio in uso e le impostazioni configurate determinano questi elementi. Per ulteriori informazioni vedere Impostazioni di Visual Studio.

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 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";
   }
  

Vedere anche

Attività

Procedura: eliminare i controlli in fase di progettazione

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

Sviluppo di componenti aggiuntivi a livello di applicazione per Excel

Controllo NamedRange

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

Controlli host di Excel

Cronologia delle modifiche

Data	Cronologia	Motivo
Luglio 2008	Aggiunta una sezione che illustra come aggiungere un controllo NamedRange in un foglio di lavoro di un componente aggiuntivo a livello di applicazione.	Modifica di funzionalità in SP1.