Como: Adicionar controles de NamedRange para planilhas

  • Artigo

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

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 2007 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 NamedRange controles em tempo de execução no nível do aplicativo add-in de projetos.

Este tópico descreve as seguintes tarefas:

  • Adicionar controles de NamedRange em tempo de design

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

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

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

Adicionar controles de NamedRange em tempo de Design

Há várias maneiras de se adicionar NamedRange controles de uma planilha em um projeto de nível de documento em tempo de design: de dentro do Excel, a partir de Visual Studio caixa de ferramentase o Fontes de dados janela.

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 do Visual Studio.

Para adicionar um controle de NamedRange para uma planilha usando a caixa de nome no Excel

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

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

    O Caixa de nome está localizado ao lado da barra de fórmula, acima de coluna a da planilha.

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

  1. Abrir o caixa de ferramentas e clique no Excel controles guia.

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

    O Intervalo nomeado de adicionar caixa de diálogo aparece.

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

  4. Click OK.

    Se você não quiser que o nome padrão que é fornecido para o controle, você pode alterar o nome do Propriedades janela.

Para adicionar um controle de NamedRange para uma planilha usando a janela Data Sources

  1. Abrir o Fontes de dados janela e criar uma fonte de dados para seu projeto. For more information, see Como: Conectar-se a Dados em um Banco de Dados.

  2. Arraste um único campo da Fontes de dados janela para sua planilha.

    Uma data-bound NamedRange controle é adicionado à planilha. For more information, see Ligação de dados e o Windows Forms.

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

Você pode adicionar um NamedRange controle programaticamente para sua planilha em tempo de execução. Isso permite que você crie os controles de host em resposta a eventos. Criado dinamicamente intervalos nomeados não são persistentes na planilha como controles de host quando a planilha está fechada. For more information, see Adicionar controles a documentos do Office em tempo de execução.

Para adicionar um controle NamedRange para uma planilha de forma programática

  • No Startup manipulador de eventos de Sheet1, insira o código a seguir para adicionar o NamedRange controle para a célula A1 e defina seu Value2 propriedade para 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!";

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

Você pode adicionar um NamedRange controle programaticamente para qualquer planilha aberta em um projeto de nível de aplicativo. Criado dinamicamente intervalos nomeados não são persistentes na planilha como controles de host quando a planilha está fechada. For more information, see 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 NamedRange para uma planilha de forma programática

  • O código a seguir gera um item de host de planilha que se baseia na planilha aberta e, em seguida, adiciona um NamedRange o controle à célula A1 e define sua Value2 propriedade para 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";
 }

Consulte também

Tarefas

Como: Redimensionar controles de 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 de NamedRange

Automatizar o Excel usando o Extended objetos

Itens de host e a 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