Como: adicionar controles de NamedRange às planilhas

  • Artigo

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

Aplicável a: As informações neste tópico se aplicam a projetos de nível de documento e projetos de nível de aplicativo para Excel 2013 e Excel 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

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

este tópico descreve as seguintes tarefas:

  • Adicionando controles de NamedRange em tempo de design

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

  • Adicionando controles de NamedRange em tempo de execução em um projeto de nível de aplicativo

Para obter mais informações sobre controles de NamedRange , consulte Controle NamedRange.

Adicionando controles de NamedRange em tempo de design

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

ObservaçãoObservação

Seu computador pode mostrar nomes ou locais diferentes para alguns dos elementos da 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, consulte Configurações de Visual Studio.

Para adicionar um controle de NamedRange a uma planilha usando a caixa do nome do excel

  1. Selecione a célula ou as células que você deseja incluir no intervalo nomeado.

  2. Em Caixa de nome, digite um nome para o intervalo e pressione ENTER.

    Caixa de nome Está localizado perto de barra fórmula, logo acima da coluna a a planilha.

para adicionar um controle de NamedRange a uma planilha usando a caixa de ferramentas

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

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

    a caixa de diálogo de Adicione o intervalo nomeado aparece.

  3. Selecione a célula ou as células que você deseja incluir no intervalo nomeado.

  4. Clique em OK.

    Se você não deseja que o nome padrão que é determinado ao controle, você pode alterar o nome na janela de Propriedades .

Para adicionar um controle de NamedRange a uma planilha usando a janela fontes de dados

  1. Abra a janela de Fontes de Dados e criar uma fonte de dados para seu projeto.Para obter mais informações, consulte Como: conectar-se a dados em um banco de dados..

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

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

Adicionando controles de NamedRange em tempo de execução em um projeto de um documento Nível

você pode adicionar um controle de NamedRange programaticamente a sua planilha em tempo de execução.Isso permite que você crie os controles host em resposta a eventos.Os intervalos nomeados criados dinamicamente não são persistentes na planilha como controles 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 programaticamente de NamedRange a uma planilha

  • Em o manipulador de eventos de Startup de Sheet1, insira o código a seguir para adicionar o controle de NamedRange para a célula A1 e definir sua propriedade de Value2 a 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"), "cellText");

textInCell.Value2 = "Hello world!";

Adicionando controles de NamedRange em tempo de execução em um projeto de Nível de aplicativo

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

Para adicionar um controle programaticamente de NamedRange a uma planilha

  • O código a seguir gera um item de host da planilha que é baseado na planilha aberta, e então adiciona um controle de NamedRange para a célula A1 e defina sua propriedade Value2 da 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)

    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

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

Consulte também

Tarefas

Como: redimensionar controles NamedRange

Conceitos

Estendendo os documentos do Word e pastas de trabalho do Excel em suplementos de nível de aplicativo em tempo de execução

Controle NamedRange

Automatizar o Excel usando o Extended objetos

Itens de host e visão geral sobre controles de Host

Limitações de programação de itens de Host e controles de Host

Outros recursos

Controles em documentos do Office