Compartilhar via

Como adicionar colunas a um DataTable

  • Artigo

Você cria as colunas individuais (DataColumn) que constituem tabelas de dados (DataTable) adicionando à DataColumnCollection para uma tabela de dados. Você pode adicionar colunas a tabelas de dados visualmente com DataSet Designer, ou com um dos assistentes de dados. Para obter mais informações sobre como adicionar programaticamente colunas de dados para tabelas de dados, consulte Adicionando colunas a um DataTable.

Após adicionar colunas, você pode configurar-las para atender às suas necessidades. Por exemplo, você pode especificar um valor padrão, ou uma restrição de exclusividade para uma coluna. Você também pode especificar que uma coluna deve exibir um valor calculado, em vez de um valor ler diretamente de base de dados.

Dica

As caixas de diálogo e os comandos de menu que você vê podem diferir das descritas no Help dependendo de suas configurações ativas ou de edição.Para alterar as configurações, escolha Importar e exportar configurações no menu Ferramentas.Para obter mais informações, consulte Personalizando configurações de desenvolvimento no Visual Studio.

Tarefas comuns

Tarefa 

Conteúdo de suporte

Adicione colunas para as tabelas: Você pode adicionar colunas usando o dataset designer de dados, o assistente de configuração de fonte de dados, ou o TableAdapter configuration wizard.

As colunas deConfigurar Colunas: são adicionadas com as propriedades padrão. Você pode personalizar configurações para cada Coluna especifique seu comportamento. Por exemplo, você pode especificar o tipo de dados, um valor padrão, ou a restrição uma coluna para conter valores exclusivos. Além disso, você pode configurar uma coluna de dados para exibir um valor calculado em vez de um valor que é ler diretamente de base de dados.

Adicionando colunas a uma tabela de dados

Antes que você possa configurar um DataColumn, primeiro você deve adicioná-lo a um DataTable. Você pode fazer isso usando qualquer um dos seguintes procedimentos.

Para adicionar uma coluna a um DataTable com o Dataset Designer

  1. Abra o conjunto de dados no Designer de Conjunto de Dados. Para obter mais informações, consulte Como abrir um conjunto de dados no Designer de Conjunto de Dados.

  2. Clique com o botão direito do mouse em DataTable para adicionar a coluna. Aponte para Add, e clique Column.

  3. Substitua o nome de coluna padrão, se desejar, selecionando o nome da coluna na tabela de dados e editando o texto.

  4. Defina a propriedade DataType na janela Properties.

Para adicionar uma coluna a um DataTable com o Data Source Configuration Wizard

  1. Na janela Data Sources, clique com o botão direito do mouse na fonte de dados e clique em Configure DataSet with Wizard.

  2. Expanda a tabela à qual deseja adicionar uma coluna.

  3. Selecione as colunas para adicionar à tabela.

  4. Clique em Concluir.

Para adicionar uma coluna a um DataTable com o TableAdapter Configuration Wizard

  1. Abra o conjunto de dados no Designer de Conjunto de Dados. Para obter mais informações, consulte Como abrir um conjunto de dados no Designer de Conjunto de Dados.

  2. Clique com o botão direito do mouse na tabela de dados, e clique em Configure.

  3. Adicione a coluna na declaração SELECT.

  4. Clique em Concluir.

Configurando as DataColumns

Após adicionar um DataColumn, você especifica o comportamento do DataColumn. Por exemplo, convém alterar o tipo de dados ou para restringi-lo somente para conter valores exclusivos. Você pode usar qualquer um dos seguintes procedimentos para alterar o comportamento de Coluna.

Definindo o tipo de dados de um DataColumn

Colunas de dados (DataColumn) são criadas com um tipo de dados padrão de String. Para alterar o tipo de dados de uma coluna, configure a propriedade DataType na janela Properties.

