DataSet Classe

Definição

Representa um cache de dados na memória.Represents an in-memory cache of data.

public ref class DataSet : System::ComponentModel::MarshalByValueComponent, System::ComponentModel::IListSource, System::ComponentModel::ISupportInitializeNotification, System::Runtime::Serialization::ISerializable, System::Xml::Serialization::IXmlSerializable
[System.Serializable]
public class DataSet : System.ComponentModel.MarshalByValueComponent, System.ComponentModel.IListSource, System.ComponentModel.ISupportInitializeNotification, System.Runtime.Serialization.ISerializable, System.Xml.Serialization.IXmlSerializable
type DataSet = class
    inherit MarshalByValueComponent
    interface IListSource
    interface IXmlSerializable
    interface ISupportInitializeNotification
    interface ISerializable
    interface ISupportInitialize
Public Class DataSet
Inherits MarshalByValueComponent
Implements IListSource, ISerializable, ISupportInitializeNotification, IXmlSerializable
Herança
Atributos
Implementações

Exemplos

O exemplo a seguir consiste em vários métodos que, combinados, criam e preenchem um DataSet do banco de dados Northwind .The following example consists of several methods that, combined, create and fill a DataSet from the Northwind database.

using System;
using System.Data;
using System.Data.SqlClient;

namespace Microsoft.AdoNet.DataSetDemo
{
    class NorthwindDataSet
    {
        static void Main()
        {
            string connectionString = GetConnectionString();
            ConnectToData(connectionString);
        }

        private static void ConnectToData(string connectionString)
        {
            //Create a SqlConnection to the Northwind database.
            using (SqlConnection connection =
                       new SqlConnection(connectionString))
            {
                //Create a SqlDataAdapter for the Suppliers table.
                SqlDataAdapter adapter = new SqlDataAdapter();

                // A table mapping names the DataTable.
                adapter.TableMappings.Add("Table", "Suppliers");

                // Open the connection.
                connection.Open();
                Console.WriteLine("The SqlConnection is open.");

                // Create a SqlCommand to retrieve Suppliers data.
                SqlCommand command = new SqlCommand(
                    "SELECT SupplierID, CompanyName FROM dbo.Suppliers;",
                    connection);
                command.CommandType = CommandType.Text;

                // Set the SqlDataAdapter's SelectCommand.
                adapter.SelectCommand = command;

                // Fill the DataSet.
                DataSet dataSet = new DataSet("Suppliers");
                adapter.Fill(dataSet);

                // Create a second Adapter and Command to get
                // the Products table, a child table of Suppliers. 
                SqlDataAdapter productsAdapter = new SqlDataAdapter();
                productsAdapter.TableMappings.Add("Table", "Products");

                SqlCommand productsCommand = new SqlCommand(
                    "SELECT ProductID, SupplierID FROM dbo.Products;",
                    connection);
                productsAdapter.SelectCommand = productsCommand;

                // Fill the DataSet.
                productsAdapter.Fill(dataSet);

                // Close the connection.
                connection.Close();
                Console.WriteLine("The SqlConnection is closed.");

                // Create a DataRelation to link the two tables
                // based on the SupplierID.
                DataColumn parentColumn =
                    dataSet.Tables["Suppliers"].Columns["SupplierID"];
                DataColumn childColumn =
                    dataSet.Tables["Products"].Columns["SupplierID"];
                DataRelation relation =
                    new System.Data.DataRelation("SuppliersProducts",
                    parentColumn, childColumn);
                dataSet.Relations.Add(relation);
                Console.WriteLine(
                    "The {0} DataRelation has been created.",
                    relation.RelationName);
            }
        }

        static private string GetConnectionString()
        {
            // To avoid storing the connection string in your code, 
            // you can retrieve it from a configuration file.
            return "Data Source=(local);Initial Catalog=Northwind;"
                + "Integrated Security=SSPI";
        }
    }
}
Option Explicit On
Option Strict On

Imports System.Data
Imports system.Data.SqlClient

