Compartilhar via

Adicionar controles NamedRange a planilhas

  • Artigo

Você pode adicionar NamedRange controles a uma planilha do Microsoft Office Excel em tempo de design e em tempo de execução em projetos de nível de documento.

Aplica-se a: As informações neste tópico se aplicam a projetos de nível de documento e projetos de suplemento VSTO para Excel. Para obter mais informações, consulte Recursos disponíveis por aplicativo e tipo de projeto do Office.

Você também pode adicionar NamedRange controles em tempo de execução em projetos de suplemento VSTO.

Este tópico descreve as seguintes tarefas:

Adicionar controles NamedRange em tempo de design

Há várias maneiras de adicionar NamedRange controles a uma planilha em um projeto de nível de documento em tempo de design: de dentro do Excel, da Caixa de Ferramentas do Visual Studio e da janela Fontes de Dados.

Observação

Seu computador pode mostrar diferentes nomes ou locais para alguns dos elementos de interface do usuário do Visual Studio nas instruções a seguir. A edição do Visual Studio que você possui e as configurações que você usa determinam esses elementos. Para obter mais informações, confira Personalizar o IDE.

Para adicionar um controle NamedRange a uma planilha usando a caixa Nome no Excel

  1. Selecione a(s) célula(s) que você deseja incluir no intervalo nomeado.

  2. Na caixa Nome, digite um nome para o intervalo e pressione Enter.

    A Caixa de Nome está localizada ao lado da barra de fórmulas, logo acima da coluna A da planilha.

Para adicionar um controle NamedRange a uma planilha usando a Caixa de Ferramentas

  1. Abra a Caixa de Ferramentas e clique na guia Controles do Excel.

  2. Clique NamedRange e arraste-o para uma planilha.

    A caixa de diálogo Adicionar Intervalo Nomeado é exibida.

  3. Selecione a(s) célula(s) que você deseja incluir no intervalo nomeado.

  4. Clique em OK.

    Se você não quiser o nome padrão que é dado ao controle, você pode alterar o nome na janela Propriedades .

Para adicionar um controle NamedRange a uma planilha usando a janela Fontes de Dados

  1. Abra a janela Fontes de Dados e crie uma fonte de dados para seu projeto. Para obter mais informações, confira Adicionar novas conexões.

  2. Arraste um único campo da janela Fontes de Dados para a planilha.

    Um controle associado a NamedRange dados é adicionado à planilha. Para obter mais informações, consulte Vinculação de dados e Windows Forms.

Adicionar controles NamedRange em tempo de execução em um projeto de nível de documento

Você pode adicionar um NamedRange controle programaticamente à sua planilha em tempo de execução. Isso permite que você crie os controles de host em resposta a eventos. Os intervalos nomeados criados dinamicamente não são persistentes na planilha como controles de host quando a planilha é fechada. Para obter mais informações, consulte Adicionar controles a documentos do Office em tempo de execução.

Para adicionar um controle NamedRange a uma planilha programaticamente

  1. Startup No manipulador de eventos do Sheet1, insira o código a seguir para adicionar o NamedRange controle à célula A1 e defina sua Value2 propriedade comoHello world!

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

textInCell.Value2 = "Hello world!";

Adicionar controles NamedRange em tempo de execução em um projeto de suplemento VSTO

Você pode adicionar um controle programaticamente a qualquer planilha aberta em um NamedRange projeto de suplemento VSTO. Os intervalos nomeados criados dinamicamente não são persistentes na planilha como controles de host quando a planilha é fechada. Para obter mais informações, consulte Estender documentos do Word e pastas de trabalho do Excel em suplementos VSTO em tempo de execução.

Para adicionar um controle NamedRange a uma planilha programaticamente

  1. O código a seguir gera um item de host de planilha baseado na planilha aberta e, em seguida, adiciona um NamedRange controle à célula A1 e define sua Value2 propriedade como Hello world.

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

Conteúdo relacionado