ADO.NET 2.0 - classe DataSet

o Agnaldo apresenta uma visão inicial do objeto DataSet e dá exemplos de uso em VB.NET e C#

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:

Como criar um DataSet:Visual Basic 

Dim ds as DataSet
ds = New DataSet()

C#

DataSet ds as new DataSet();
Baixe aqui um aplicativo exemplo em VB.NET ou C#.

Artigos relacionados