Public Class NorthwindDataSet

    Public Shared Sub Main()
        Dim connectionString As String = _
            GetConnectionString()
        ConnectToData(connectionString)
    End Sub

    Private Shared Sub ConnectToData( _
        ByVal connectionString As String)

        ' Create a SqlConnection to the Northwind database.
        Using connection As SqlConnection = New SqlConnection( _
           connectionString)

            ' Create a SqlDataAdapter for the Suppliers table.
            Dim suppliersAdapter As SqlDataAdapter = _
               New SqlDataAdapter()

            ' A table mapping names the DataTable.
            suppliersAdapter.TableMappings.Add("Table", "Suppliers")

            ' Open the connection.
            connection.Open()
            Console.WriteLine("The SqlConnection is open.")

            ' Create a SqlCommand to retrieve Suppliers data.
            Dim suppliersCommand As New SqlCommand( _
               "SELECT SupplierID, CompanyName FROM dbo.Suppliers;", _
               connection)
            suppliersCommand.CommandType = CommandType.Text

            ' Set the SqlDataAdapter's SelectCommand.
            suppliersAdapter.SelectCommand = suppliersCommand

            ' Fill the DataSet.
            Dim dataSet As New DataSet("Suppliers")
            suppliersAdapter.Fill(dataSet)

            ' Create a second SqlDataAdapter and SqlCommand to get
            ' the Products table, a child table of Suppliers. 
            Dim productsAdapter As New SqlDataAdapter()
            productsAdapter.TableMappings.Add("Table", "Products")

            Dim productsCommand As New SqlCommand( _
               "SELECT ProductID, SupplierID FROM dbo.Products;", _
               connection)
            productsAdapter.SelectCommand = productsCommand

            ' Fill the DataSet.
            productsAdapter.Fill(dataSet)

            ' Close the connection.
            connection.Close()
            Console.WriteLine("The SqlConnection is closed.")

            ' Create a DataRelation to link the two tables
            ' based on the SupplierID.
            Dim parentColumn As DataColumn = _
               dataSet.Tables("Suppliers").Columns("SupplierID")
            Dim childColumn As DataColumn = _
               dataSet.Tables("Products").Columns("SupplierID")
            Dim relation As New DataRelation("SuppliersProducts", _
               parentColumn, childColumn)
            dataSet.Relations.Add(relation)

            Console.WriteLine( _
               "The {0} DataRelation has been created.", _
               relation.RelationName)
        End Using

    End Sub

    Private Shared Function GetConnectionString() As String
        ' To avoid storing the connection string in your code,  
        ' you can retrieve it from a configuration file.
        Return "Data Source=(local);Initial Catalog=Northwind;" _
           & "Integrated Security=SSPI;"
    End Function
End Class

Comentários

O DataSet, que é um cache na memória de dados recuperados de uma fonte de dados, é um componente importante da arquitetura ADO.net.The DataSet, which is an in-memory cache of data retrieved from a data source, is a major component of the ADO.NET architecture. O DataSet consiste em uma coleção de DataTable objetos que você pode relacionar entre si com DataRelation objetos.The DataSet consists of a collection of DataTable objects that you can relate to each other with DataRelation objects. Você também pode impor a integridade dos dados DataSet no usando os UniqueConstraint objetos ForeignKeyConstraint e.You can also enforce data integrity in the DataSet by using the UniqueConstraint and ForeignKeyConstraint objects. Para obter mais detalhes sobre como DataSet trabalhar com objetos, consulte conjuntos de valores, DataTables e DataViews.For further details about working with DataSet objects, see DataSets, DataTables, and DataViews.

Enquanto DataTable os objetos contêm os dados, DataRelationCollection o permite que você navegue por meio da hierarquia de tabela.Whereas DataTable objects contain the data, the DataRelationCollection allows you to navigate though the table hierarchy. As tabelas estão contidas em DataTableCollection um acessado por meio da Tables propriedade.The tables are contained in a DataTableCollection accessed through the Tables property. Ao acessar DataTable objetos, observe que eles são condicionalmente diferenciando maiúsculas de minúsculas.When accessing DataTable objects, note that they are conditionally case sensitive. Por exemplo, se um DataTable for denominado "mydatatable" e outro for nomeado "mydatatable", uma cadeia de caracteres usada para pesquisar uma das tabelas será considerada diferenciação de maiúsculas e minúsculas.For example, if one DataTable is named "mydatatable" and another is named "Mydatatable", a string used to search for one of the tables is regarded as case sensitive. No entanto, se "mydatatable" existir e "mydatatable" não, a cadeia de caracteres de pesquisa será considerada como não diferencia maiúsculas de minúsculas.However, if "mydatatable" exists and "Mydatatable" does not, the search string is regarded as case insensitive. Para obter mais informações sobre como DataTable trabalhar com objetos, consulte Creating a DataTable.For more information about working with DataTable objects, see Creating a DataTable.

