Como: adicionar colunas a uma DataTable

Você cria as colunas individuais (DataColumn) que constituem tabelas de dados ()DataTableadicionando-os à 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 Adding Columns to a Table.

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 do banco de dados.

Observação
As caixas de diálogo e comandos de menu você vê podem diferir daquelas descritas na ajuda dependendo de suas configurações ativas ou versão.Para alterar suas configurações, escolha Import and Export Settings no menu Tools.Para mais informações, consulte Configurações de Visual Studio.

Tarefas comuns

Tarefa	Conteúdo suportado
Adicione colunas para as tabelas: você pode adicionar colunas usando o dataset designer, o assistente de configuração da fonte de dados, ou o assistente de configuração de TableAdapter.	Adding Columns to a Data Table
As colunas deConfigurar colunas de dados: são adicionadas com 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 de isso, você pode configurar uma coluna de dados para exibir um valor calculado em vez de um valor que é ler diretamente do banco de dados.	Configuring DataColumns Configure a DataColumn to Display an Expression

Adicionando colunas a uma tabela de dados

Antes que você possa configurar um DataColumn, você deve primeiro adicionar um DataTable.Você pode fazer isso usando qualquer um dos procedimentos.

Para adicionar uma coluna a um DataTable com o Dataset Designer

1. Abra o DataSet no Dataset Designer.Para mais informações, consulte Como: abrir um Dataset no Dataset Designer.

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 DataSet no Dataset Designer.Para mais informações, consulte Como: abrir um Dataset no Dataset Designer.

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 colunas de dados

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.

• Setting the Data Type of a DataColumn

• Specifying the Caption of a DataColumn

• Specifying that a DataColumn Contain Auto-Generated Numbers

• Assigning a Default Value to a DataColumn

• Constraining a DataColumn to Contain Unique Values

• Setting a DataColumn to be the Primary Key in a DataTable

• Specifying the Return Value when the Value of a DataColumn is Null

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.

Observação

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 mais informações, consulte Como: personalizar como Visual Studio cria legendas para controles ligados a dados.

Para editar a legenda de uma coluna de dados

1. Abra o DataSet no Dataset Designer.Para mais informações, consulte Como: abrir um Dataset no Dataset Designer.

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 DataSet no Dataset Designer.

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.

   Observação
   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 de dados 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 DataSet no Dataset Designer.

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 DataSet no Dataset Designer.

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 retornado 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 em essa 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 uma DataTable.

Para criar expressões da coluna no DataSet Designer

1. Abra o DataSet no Dataset Designer.Para mais informações, consulte Como: abrir um Dataset no Dataset Designer.

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 mais informações, consulte Como: adicionar colunas a uma DataTable.

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

Tópicos relacionados

Category (Categoria)	Tópico
Visão geral de informações: aprender mais sobre como trabalhar com dados em Visual Studio.	Controles de vinculação de dados de Visual Studio Connecting to Data in Visual Studio Visão geral sobre fontes de dados Criando e editando conjuntos de dados tipados Designing DataTables Edição de dados em seu aplicativo. Buscando dados em seu aplicativo. Preparando seu aplicativo para receber dados Salvar dados TableAdapters Validação de dados Novidades para desenvolvimento de aplicativos de dados no Visual Studio 2012
procedimentos adicionais: souber sobre outros procedimentos para trabalhar com dados.	Explicações passo a passo de dados Como: conectar-se a dados em um banco de dados. Como criar tabelas de dados Passo a passo: Exibindo dados em um Windows Form Passo a passo: Criando um DataTable no Dataset Designer
referência: souber sobre as classes e membros que você usa para trabalhar com dados.	DataTable DataColumn DataSet