ADO.NET 2.0 - classe DataSet
publicado em 16 de maio de 2008 por Agnaldo em www.50minutos.com.br
Iniciei o assunto nesse post. Aqui falei sobre a classe Connection e aqui sobre a classe ConnectionStringBuilder. Agora é a vez do DataSet.
Um objeto da classe DataSet mantém um conjunto de dados em memória. Esses dados podem vir de uma consulta a uma base de dados, leitura de um XML, etc.
Devemos importar o namespace adequado para usar a classe DataSet (os exemplos desse post serão todos baseados no Microsoft SQL Server 2005 Express Edition - a versão grátis):
Visual Basic
Imports System.Data
C#
using System.Data;
A declaração da classe DataSet é:
Visual Basic
<SerializableAttribute>
Public Class DataSet
Inherits MarshalByValueComponent
Implements IListSource, IXmlSerializable, _
ISupportInitializeNotification, ISupportInitialize, _
ISerializable
C#
[SerializableAttribute]
public class DataSet : MarshalByValueComponent,
IListSource, IXmlSerializable,
ISupportInitializeNotification, ISupportInitialize, ISerializable
O DataSet é formado por uma coleção de objetos DataTable, que podem ser relacionados usando objetos DataRelation. Podemos, ainda, garantir a integridade dos dados que estão em memória usando constraints (regras), com os objetos das classes UniqueConstraint e ForeignKeyConstraint.
Os principais membros da classe DataSet são:
- Propriedades:
- CaseSensitive - atribui ou obtém o tipo de comparação de Strings que será usado: case sensitive (letras maiúsculas são diferentes de letras minúsculas) ou case insensitive (ambas são iguais, para comparação);
- HasErrors - retorna true se existem erros nos dados armazenados nos DataTables ou false se não existem erros;
- IsInitialized - retorna true se o DataSet foi inicializado;
- Relations - retorna uma coleção de objetos DataRelation, com os relacionamentos entre os DataTables;
- Tables - retorna uma coleção de objetos DataTable;
- Métodos:
- Clear - limpa todos os dados do DataSet;
- Clone - copia a estrutura completa do DataSet, sem os dados;
- Copy - copia a estrutura e os dados do DataSet;
- GetXml - obtém um XML com os dados armazenados no DataSet;
- GetXmlSchema - obtém um XML com o XML schema dos dados armazenados no DataSet;
- ReadXml - lê dados e schemas XML para o DataSet;
- WriteXml - grava os dados e/ou schemas XML que estão no DataSet;
- WriteXmlSchema - grava a estrutura do DataSet como um XML schema.
- BeginInit - inicia a edição dos dados do DataSet;
- EndInit - finaliza a edição dos dados do DataSet;
- AcceptChanges - confirma todas as alterações feitas no DataSet desde que o mesmo foi criado ou desde a última execução de AcceptChanges;
- RejectChanges - desfaz todas as alterações feitas no DataSet desde que o mesmo foi criado ou desde a última execução de AcceptChanges.
Os principais construtores são:
- DataSet() - cria um objeto;
- DataSet(String) - cria um objeto com o nome fornecido.
Dim ds as DataSet
ds = New DataSet()
C#
DataSet ds as new DataSet();
Baixe aqui um aplicativo exemplo em VB.NET ou C#.