Um DataSet pode ler e gravar dados e esquema como documentos XML.A DataSet can read and write data and schema as XML documents. Os dados e o esquema podem ser transportados por HTTP e usados por qualquer aplicativo, em qualquer plataforma habilitada para XML.The data and schema can then be transported across HTTP and used by any application, on any platform that is XML-enabled. Você pode salvar o esquema como um esquema XML com o WriteXmlSchema método, e o esquema e os dados podem ser salvos usando WriteXml o método.You can save the schema as an XML schema with the WriteXmlSchema method, and both schema and data can be saved using the WriteXml method. Para ler um documento XML que inclui o esquema e os dados, use ReadXml o método.To read an XML document that includes both schema and data, use the ReadXml method.

Em uma implementação típica de várias camadas, as etapas para criar e atualizar um DataSete, por sua vez, atualizar os dados originais são:In a typical multiple-tier implementation, the steps for creating and refreshing a DataSet, and in turn, updating the original data are to:

  1. Crie e preencha cada DataTable um em DataSet um com dados de uma fonte de dados DataAdapterusando um.Build and fill each DataTable in a DataSet with data from a data source using a DataAdapter.

  2. Altere os dados em objetos DataTable individuais adicionando, atualizando ou excluindo DataRow objetos.Change the data in individual DataTable objects by adding, updating, or deleting DataRow objects.

  3. Invoque o GetChanges método para criar um segundo DataSet que apresenta apenas as alterações nos dados.Invoke the GetChanges method to create a second DataSet that features only the changes to the data.

  4. Chame o Update método DataAdapterde, passando o segundo DataSet como um argumento.Call the Update method of the DataAdapter, passing the second DataSet as an argument.

  5. Invoque o Merge método para mesclar as alterações do segundo DataSet para o primeiro.Invoke the Merge method to merge the changes from the second DataSet into the first.

  6. Invoque o AcceptChanges DataSetno.Invoke the AcceptChanges on the DataSet. Como alternativa, invoque RejectChanges para cancelar as alterações.Alternatively, invoke RejectChanges to cancel the changes.

Observação

Os DataSet objetos DataTable e herdam MarshalByValueComponentde e dão suporte ISerializable à interface para comunicação remota.The DataSet and DataTable objects inherit from MarshalByValueComponent, and support the ISerializable interface for remoting. Esses são os únicos objetos ADO.NET que podem ser remotos.These are the only ADO.NET objects that can be remoted.

Observação

As classes herdadas de DataSet não são finalizadas pelo coletor de lixo, pois o finalizador foi suprimido no. DataSetClasses inherited from DataSet are not finalized by the garbage collector, because the finalizer has been suppressed in DataSet. A classe derivada pode chamar o ReRegisterForFinalize método em seu construtor para permitir que a classe seja finalizada pelo coletor de lixo.The derived class can call the ReRegisterForFinalize method in its constructor to allow the class to be finalized by the garbage collector.

Construtores

DataSet()

Inicializa uma nova instância da classe DataSet.Initializes a new instance of the DataSet class.

DataSet(SerializationInfo, StreamingContext)

Inicializa uma nova instância de uma classe DataSet que tem as informações de serialização e contexto fornecidas.Initializes a new instance of a DataSet class that has the given serialization information and context.

DataSet(SerializationInfo, StreamingContext, Boolean)

Inicializa uma nova instância da classe DataSet.Initializes a new instance of the DataSet class.

DataSet(String)

Inicializa uma nova instância de uma classe DataSet com o nome especificado.Initializes a new instance of a DataSet class with the given name.

Propriedades

CaseSensitive

