Controle NamedRange

O NamedRange controle é um intervalo que tem um nome exclusivo, expõe eventos e pode ser associado a dados. Para obter mais informações, consulte a visão geral do modelo de objeto do Excel.

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 Os recursos disponíveis pelo aplicativo do Office e pelo tipo de projeto.

Criar o controle

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

Você pode adicionar NamedRange controles a uma planilha em tempo de execução em um Suplemento VSTO. Para obter mais informações, consulte Como adicionar controles NamedRange a planilhas.

NamedRange os controles só podem consistir em intervalos em planilhas específicas. NamedRange os controles não podem ter nomes relativos que se aplicam a todas as planilhas e não podem consistir em intervalos que abrangem duas ou mais planilhas em uma pasta de trabalho (intervalos 3D).

Associar dados ao controle

Um intervalo nomeado parece ser um bom candidato para associação de dados complexa, pois pode ter muitas células; no entanto, um intervalo é apenas uma coleção de células que não podem ser facilmente mapeadas para uma coluna específica de um conjunto de dados. Portanto, NamedRange os controles só dão suporte à associação de dados simples. O ListObject controle pode ser usado para associação de dados complexa. Para obter mais informações, consulte o controle ListObject.

O NamedRange controle pode ser associado a uma fonte de dados usando as DataBindings propriedades. A propriedade de associação de dados padrão do NamedRange controle é Value2.

Se os dados no conjunto de dados associados forem atualizados por meio de qualquer mecanismo, o NamedRange controle refletirá as alterações.

Formatting

A formatação que pode ser aplicada a um Range pode ser aplicada a um NamedRange controle. Isso inclui bordas, fontes, formatos de número e estilos.

Renomear o controle

Quando você adiciona um NamedRange controle à sua planilha da Caixa de Ferramentas, o Visual Studio gera automaticamente um nome para o controle. Você pode alterar o nome na janela Propriedades .

Eventos

Os seguintes eventos estão disponíveis para o NamedRange controle:

• BeforeDoubleClick

• BeforeRightClick

• BindingContextChanged

• Change

• Deselected

• Disposed

• Selected

• SelectionChange

Conteúdo relacionado

• Automatizar o Excel usando objetos estendidos
• Exemplos de desenvolvimento do Office e instruções passo a passo
• Associar dados a controles em soluções do Office
• Estender documentos do Word e pastas de trabalho do Excel em Add-ins VSTO em tempo de execução
• Controles em documentos do Office
• Adicionar controles aos documentos do Office em tempo de execução
• Como adicionar controles NamedRange a planilhas
• Como redimensionar controles NamedRange
• Associar dados a controles em soluções do Office
• Passo a passo: Programa em relação a eventos de um controle NamedRange
• Limitações programáticas de itens de host e controles de host