Para configurar o tipo de dados de uma Coluna de Dados

  1. Abra um dataset no Dataset Designer.

  2. Selecione a coluna para a qual você deseja definir o tipo de dados.

  3. Na janela Properties, selecione o tipo de dados desejado da lista DataType.

Especificando a legenda de um DataColumn

Colunas de dados geralmente têm nomes que não são adequadas para exibição em uma interface de usuário. Você pode alterar a legenda para um nome mais adequado definindo a propriedade Caption na janela Properties.

Dica

Uma consideração especial deve ser feita quando você arrasta itens da janela Data Sources para um formulário em um aplicativo do Windows: os nomes de coluna nos rótulos de legenda são reformatados em uma cadeia de caracteres mais legível quando duas ou mais palavras encontram-se concatenadas.Para obter mais informações, consulte Como personalizar como o Visual Studio cria legendas para controles associados a dados.

Para editar a legenda de uma coluna de dados

  1. Abra o conjunto de dados no Designer de Conjunto de Dados. Para obter mais informações, consulte Como abrir um conjunto de dados no Designer de Conjunto de Dados.

  2. Selecione a coluna cuja legenda você deseja editar.

  3. Na janelaProperties configure a propriedade Caption.

Especificar que um DataColumn contém números gerados automaticamente

Colunas de dados (DataColumn) geralmente contêm números seqüenciais gerados automaticamente; por exemplo, chaves primárias e colunas de identificação. Você pode carregar números gerados automaticamente em colunas de dados, definindo as AutoIncrement, AutoIncrementSeed e AutoIncrementStep da coluna de dados.

Quando colunas de dados são criadas por meio de ferramentas de design do Visual Studio, as colunas são automaticamente marcadas como AutoIncrement. Quando você atualiza uma tabela no banco de dados que contém uma coluna de identidade, os valores criados com o recurso de numeração automática não são enviados para o banco de dados.

Para definir uma coluna de dados para conter números gerado automaticamente

  1. Abra o conjunto de dados no Designer de Conjunto de Dados.

  2. Selecione a coluna que deseja preencher com números gerados automaticamente.

  3. Na janela Propriedades, defina as propriedades a seguir:

    Propriedade

    Configuração

    AutoIncrement

    true

    AutoIncrementSeed

    Se você deseja começar com um número diferente do valor padrão de 0, defina este valor para o número inicial para essa coluna.

    AutoIncrementStep

    Em cada nova linha, o valor coluna é incrementado por esse valor.

    Dica

    Defina uma coluna de dados como incremento automático não para automático para designar a coluna como uma chave primária.

Atribuindo um valor padrão para um DataColumn

Colunas de dados podem ser atribuídas valores padrão. O valor padrão é atribuída na coluna como novas linhas (registros) são criadas.

Para atribuir um coluna de dados um valor padrão

  1. Abra um dataset no Dataset Designer.

  2. Selecione a coluna que você deseja atribuir um valor padrão para.

  3. Na janela Properties,defina a propriedade DefaultValue para o valor padrão desejado.

Restringir uma Coluna para conter valores exclusivos

Você define uma DataColumn para conter valores exclusivos adicionando uma restrição exclusiva a uma tabela de dados. Restrições exclusivas também são chamadas chaves. Marcar uma coluna como uma chave primária no dataset designer irá criar uma restrição exclusiva

Para restringir uma coluna para conter valores exclusivos

  1. Abra o conjunto de dados no Designer de Conjunto de Dados.

  2. Clique com o botão direito do mouse na coluna que deseja restringir com valores exclusivos. Aponte para Add, e selecione Key.

  3. Verifique que a coluna correta está selecionada na caixa de diálogo Unique Constraint.

  4. Substitua o nome padrão da restrição com um nome mais significativo, se desejado.

Definindo um DataColumn para ser a chave primária em uma DataTable

Definindo uma coluna de dados como primária garante que cada registro contém um valor exclusivo. Somente uma chave primária pode ser atribuído a uma tabela de dados. Você criar uma chave primária em uma tabela de dados usando o Dataset Designer.