Obtém ou define um valor que indica se comparações de cadeia de caracteres dentro de objetos DataTable diferenciam maiúsculas de minúsculas.Gets or sets a value indicating whether string comparisons within DataTable objects are case-sensitive.

Container

Obtém o contêiner para o componente.Gets the container for the component.

(Herdado de MarshalByValueComponent)
DataSetName

Obtém ou define o nome do DataSet atual.Gets or sets the name of the current DataSet.

DefaultViewManager

Obtém uma exibição personalizada dos dados contidos no DataSet para permitir a filtragem, a pesquisa e a navegação usando um DataViewManager personalizado.Gets a custom view of the data contained in the DataSet to allow filtering, searching, and navigating using a custom DataViewManager.

DesignMode

Obtém um valor que indica se o componente está atualmente no modo de design.Gets a value indicating whether the component is currently in design mode.

(Herdado de MarshalByValueComponent)
EnforceConstraints

Obtém ou define um valor que indica se as regras de restrição são seguidas ao tentar qualquer operação de atualização.Gets or sets a value indicating whether constraint rules are followed when attempting any update operation.

Events

Obtém a lista de manipuladores de eventos que estão anexados a este componente.Gets the list of event handlers that are attached to this component.

(Herdado de MarshalByValueComponent)
ExtendedProperties

Obtém a coleção de informações de usuário personalizadas associadas a um DataSet.Gets the collection of customized user information associated with the DataSet.

HasErrors

Obtém um valor que indica se há erros em qualquer um dos objetos DataTable nesse DataSet.Gets a value indicating whether there are errors in any of the DataTable objects within this DataSet.

IsInitialized

Obtém um valor que indica se o DataSet é inicializado.Gets a value that indicates whether the DataSet is initialized.

Locale

Obtém ou define as informações de localidade usadas para comparar cadeias de caracteres na tabela.Gets or sets the locale information used to compare strings within the table.

Namespace

Obtém ou define o namespace do DataSet.Gets or sets the namespace of the DataSet.

Prefix

Obtém ou define um prefixo XML que cria o alias do namespace do DataSet.Gets or sets an XML prefix that aliases the namespace of the DataSet.

Relations

Obtém a coleção de relações que vinculam tabelas e permitem a navegação de tabelas principais para tabelas secundárias.Gets the collection of relations that link tables and allow navigation from parent tables to child tables.

RemotingFormat

Obtém ou define um SerializationFormat para o DataSet usado durante a comunicação remota.Gets or sets a SerializationFormat for the DataSet used during remoting.

SchemaSerializationMode

Obtém ou define um SchemaSerializationMode para um DataSet.Gets or sets a SchemaSerializationMode for a DataSet.

Site

Obtém ou define um ISite para o DataSet.Gets or sets an ISite for the DataSet.

Tables

Obtém a coleção de tabelas contidas no DataSet.Gets the collection of tables contained in the DataSet.

Métodos

AcceptChanges()

Confirma todas as alterações feitas nesse DataSet desde que foi carregado ou desde a última vez que AcceptChanges() foi chamado.Commits all the changes made to this DataSet since it was loaded or since the last time AcceptChanges() was called.

BeginInit()

Começa a inicialização de um DataSet usado em um formulário ou por outro componente.Begins the initialization of a DataSet that is used on a form or used by another component. A inicialização ocorre no tempo de execução.The initialization occurs at run time.

Clear()

Limpa o DataSet de todos os dados, removendo todas as linhas em todas as tabelas.Clears the DataSet of any data by removing all rows in all tables.

Clone()

Copia a estrutura do DataSet, incluindo todos os esquemas, relações e restrições DataTable.Copies the structure of the DataSet, including all DataTable schemas, relations, and constraints. Não copia todos os dados.Does not copy any data.

Copy()

Copia a estrutura e os dados para este DataSet.Copies both the structure and data for this DataSet.

CreateDataReader()

Retorna um DataTableReader com um resultado definido por DataTable, na mesma sequência em que as tabelas são exibidas na coleção Tables.Returns a DataTableReader with one result set per DataTable, in the same sequence as the tables appear in the Tables collection.

CreateDataReader(DataTable[])

Retorna um DataTableReader com um conjunto de resultados por DataTable.Returns a DataTableReader with one result set per DataTable.

DetermineSchemaSerializationMode(SerializationInfo, StreamingContext)

Determina o SchemaSerializationMode para um DataSet.Determines the SchemaSerializationMode for a DataSet.

DetermineSchemaSerializationMode(XmlReader)

Determina o SchemaSerializationMode para um DataSet.Determines the SchemaSerializationMode for a DataSet.

Dispose()

Libera todos os recursos usados pelo MarshalByValueComponent.Releases all resources used by the MarshalByValueComponent.

(Herdado de MarshalByValueComponent)
Dispose(Boolean)

Libera os recursos não gerenciados usados pelo MarshalByValueComponent e opcionalmente libera os recursos gerenciados.Releases the unmanaged resources used by the MarshalByValueComponent and optionally releases the managed resources.

(Herdado de MarshalByValueComponent)
EndInit()

Encerra a inicialização de um DataSet que é usado em um formulário ou por outro componente.Ends the initialization of a DataSet that is used on a form or used by another component. A inicialização ocorre no tempo de execução.The initialization occurs at run time.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetChanges()

Obtém uma cópia do DataSet que contém todas as alterações feitas nele desde que ele foi carregado ou desde que o AcceptChanges() foi chamado pela última vez.Gets a copy of the DataSet that contains all changes made to it since it was loaded or since AcceptChanges() was last called.

GetChanges(DataRowState)

Obtém uma cópia do DataSet que contém todas as alterações feitas desde o último carregamento ou desde que AcceptChanges() foi chamado, filtrado por DataRowState.Gets a copy of the DataSet containing all changes made to it since it was last loaded, or since AcceptChanges() was called, filtered by DataRowState.

GetDataSetSchema(XmlSchemaSet)

Obtém uma cópia de XmlSchemaSet para DataSet.Gets a copy of XmlSchemaSet for the DataSet.

GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetObjectData(SerializationInfo, StreamingContext)

Popula um objeto de informações de serialização com os dados necessários para serializar o DataSet.Populates a serialization information object with the data needed to serialize the DataSet.

GetSchemaSerializable()

Retorna uma instância XmlSchema serializável.Returns a serializable XmlSchema instance.

GetSerializationData(SerializationInfo, StreamingContext)

Desserializa os dados da tabela do fluxo XML ou binário.Deserializes the table data from the binary or XML stream.

GetService(Type)

Obtém o implementador do IServiceProvider.Gets the implementer of the IServiceProvider.

(Herdado de MarshalByValueComponent)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
GetXml()

Retorna a representação XML dos dados armazenados no DataSet.Returns the XML representation of the data stored in the DataSet.

GetXmlSchema()

Retorna o Esquema XML para a representação XML dos dados armazenados no DataSet.Returns the XML Schema for the XML representation of the data stored in the DataSet.

HasChanges()

Obtém um valor que indica se o DataSet tem alterações, incluindo linhas novas, excluídas ou modificadas.Gets a value indicating whether the DataSet has changes, including new, deleted, or modified rows.

HasChanges(DataRowState)

Obtém um valor que indica se o DataSet tem alterações, incluindo linhas novas, excluídas ou modificadas, filtradas por DataRowState.Gets a value indicating whether the DataSet has changes, including new, deleted, or modified rows, filtered by DataRowState.

InferXmlSchema(Stream, String[])

Aplica o esquema XML do Stream especificado ao DataSet.Applies the XML schema from the specified Stream to the DataSet.

InferXmlSchema(String, String[])

Aplica o esquema XML do arquivo especificado no DataSet.Applies the XML schema from the specified file to the DataSet.

InferXmlSchema(TextReader, String[])

Aplica o esquema XML do TextReader especificado ao DataSet.Applies the XML schema from the specified TextReader to the DataSet.

InferXmlSchema(XmlReader, String[])

Aplica o esquema XML do XmlReader especificado ao DataSet.Applies the XML schema from the specified XmlReader to the DataSet.

InitializeDerivedDataSet()

Desserialize todos os dados de tabelas do DataSet do fluxo XML ou binário.Deserialize all of the tables data of the DataSet from the binary or XML stream.

IsBinarySerialized(SerializationInfo, StreamingContext)