Para definir uma coluna de dados para ser a chave primária em uma tabela de dados

  1. Abra o conjunto de dados no Designer de Conjunto de Dados.

  2. Clique com o botão direito do mouse na coluna que você deseja definir como a chave primária. Clique em Set Primary Key.

    Um ícone de chave aparecerá ao lado das colunas selecionadas.

Especificando o valor de retorno quando o valor de uma Coluna é nulo

Em um dataset tipado, você pode controlar a representação de colunas que contêm valores null. Esse comportamento está apenas disponível ao recuperar valores de coluna a seus acessadores digitados. Se você recuperar o valor por meio de índice de linha da tabela ou índice da coluna, não será capaz de definir o valor de retorno. A razão para isso é que a lógica para retornar esse valor é incorporada na propriedade setter da coluna de dados específicos na classe do dataset gerado.

Para definir o valor a retornar quando um DataColumn do valor é Nulo

  1. Abra o dataset no Dataset Designer.

  2. Selecione uma coluna em uma tabela de dados.

  3. Na janela Properties, selecione a propriedade NullValue.

  4. Siga um destes procedimentos:

    • Na lista drop-down, selecione o valor apropriado:

      Valor

      Descrição

      (Vazio)

      Retorna valores nulos String.Empty.

      (Nada)

      Retorna valores nulos como DBNull.

      (Gerar exceção)

      Valores nulos geram uma Exception.

      - ou -

    • Defina a propriedade para qualquer valor personalizado válido para essa coluna do tipo de dados. Por exemplo, se você especificar a cadeia de caracteres valor, para uma coluna com um tipo de dados de String, todos os registros que contêm valores nulos nessa coluna exibirão “valor”.

Configurar um DataColumn para exibir uma expressão

Uma tabela de dados em um DataSet pode conter colunas em que o valor é calculado em vez de ser lido a partir do banco de dados. Por exemplo, em um registro de detalhes do pedido , pode fazer sentido definir uma coluna ExtendedPrice multiplicando a quantidade vezes o preço em vez de armazenar o total no registro. Colunas calculadas também podem adicionar ou contar valores nos registros filho e filtrar outros registros. Você pode definir colunas calculadas usando expressões.

A sintaxe da expressão consiste de operadores padrões. Você pode fazer referência a um valor de dados usando o nome da coluna (como você faria em uma Instrução SQL) e incluir funções agregadas, como Count.

Por exemplo, a expressão para uma coluna ExtendedPrice baseada nas colunas UnitPrice times Quantity do registro atual pode ser simplesmente:

UnitPrice * Quantity

Para se referir a colunas em tabelas filho, você pode usar a palavra reservada Child, seguida do nome da coluna. Por exemplo, a expressão a seguir retorna o valor médio da coluna Price em todos os registros filho relacionados:

Avg(Child.Price)

Para obter mais informações, consulte a propriedade Expression.

Você pode criar colunas de expressão no DataSet Designer. Para obter mais informações sobre como criar colunas, consulte Como adicionar colunas a um DataTable.

Para criar expressões da coluna no DataSet Designer

  1. Abra o conjunto de dados no Designer de Conjunto de Dados. Para obter mais informações, consulte Como abrir um conjunto de dados no Designer de Conjunto de Dados.

  2. Na tabela de dados que você deseja, selecione a coluna a que você deseja adicionar a expressão, ou adicione uma nova coluna à tabela. Para obter mais informações, consulte Como adicionar colunas a um DataTable.

  3. Na janela Properties, digite uma expressão na propriedade Expression.

Tópicos relacionados

Categoria

Tópico

Informações de visão geral: Aprender mais sobre como trabalhar com dados em Visual Studio.

Procedimentos adicionais: Souber sobre outros procedimentos para trabalhar com dados.

Referência: Souber sobre as classes e membros que você usa para trabalhar com dados.