Inspeciona o formato da representação serializada do DataSet.Inspects the format of the serialized representation of the DataSet.

Load(IDataReader, LoadOption, DataTable[])

Preenche um DataSet com valores de uma fonte de dados usando o IDataReader fornecido, usando uma matriz de instâncias DataTable para fornecer o esquema e as informações de namespace.Fills a DataSet with values from a data source using the supplied IDataReader, using an array of DataTable instances to supply the schema and namespace information.

Load(IDataReader, LoadOption, FillErrorEventHandler, DataTable[])

Preenche um DataSet com valores de uma fonte de dados usando o IDataReader fornecido, usando uma matriz de instâncias DataTable para fornecer o esquema e as informações de namespace.Fills a DataSet with values from a data source using the supplied IDataReader, using an array of DataTable instances to supply the schema and namespace information.

Load(IDataReader, LoadOption, String[])

Preenche um DataSet com valores de uma fonte de dados usando o IDataReader, usando uma matriz de cadeias de caracteres para fornecer os nomes das tabelas dentro de DataSet.Fills a DataSet with values from a data source using the supplied IDataReader, using an array of strings to supply the names for the tables within the DataSet.

MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
Merge(DataRow[])

Mescla uma matriz de objetos DataRow no DataSet atual.Merges an array of DataRow objects into the current DataSet.

Merge(DataRow[], Boolean, MissingSchemaAction)

Mescla uma matriz de objetos DataRow no DataSet, preservando ou descartando alterações no DataSet atual e manipulando um esquema incompatível de acordo com os argumentos fornecidos.Merges an array of DataRow objects into the current DataSet, preserving or discarding changes in the DataSet and handling an incompatible schema according to the given arguments.

Merge(DataSet)

Mescla um DataSet especificado e seu esquema no DataSet atual.Merges a specified DataSet and its schema into the current DataSet.

Merge(DataSet, Boolean)

Mescla um DataSet especificado e seu esquema no DataSet atual, preservando ou descartando as alterações neste DataSet de acordo com o argumento determinado.Merges a specified DataSet and its schema into the current DataSet, preserving or discarding any changes in this DataSet according to the given argument.

Merge(DataSet, Boolean, MissingSchemaAction)

Mescla um DataSet especificado e seu esquema com o atual DataSet, preservando ou descartando alterações no DataSet atual e manipulando um esquema incompatível de acordo com os argumentos fornecidos.Merges a specified DataSet and its schema with the current DataSet, preserving or discarding changes in the current DataSet and handling an incompatible schema according to the given arguments.

Merge(DataTable)

Mescla um DataTable especificado e seu esquema no DataSet atual.Merges a specified DataTable and its schema into the current DataSet.

Merge(DataTable, Boolean, MissingSchemaAction)

Mescla um DataTable especificado e seu esquema com o atual DataSet, preservando ou descartando alterações no DataSet e manipulando um esquema incompatível de acordo com os argumentos fornecidos.Merges a specified DataTable and its schema into the current DataSet, preserving or discarding changes in the DataSet and handling an incompatible schema according to the given arguments.

OnPropertyChanging(PropertyChangedEventArgs)

Aciona o evento OnPropertyChanging(PropertyChangedEventArgs).Raises the OnPropertyChanging(PropertyChangedEventArgs) event.

OnRemoveRelation(DataRelation)

Ocorre quando um objeto DataRelation é removido de um DataTable.Occurs when a DataRelation object is removed from a DataTable.

OnRemoveTable(DataTable)

Ocorre quando um DataTable é removido de um DataSet.Occurs when a DataTable is removed from a DataSet.

RaisePropertyChanging(String)

Envia uma notificação de que a propriedade DataSet especificada está prestes a ser alterada.Sends a notification that the specified DataSet property is about to change.

ReadXml(Stream)

Lê o esquema XML e dados para o DataSet usando o Stream especificado.Reads XML schema and data into the DataSet using the specified Stream.

ReadXml(Stream, XmlReadMode)

Lê o esquema XML e os dados no DataSet usando o Stream e XmlReadMode especificados.Reads XML schema and data into the DataSet using the specified Stream and XmlReadMode.

ReadXml(String)

Lê o esquema XML e dados no DataSet usando o arquivo especificado.Reads XML schema and data into the DataSet using the specified file.

ReadXml(String, XmlReadMode)

Lê dados e o esquema XML no DataSet usando o arquivo especificado e XmlReadMode.Reads XML schema and data into the DataSet using the specified file and XmlReadMode.

ReadXml(TextReader)

Lê o esquema XML e dados para o DataSet usando o TextReader especificado.Reads XML schema and data into the DataSet using the specified TextReader.

ReadXml(TextReader, XmlReadMode)

Lê o esquema XML e os dados no DataSet usando o TextReader e XmlReadMode especificados.Reads XML schema and data into the DataSet using the specified TextReader and XmlReadMode.

ReadXml(XmlReader)

Lê o esquema XML e dados para o DataSet usando o XmlReader especificado.Reads XML schema and data into the DataSet using the specified XmlReader.

ReadXml(XmlReader, XmlReadMode)

Lê o esquema XML e os dados no DataSet usando o XmlReader e XmlReadMode especificados.Reads XML schema and data into the DataSet using the specified XmlReader and XmlReadMode.

ReadXmlSchema(Stream)

Lê o esquema XML do Stream especificado no DataSet.Reads the XML schema from the specified Stream into the DataSet.

ReadXmlSchema(String)

Lê o esquema XML do arquivo especificado no DataSet.Reads the XML schema from the specified file into the DataSet.

ReadXmlSchema(TextReader)

Lê o esquema XML do TextReader especificado no DataSet.Reads the XML schema from the specified TextReader into the DataSet.

ReadXmlSchema(XmlReader)

Lê o esquema XML do XmlReader especificado no DataSet.Reads the XML schema from the specified XmlReader into the DataSet.

ReadXmlSerializable(XmlReader)

Ignora os atributos e retorna um DataSet vazio.Ignores attributes and returns an empty DataSet.

RejectChanges()

Reverte todas as alterações feitas ao DataSet desde que foi criado ou desde a última vez em que o AcceptChanges() foi chamado.Rolls back all the changes made to the DataSet since it was created, or since the last time AcceptChanges() was called.

Reset()

Limpa todas as tabelas e remove todas as relações, restrições externas e tabelas de DataSet.Clears all tables and removes all relations, foreign constraints, and tables from the DataSet. As subclasses devem substituir Reset() para restaurar um DataSet ao seu estado original.Subclasses should override Reset() to restore a DataSet to its original state.

ShouldSerializeRelations()

Obtém um valor que indica se a propriedade Relations deve ser persistida.Gets a value indicating whether Relations property should be persisted.

ShouldSerializeTables()

Obtém um valor que indica se a propriedade Tables deve ser persistida.Gets a value indicating whether Tables property should be persisted.

ToString()

Retorna um String que contém o nome do Component, se houver.Returns a String containing the name of the Component, if any. Esse método não deve ser substituído.This method should not be overridden.

(Herdado de MarshalByValueComponent)
WriteXml(Stream)

Grava os dados atuais para o DataSet usando o Stream especificado.Writes the current data for the DataSet using the specified Stream.

WriteXml(Stream, XmlWriteMode)

Grava os dados atuais e, opcionalmente, o esquema do DataSet usando o Stream e o XmlWriteMode especificados.Writes the current data, and optionally the schema, for the DataSet using the specified Stream and XmlWriteMode. Para gravar o esquema, defina o valor do parâmetro mode como WriteSchema.To write the schema, set the value for the mode parameter to WriteSchema.

WriteXml(String)

Grava os dados atuais do DataSet no arquivo especificado.Writes the current data for the DataSet to the specified file.

WriteXml(String, XmlWriteMode)

Grava os dados atuais e, opcionalmente, o esquema do DataSet no arquivo especificado usando o XmlWriteMode especificado.Writes the current data, and optionally the schema, for the DataSet to the specified file using the specified XmlWriteMode. Para gravar o esquema, defina o valor do parâmetro mode como WriteSchema.To write the schema, set the value for the mode parameter to WriteSchema.

WriteXml(TextWriter)

Grava os dados atuais para o DataSet usando o TextWriter especificado.Writes the current data for the DataSet using the specified TextWriter.

WriteXml(TextWriter, XmlWriteMode)

Grava os dados atuais e, opcionalmente, o esquema do DataSet usando o TextWriter e o XmlWriteMode especificados.Writes the current data, and optionally the schema, for the DataSet using the specified TextWriter and XmlWriteMode. Para gravar o esquema, defina o valor do parâmetro mode como WriteSchema.To write the schema, set the value for the mode parameter to WriteSchema.

WriteXml(XmlWriter)

Grava os dados atuais do DataSet no XmlWriter especificado.Writes the current data for the DataSet to the specified XmlWriter.

WriteXml(XmlWriter, XmlWriteMode)

Grava os dados atuais e, opcionalmente, o esquema do DataSet usando o XmlWriter e o XmlWriteMode especificados.Writes the current data, and optionally the schema, for the DataSet using the specified XmlWriter and XmlWriteMode. Para gravar o esquema, defina o valor do parâmetro mode como WriteSchema.To write the schema, set the value for the mode parameter to WriteSchema.

WriteXmlSchema(Stream)

Grava a estrutura DataSet como um esquema XML no objeto Stream especificado.Writes the DataSet structure as an XML schema to the specified Stream object.

WriteXmlSchema(Stream, Converter<Type,String>)

Grava a estrutura DataSet como um esquema XML no objeto Stream especificado.Writes the DataSet structure as an XML schema to the specified Stream object.

WriteXmlSchema(String)

Grava a estrutura DataSet como um esquema XML em um arquivo.Writes the DataSet structure as an XML schema to a file.

WriteXmlSchema(String, Converter<Type,String>)

Grava a estrutura DataSet como um esquema XML em um arquivo.Writes the DataSet structure as an XML schema to a file.

WriteXmlSchema(TextWriter)

Grava a estrutura DataSet como um esquema XML no objeto TextWriter especificado.Writes the DataSet structure as an XML schema to the specified TextWriter object.

WriteXmlSchema(TextWriter, Converter<Type,String>)

Grava a estrutura DataSet como um esquema XML no TextWriter especificado.Writes the DataSet structure as an XML schema to the specified TextWriter.

WriteXmlSchema(XmlWriter)

Grava a estrutura DataSet como um esquema XML em um objeto XmlWriter.Writes the DataSet structure as an XML schema to an XmlWriter object.

WriteXmlSchema(XmlWriter, Converter<Type,String>)

Grava a estrutura DataSet como um esquema XML no XmlWriter especificado.Writes the DataSet structure as an XML schema to the specified XmlWriter.

Eventos

Disposed

Adiciona um manipulador de eventos para escutar o evento Disposed no componente.Adds an event handler to listen to the Disposed event on the component.

(Herdado de MarshalByValueComponent)
Initialized

Ocorre após o DataSet ser inicializado.Occurs after the DataSet is initialized.

MergeFailed

Ocorre quando uma origem e um destino DataRow têm o mesmo valor de chave primária e EnforceConstraints é definido como true.Occurs when a target and source DataRow have the same primary key value, and EnforceConstraints is set to true.

Implantações explícitas de interface

IListSource.ContainsListCollection

Para obter uma descrição desse membro, consulte ContainsListCollection.For a description of this member, see ContainsListCollection.

IListSource.GetList()

Para obter uma descrição desse membro, consulte GetList().For a description of this member, see GetList().

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Popula um objeto de informações de serialização com os dados necessários para serializar o DataSet.Populates a serialization information object with the data needed to serialize the DataSet.

IXmlSerializable.GetSchema()

Para obter uma descrição desse membro, consulte GetSchema().For a description of this member, see GetSchema().

IXmlSerializable.ReadXml(XmlReader)

Para obter uma descrição desse membro, consulte ReadXml(XmlReader).For a description of this member, see ReadXml(XmlReader).

IXmlSerializable.WriteXml(XmlWriter)

Para obter uma descrição desse membro, consulte WriteXml(XmlWriter).For a description of this member, see WriteXml(XmlWriter).

Aplica-se a

Acesso thread-safe

Este tipo é seguro para operações de leitura e multithread.This type is safe for multithreaded read operations. Você deve sincronizar todas as operações de gravação.You must synchronize any write operations.

Veja também