DataSet DataSet DataSet DataSet Class

Definición

Representa una caché de datos en memoria.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
Herencia
Atributos
Implementaciones

Ejemplos

El ejemplo siguiente consta de varios métodos que, combinados, crean y rellenan a DataSet partir de la base de datos 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

Comentarios

DataSet, Que es una caché en memoria de los datos recuperados de un origen de datos, es un componente importante de la arquitectura 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. Se compone de una colección de DataTable objetos que se pueden relacionar entre sí con DataRelation objetos. DataSetThe DataSet consists of a collection of DataTable objects that you can relate to each other with DataRelation objects. También puede aplicar la integridad de los datos DataSet en mediante los UniqueConstraint objetos ForeignKeyConstraint y.You can also enforce data integrity in the DataSet by using the UniqueConstraint and ForeignKeyConstraint objects. Para obtener más información sobre cómo DataSet trabajar con objetos, vea conjuntos de datos , DataTables yobjetos de datos.For further details about working with DataSet objects, see DataSets, DataTables, and DataViews.

Mientras DataTable que los objetos contienen los datos DataRelationCollection , le permite navegar por la jerarquía de la tabla.Whereas DataTable objects contain the data, the DataRelationCollection allows you to navigate though the table hierarchy. Las tablas están contenidas DataTableCollection en un al que Tables se tiene acceso a través de la propiedad.The tables are contained in a DataTableCollection accessed through the Tables property. Al tener acceso DataTable a los objetos, tenga en cuenta que distinguen mayúsculas de minúsculas.When accessing DataTable objects, note that they are conditionally case sensitive. Por ejemplo, si DataTable se denomina "mydatatable" y otro se denomina "mydatatable", se considera que una cadena utilizada para buscar una de las tablas distingue entre mayúsculas y 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. Sin embargo, si "mydatatable" existe y "mydatatable" no, se considera que la cadena de búsqueda no distingue mayúsculas de minúsculas.However, if "mydatatable" exists and "Mydatatable" does not, the search string is regarded as case insensitive. Para obtener más información sobre cómo DataTable trabajar con objetos, vea crear un DataTable.For more information about working with DataTable objects, see Creating a DataTable.

DataSet Puede leer y escribir datos y esquemas como documentos XML.A DataSet can read and write data and schema as XML documents. Los datos y el esquema se pueden transportar a través de HTTP y usar cualquier aplicación, en cualquier plataforma que esté 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. Puede guardar el esquema como un esquema XML con el WriteXmlSchema método, y tanto el esquema como los datos se pueden guardar con el WriteXml 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 leer un documento XML que incluye el esquema y los datos, use ReadXml el método.To read an XML document that includes both schema and data, use the ReadXml method.

En una implementación típica de varios niveles, los pasos para crear y actualizar un DataSety, a su vez, actualizar los datos originales son:In a typical multiple-tier implementation, the steps for creating and refreshing a DataSet, and in turn, updating the original data are to:

  1. Compilar y DataTable rellenar cada en un DataSet con datos de DataAdapterun origen de datos mediante.Build and fill each DataTable in a DataSet with data from a data source using a DataAdapter.

  2. Cambiar los datos de objetos DataTable individuales agregando, actualizando o DataRow eliminando objetos.Change the data in individual DataTable objects by adding, updating, or deleting DataRow objects.

  3. Invoque GetChanges el método para crear un DataSet segundo que solo incluye los cambios en los datos.Invoke the GetChanges method to create a second DataSet that features only the changes to the data.

  4. Llame al Update método DataAdapterde, pasando el segundo DataSet como argumento.Call the Update method of the DataAdapter, passing the second DataSet as an argument.

  5. Invoque Merge el método para combinar los cambios del segundo DataSet en el primero.Invoke the Merge method to merge the changes from the second DataSet into the first.

  6. Invoca el AcceptChanges DataSeten.Invoke the AcceptChanges on the DataSet. También puede invocar RejectChanges para cancelar los cambios.Alternatively, invoke RejectChanges to cancel the changes.

Nota

Los DataSet objetos DataTable y heredan MarshalByValueComponentde y admiten ISerializable la interfaz para la comunicación remota.The DataSet and DataTable objects inherit from MarshalByValueComponent, and support the ISerializable interface for remoting. Éstos son los únicos objetos ADO.NET a los que se puede tener acceso remoto.These are the only ADO.NET objects that can be remoted.

Nota

El recolector DataSet de elementos no utilizados no finaliza las clases heredadas de, porque el finalizador se ha DataSetsuprimido en.Classes inherited from DataSet are not finalized by the garbage collector, because the finalizer has been suppressed in DataSet. La clase derivada puede llamar al ReRegisterForFinalize método en su constructor para permitir que el recolector de elementos no utilizados finalice la clase.The derived class can call the ReRegisterForFinalize method in its constructor to allow the class to be finalized by the garbage collector.

Constructores

DataSet() DataSet() DataSet() DataSet()

Inicializa una nueva instancia de la clase DataSet.Initializes a new instance of the DataSet class.

DataSet(SerializationInfo, StreamingContext) DataSet(SerializationInfo, StreamingContext) DataSet(SerializationInfo, StreamingContext) DataSet(SerializationInfo, StreamingContext)

Inicializa una nueva instancia de una clase DataSet que contiene la información de serialización y el contexto especificados.Initializes a new instance of a DataSet class that has the given serialization information and context.

DataSet(SerializationInfo, StreamingContext, Boolean) DataSet(SerializationInfo, StreamingContext, Boolean) DataSet(SerializationInfo, StreamingContext, Boolean) DataSet(SerializationInfo, StreamingContext, Boolean)

Inicializa una nueva instancia de la clase DataSet.Initializes a new instance of the DataSet class.

DataSet(String) DataSet(String) DataSet(String) DataSet(String)

Inicializa una nueva instancia de una clase DataSet con el nombre dado.Initializes a new instance of a DataSet class with the given name.

Propiedades

CaseSensitive CaseSensitive CaseSensitive CaseSensitive

Obtiene o establece un valor que indica si las comparaciones de cadena en los objetos DataTable distinguen entre mayúsculas y minúsculas.Gets or sets a value indicating whether string comparisons within DataTable objects are case-sensitive.

Container Container Container Container

Obtiene el contenedor del componente.Gets the container for the component.

(Inherited from MarshalByValueComponent)
DataSetName DataSetName DataSetName DataSetName

Obtiene o establece el nombre del objeto DataSet actual.Gets or sets the name of the current DataSet.

DefaultViewManager DefaultViewManager DefaultViewManager DefaultViewManager

Obtiene una vista personalizada de los datos incluidos en DataSet, lo que permite filtrar, buscar y navegar mediante un DataViewManager personalizado.Gets a custom view of the data contained in the DataSet to allow filtering, searching, and navigating using a custom DataViewManager.

DesignMode DesignMode DesignMode DesignMode

Obtiene un valor que indica si el componente está actualmente en modo de diseño.Gets a value indicating whether the component is currently in design mode.

(Inherited from MarshalByValueComponent)
EnforceConstraints EnforceConstraints EnforceConstraints EnforceConstraints

Obtiene o establece un valor que indica si se siguen las reglas de restricción al intentar realizar cualquier operación de actualización.Gets or sets a value indicating whether constraint rules are followed when attempting any update operation.

Events Events Events Events

Obtiene la lista de controladores de eventos asociados a este componente.Gets the list of event handlers that are attached to this component.

(Inherited from MarshalByValueComponent)
ExtendedProperties ExtendedProperties ExtendedProperties ExtendedProperties

Obtiene la colección de la información personalizada del usuario asociada a DataSet.Gets the collection of customized user information associated with the DataSet.

HasErrors HasErrors HasErrors HasErrors

Obtiene un valor que indica si hay errores en alguno de los objetos DataTable de este DataSet.Gets a value indicating whether there are errors in any of the DataTable objects within this DataSet.

IsInitialized IsInitialized IsInitialized IsInitialized

Obtiene un valor que indica si el objeto DataSet está inicializado.Gets a value that indicates whether the DataSet is initialized.

Locale Locale Locale Locale

Obtiene o establece la información de configuración regional que se utiliza para comparar cadenas de la tabla.Gets or sets the locale information used to compare strings within the table.

Namespace Namespace Namespace Namespace

Obtiene o establece el espacio de nombres del objeto DataSet.Gets or sets the namespace of the DataSet.

Prefix Prefix Prefix Prefix

Obtiene o establece un prefijo XML que crea alias para el espacio de nombres del objeto DataSet.Gets or sets an XML prefix that aliases the namespace of the DataSet.

Relations Relations Relations Relations

Obtiene la colección de relaciones que vincula las tablas y permite la navegación desde las tablas primarias a las secundarias.Gets the collection of relations that link tables and allow navigation from parent tables to child tables.

RemotingFormat RemotingFormat RemotingFormat RemotingFormat

Obtiene o establece una enumeración SerializationFormat para el objeto DataSet utilizado durante la comunicación remota.Gets or sets a SerializationFormat for the DataSet used during remoting.

SchemaSerializationMode SchemaSerializationMode SchemaSerializationMode SchemaSerializationMode

Obtiene o establece una enumeración SchemaSerializationMode para un objeto DataSet.Gets or sets a SchemaSerializationMode for a DataSet.

Site Site Site Site

Obtiene o establece una interfaz ISite para el objeto DataSet.Gets or sets an ISite for the DataSet.

Tables Tables Tables Tables

Obtiene la colección de tablas incluidas en DataSet.Gets the collection of tables contained in the DataSet.

Métodos

AcceptChanges() AcceptChanges() AcceptChanges() AcceptChanges()

Confirma todos los cambios realizados en este DataSet desde que se ha cargado o desde la última vez que se ha llamado a AcceptChanges().Commits all the changes made to this DataSet since it was loaded or since the last time AcceptChanges() was called.

BeginInit() BeginInit() BeginInit() BeginInit()

Activa la inicialización de un objeto DataSet que se emplea en un formulario o que utiliza otro componente.Begins the initialization of a DataSet that is used on a form or used by another component. La inicialización se produce en tiempo de ejecución.The initialization occurs at run time.

Clear() Clear() Clear() Clear()

Borra cualquier dato de DataSet mediante el procedimiento de quitar todas las filas de todas las tablas.Clears the DataSet of any data by removing all rows in all tables.

Clone() Clone() Clone() Clone()

Copia la estructura de DataSet, incluidos todos los esquemas, relaciones y restricciones de DataTable.Copies the structure of the DataSet, including all DataTable schemas, relations, and constraints. No copia ningún dato.Does not copy any data.

Copy() Copy() Copy() Copy()

Copia la estructura y los datos para este objeto DataSet.Copies both the structure and data for this DataSet.

CreateDataReader() CreateDataReader() CreateDataReader() CreateDataReader()

Devuelve un objeto DataTableReader con un conjunto de resultados por cada DataTable, siguiendo la misma secuencia con la que aparecen las tablas en la colección Tables.Returns a DataTableReader with one result set per DataTable, in the same sequence as the tables appear in the Tables collection.

CreateDataReader(DataTable[]) CreateDataReader(DataTable[]) CreateDataReader(DataTable[]) CreateDataReader(DataTable[])

Devuelve un objeto DataTableReader con un conjunto de resultados por cada DataTable.Returns a DataTableReader with one result set per DataTable.

DetermineSchemaSerializationMode(SerializationInfo, StreamingContext) DetermineSchemaSerializationMode(SerializationInfo, StreamingContext) DetermineSchemaSerializationMode(SerializationInfo, StreamingContext) DetermineSchemaSerializationMode(SerializationInfo, StreamingContext)

Determina la propiedad SchemaSerializationMode para un objeto DataSet.Determines the SchemaSerializationMode for a DataSet.

DetermineSchemaSerializationMode(XmlReader) DetermineSchemaSerializationMode(XmlReader) DetermineSchemaSerializationMode(XmlReader) DetermineSchemaSerializationMode(XmlReader)

Determina la propiedad SchemaSerializationMode para un objeto DataSet.Determines the SchemaSerializationMode for a DataSet.

Dispose() Dispose() Dispose() Dispose()

Libera todos los recursos que usa MarshalByValueComponent.Releases all resources used by the MarshalByValueComponent.

(Inherited from MarshalByValueComponent)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Libera los recursos no administrados que usa MarshalByValueComponent y, de forma opcional, libera los recursos administrados.Releases the unmanaged resources used by the MarshalByValueComponent and optionally releases the managed resources.

(Inherited from MarshalByValueComponent)
EndInit() EndInit() EndInit() EndInit()

Finaliza la inicialización de un objeto DataSet que se emplea en un formulario o que utiliza otro componente.Ends the initialization of a DataSet that is used on a form or used by another component. La inicialización se produce en tiempo de ejecución.The initialization occurs at run time.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetChanges() GetChanges() GetChanges() GetChanges()

Obtiene una copia del objeto DataSet que contiene todos los cambios que se le han realizado desde que se cargó o se llamó a AcceptChanges() por ú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) GetChanges(DataRowState) GetChanges(DataRowState) GetChanges(DataRowState)

Obtiene una copia del objeto DataSet que contiene todos los cambios que se le han realizado desde la última vez que se cargó, o desde que se llamó a AcceptChanges(), 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) GetDataSetSchema(XmlSchemaSet) GetDataSetSchema(XmlSchemaSet) GetDataSetSchema(XmlSchemaSet)

Obtiene una copia de XmlSchemaSet para el conjunto de datos.Gets a copy of XmlSchemaSet for the DataSet.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext)

Rellena un objeto de información de serialización con los datos necesarios para serializar DataSet.Populates a serialization information object with the data needed to serialize the DataSet.

GetSchemaSerializable() GetSchemaSerializable() GetSchemaSerializable() GetSchemaSerializable()

Devuelve una instancia serializable de XmlSchema.Returns a serializable XmlSchema instance.

GetSerializationData(SerializationInfo, StreamingContext) GetSerializationData(SerializationInfo, StreamingContext) GetSerializationData(SerializationInfo, StreamingContext) GetSerializationData(SerializationInfo, StreamingContext)

Deserializa los datos de la tabla a partir de la secuencia binaria o XML.Deserializes the table data from the binary or XML stream.

GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Obtiene el implementador de IServiceProvider.Gets the implementer of the IServiceProvider.

(Inherited from MarshalByValueComponent)
GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
GetXml() GetXml() GetXml() GetXml()

Devuelve la representación XML de los datos almacenados en DataSet.Returns the XML representation of the data stored in the DataSet.

GetXmlSchema() GetXmlSchema() GetXmlSchema() GetXmlSchema()

Devuelve el esquema XML para la representación XML de los datos almacenados en DataSet.Returns the XML Schema for the XML representation of the data stored in the DataSet.

HasChanges() HasChanges() HasChanges() HasChanges()

Obtiene un valor que indica si DataSet presenta cambios, incluyendo filas nuevas, eliminadas o modificadas.Gets a value indicating whether the DataSet has changes, including new, deleted, or modified rows.

HasChanges(DataRowState) HasChanges(DataRowState) HasChanges(DataRowState) HasChanges(DataRowState)

Obtiene un valor que indica si DataSet presenta cambios, incluidas filas nuevas, eliminadas o modificadas, filtrados por DataRowState.Gets a value indicating whether the DataSet has changes, including new, deleted, or modified rows, filtered by DataRowState.

InferXmlSchema(Stream, String[]) InferXmlSchema(Stream, String[]) InferXmlSchema(Stream, String[]) InferXmlSchema(Stream, String[])

Aplica el esquema XML del objeto Stream especificado al objeto DataSet.Applies the XML schema from the specified Stream to the DataSet.

InferXmlSchema(String, String[]) InferXmlSchema(String, String[]) InferXmlSchema(String, String[]) InferXmlSchema(String, String[])

Aplica el esquema XML del archivo especificado al DataSet.Applies the XML schema from the specified file to the DataSet.

InferXmlSchema(TextReader, String[]) InferXmlSchema(TextReader, String[]) InferXmlSchema(TextReader, String[]) InferXmlSchema(TextReader, String[])

Aplica el esquema XML del objeto TextReader especificado al objeto DataSet.Applies the XML schema from the specified TextReader to the DataSet.

InferXmlSchema(XmlReader, String[]) InferXmlSchema(XmlReader, String[]) InferXmlSchema(XmlReader, String[]) InferXmlSchema(XmlReader, String[])

Aplica el esquema XML del objeto XmlReader especificado al objeto DataSet.Applies the XML schema from the specified XmlReader to the DataSet.

InitializeDerivedDataSet() InitializeDerivedDataSet() InitializeDerivedDataSet() InitializeDerivedDataSet()

Deserializa todos los datos de tablas del conjunto de datos a partir de la secuencia binaria o XML.Deserialize all of the tables data of the DataSet from the binary or XML stream.

IsBinarySerialized(SerializationInfo, StreamingContext) IsBinarySerialized(SerializationInfo, StreamingContext) IsBinarySerialized(SerializationInfo, StreamingContext) IsBinarySerialized(SerializationInfo, StreamingContext)

Inspecciona el formato de la representación serializada de DataSet.Inspects the format of the serialized representation of the DataSet.

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

Rellena un objeto DataSet de valores de un origen de datos utilizando la interfaz IDataReader proporcionada, que usa una matriz de instancias de DataTable para suministrar la información sobre el espacio de nombres y el esquema.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[]) Load(IDataReader, LoadOption, FillErrorEventHandler, DataTable[]) Load(IDataReader, LoadOption, FillErrorEventHandler, DataTable[]) Load(IDataReader, LoadOption, FillErrorEventHandler, DataTable[])

Rellena un objeto DataSet de valores de un origen de datos utilizando la interfaz IDataReader proporcionada, que usa una matriz de instancias de DataTable para suministrar la información sobre el espacio de nombres y el esquema.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[]) Load(IDataReader, LoadOption, String[]) Load(IDataReader, LoadOption, String[]) Load(IDataReader, LoadOption, String[])

Rellena un objeto DataSet de valores de un origen de datos utilizando la interfaz IDataReader proporcionada, que usa una matriz de cadenas para suministrar los nombres para las tablas 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() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
Merge(DataRow[]) Merge(DataRow[]) Merge(DataRow[]) Merge(DataRow[])

Combina una matriz de objetos DataRow en el DataSet actual.Merges an array of DataRow objects into the current DataSet.

Merge(DataRow[], Boolean, MissingSchemaAction) Merge(DataRow[], Boolean, MissingSchemaAction) Merge(DataRow[], Boolean, MissingSchemaAction) Merge(DataRow[], Boolean, MissingSchemaAction)

Combina una matriz de objetos DataRow en el DataSet actual, conservando o descartando los cambios efectuados en el DataSet y controlando un esquema incompatible de acuerdo con los argumentos especificados.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) Merge(DataSet) Merge(DataSet) Merge(DataSet)

Combina un objeto DataSet especificado y su esquema en el objeto DataSet actual.Merges a specified DataSet and its schema into the current DataSet.

Merge(DataSet, Boolean) Merge(DataSet, Boolean) Merge(DataSet, Boolean) Merge(DataSet, Boolean)

Combina un DataSet y su esquema en el DataSet actual, conservando o descartando cualquier cambio efectuado en este DataSet de acuerdo con el argumento especificado.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) Merge(DataSet, Boolean, MissingSchemaAction) Merge(DataSet, Boolean, MissingSchemaAction) Merge(DataSet, Boolean, MissingSchemaAction)

Combina un DataSet especificado y su esquema con el DataSet actual, conservando o descartando los cambios efectuados en el DataSet actual y controlando un esquema incompatible de acuerdo con los argumentos especificados.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) Merge(DataTable) Merge(DataTable) Merge(DataTable)

Combina un objeto DataTable especificado y su esquema en el objeto DataSet actual.Merges a specified DataTable and its schema into the current DataSet.

Merge(DataTable, Boolean, MissingSchemaAction) Merge(DataTable, Boolean, MissingSchemaAction) Merge(DataTable, Boolean, MissingSchemaAction) Merge(DataTable, Boolean, MissingSchemaAction)

Combina un DataTable especificado y su esquema en el DataSet actual, conservando o descartando los cambios efectuados en el DataSet y controlando un esquema incompatible de acuerdo con los argumentos especificados.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) OnPropertyChanging(PropertyChangedEventArgs) OnPropertyChanging(PropertyChangedEventArgs) OnPropertyChanging(PropertyChangedEventArgs)

Genera el evento OnPropertyChanging(PropertyChangedEventArgs).Raises the OnPropertyChanging(PropertyChangedEventArgs) event.

OnRemoveRelation(DataRelation) OnRemoveRelation(DataRelation) OnRemoveRelation(DataRelation) OnRemoveRelation(DataRelation)

Se produce cuando se quita un objeto DataRelation de un DataTable.Occurs when a DataRelation object is removed from a DataTable.

OnRemoveTable(DataTable) OnRemoveTable(DataTable) OnRemoveTable(DataTable) OnRemoveTable(DataTable)

Se produce cuando se quita un DataTable de un DataSet.Occurs when a DataTable is removed from a DataSet.

RaisePropertyChanging(String) RaisePropertyChanging(String) RaisePropertyChanging(String) RaisePropertyChanging(String)

Envía una notificación que indica que se va a cambiar la propiedad especificada de DataSet.Sends a notification that the specified DataSet property is about to change.

ReadXml(Stream) ReadXml(Stream) ReadXml(Stream) ReadXml(Stream)

Lee los datos y el esquema XML en el objeto DataSet mediante el objeto Stream especificado.Reads XML schema and data into the DataSet using the specified Stream.

ReadXml(Stream, XmlReadMode) ReadXml(Stream, XmlReadMode) ReadXml(Stream, XmlReadMode) ReadXml(Stream, XmlReadMode)

Lee el esquema y los datos XML del objeto DataSet mediante el objeto Stream y la enumeración XmlReadMode especificados.Reads XML schema and data into the DataSet using the specified Stream and XmlReadMode.

ReadXml(String) ReadXml(String) ReadXml(String) ReadXml(String)

Lee el esquema y los datos XML del DataSet mediante el archivo especificado.Reads XML schema and data into the DataSet using the specified file.

ReadXml(String, XmlReadMode) ReadXml(String, XmlReadMode) ReadXml(String, XmlReadMode) ReadXml(String, XmlReadMode)

Lee el esquema y los datos XML del DataSet mediante el archivo y el XmlReadMode especificados.Reads XML schema and data into the DataSet using the specified file and XmlReadMode.

ReadXml(TextReader) ReadXml(TextReader) ReadXml(TextReader) ReadXml(TextReader)

Lee los datos y el esquema XML en el objeto DataSet mediante el objeto TextReader especificado.Reads XML schema and data into the DataSet using the specified TextReader.

ReadXml(TextReader, XmlReadMode) ReadXml(TextReader, XmlReadMode) ReadXml(TextReader, XmlReadMode) ReadXml(TextReader, XmlReadMode)

Lee el esquema y los datos XML del objeto DataSet mediante el objeto TextReader y la enumeración XmlReadMode especificados.Reads XML schema and data into the DataSet using the specified TextReader and XmlReadMode.

ReadXml(XmlReader) ReadXml(XmlReader) ReadXml(XmlReader) ReadXml(XmlReader)

Lee los datos y el esquema XML en el objeto DataSet mediante el objeto XmlReader especificado.Reads XML schema and data into the DataSet using the specified XmlReader.

ReadXml(XmlReader, XmlReadMode) ReadXml(XmlReader, XmlReadMode) ReadXml(XmlReader, XmlReadMode) ReadXml(XmlReader, XmlReadMode)

Lee el esquema y los datos XML del objeto DataSet mediante el objeto XmlReader y la enumeración XmlReadMode especificados.Reads XML schema and data into the DataSet using the specified XmlReader and XmlReadMode.

ReadXmlSchema(Stream) ReadXmlSchema(Stream) ReadXmlSchema(Stream) ReadXmlSchema(Stream)

Lee el esquema XML del objeto Stream especificado en el objeto DataSet.Reads the XML schema from the specified Stream into the DataSet.

ReadXmlSchema(String) ReadXmlSchema(String) ReadXmlSchema(String) ReadXmlSchema(String)

Lee el esquema XML del archivo especificado en el DataSet.Reads the XML schema from the specified file into the DataSet.

ReadXmlSchema(TextReader) ReadXmlSchema(TextReader) ReadXmlSchema(TextReader) ReadXmlSchema(TextReader)

Lee el esquema XML del objeto TextReader especificado en el objeto DataSet.Reads the XML schema from the specified TextReader into the DataSet.

ReadXmlSchema(XmlReader) ReadXmlSchema(XmlReader) ReadXmlSchema(XmlReader) ReadXmlSchema(XmlReader)

Lee el esquema XML del objeto XmlReader especificado en el objeto DataSet.Reads the XML schema from the specified XmlReader into the DataSet.

ReadXmlSerializable(XmlReader) ReadXmlSerializable(XmlReader) ReadXmlSerializable(XmlReader) ReadXmlSerializable(XmlReader)

Omite los atributos y devuelve un conjunto de datos vacío.Ignores attributes and returns an empty DataSet.

RejectChanges() RejectChanges() RejectChanges() RejectChanges()

Deshace todos los cambios realizados en el DataSet desde que se ha creado o desde que se ha llamado por última vez a AcceptChanges().Rolls back all the changes made to the DataSet since it was created, or since the last time AcceptChanges() was called.

Reset() Reset() Reset() Reset()

Borra todas las tablas y quita todas las relaciones, restricciones externas y tablas de DataSet.Clears all tables and removes all relations, foreign constraints, and tables from the DataSet. Las subclases deben reemplazar a Reset() para restaurar el estado original de un DataSet.Subclasses should override Reset() to restore a DataSet to its original state.

ShouldSerializeRelations() ShouldSerializeRelations() ShouldSerializeRelations() ShouldSerializeRelations()

Obtiene un valor que indica si se debe conservar la propiedad Relations.Gets a value indicating whether Relations property should be persisted.

ShouldSerializeTables() ShouldSerializeTables() ShouldSerializeTables() ShouldSerializeTables()

Obtiene un valor que indica si se debe conservar la propiedad Tables.Gets a value indicating whether Tables property should be persisted.

ToString() ToString() ToString() ToString()

Devuelve una String que contiene el nombre del Component, si existe.Returns a String containing the name of the Component, if any. Este método no se debe invalidar.This method should not be overridden.

(Inherited from MarshalByValueComponent)
WriteXml(Stream) WriteXml(Stream) WriteXml(Stream) WriteXml(Stream)

Escribe los datos actuales para el objeto DataSet mediante el objeto Stream especificado.Writes the current data for the DataSet using the specified Stream.

WriteXml(Stream, XmlWriteMode) WriteXml(Stream, XmlWriteMode) WriteXml(Stream, XmlWriteMode) WriteXml(Stream, XmlWriteMode)

Escribe los datos actuales y, de forma opcional, el esquema para el objeto DataSet mediante el objeto Stream y la enumeración XmlWriteMode especificados.Writes the current data, and optionally the schema, for the DataSet using the specified Stream and XmlWriteMode. Para escribir el esquema, establezca el valor del parámetro mode en WriteSchema.To write the schema, set the value for the mode parameter to WriteSchema.

WriteXml(String) WriteXml(String) WriteXml(String) WriteXml(String)

Escribe los datos actuales para el DataSet en el archivo especificado.Writes the current data for the DataSet to the specified file.

WriteXml(String, XmlWriteMode) WriteXml(String, XmlWriteMode) WriteXml(String, XmlWriteMode) WriteXml(String, XmlWriteMode)

Escribe los datos actuales y, de forma opcional, el esquema para el objeto DataSet en el archivo indicado mediante la enumeración XmlWriteMode especificada.Writes the current data, and optionally the schema, for the DataSet to the specified file using the specified XmlWriteMode. Para escribir el esquema, establezca el valor del parámetro mode en WriteSchema.To write the schema, set the value for the mode parameter to WriteSchema.

WriteXml(TextWriter) WriteXml(TextWriter) WriteXml(TextWriter) WriteXml(TextWriter)

Escribe los datos actuales para el objeto DataSet mediante el objeto TextWriter especificado.Writes the current data for the DataSet using the specified TextWriter.

WriteXml(TextWriter, XmlWriteMode) WriteXml(TextWriter, XmlWriteMode) WriteXml(TextWriter, XmlWriteMode) WriteXml(TextWriter, XmlWriteMode)

Escribe los datos actuales y, de forma opcional, el esquema para el objeto DataSet mediante el objeto TextWriter y la enumeración XmlWriteMode especificados.Writes the current data, and optionally the schema, for the DataSet using the specified TextWriter and XmlWriteMode. Para escribir el esquema, establezca el valor del parámetro mode en WriteSchema.To write the schema, set the value for the mode parameter to WriteSchema.

WriteXml(XmlWriter) WriteXml(XmlWriter) WriteXml(XmlWriter) WriteXml(XmlWriter)

Escribe los datos actuales para el DataSet en el XmlWriter especificado.Writes the current data for the DataSet to the specified XmlWriter.

WriteXml(XmlWriter, XmlWriteMode) WriteXml(XmlWriter, XmlWriteMode) WriteXml(XmlWriter, XmlWriteMode) WriteXml(XmlWriter, XmlWriteMode)

Escribe los datos actuales y, de forma opcional, el esquema para el objeto DataSet mediante el objeto XmlWriter y la enumeración XmlWriteMode especificados.Writes the current data, and optionally the schema, for the DataSet using the specified XmlWriter and XmlWriteMode. Para escribir el esquema, establezca el valor del parámetro mode en WriteSchema.To write the schema, set the value for the mode parameter to WriteSchema.

WriteXmlSchema(Stream) WriteXmlSchema(Stream) WriteXmlSchema(Stream) WriteXmlSchema(Stream)

Escribe la estructura DataSet como un esquema XML al objeto Stream especificado.Writes the DataSet structure as an XML schema to the specified Stream object.

WriteXmlSchema(Stream, Converter<Type,String>) WriteXmlSchema(Stream, Converter<Type,String>) WriteXmlSchema(Stream, Converter<Type,String>) WriteXmlSchema(Stream, Converter<Type,String>)

Escribe la estructura DataSet como un esquema XML al objeto Stream especificado.Writes the DataSet structure as an XML schema to the specified Stream object.

WriteXmlSchema(String) WriteXmlSchema(String) WriteXmlSchema(String) WriteXmlSchema(String)

Escribe la estructura del DataSet como un esquema XML en un archivo.Writes the DataSet structure as an XML schema to a file.

WriteXmlSchema(String, Converter<Type,String>) WriteXmlSchema(String, Converter<Type,String>) WriteXmlSchema(String, Converter<Type,String>) WriteXmlSchema(String, Converter<Type,String>)

Escribe la estructura del DataSet como un esquema XML en un archivo.Writes the DataSet structure as an XML schema to a file.

WriteXmlSchema(TextWriter) WriteXmlSchema(TextWriter) WriteXmlSchema(TextWriter) WriteXmlSchema(TextWriter)

Escribe la estructura DataSet como un esquema XML al objeto TextWriter especificado.Writes the DataSet structure as an XML schema to the specified TextWriter object.

WriteXmlSchema(TextWriter, Converter<Type,String>) WriteXmlSchema(TextWriter, Converter<Type,String>) WriteXmlSchema(TextWriter, Converter<Type,String>) WriteXmlSchema(TextWriter, Converter<Type,String>)

Escribe la estructura de DataSet como un esquema XML en el objeto TextWriter especificado.Writes the DataSet structure as an XML schema to the specified TextWriter.

WriteXmlSchema(XmlWriter) WriteXmlSchema(XmlWriter) WriteXmlSchema(XmlWriter) WriteXmlSchema(XmlWriter)

Escribe la estructura del DataSet como un esquema XML en un objeto XmlWriter.Writes the DataSet structure as an XML schema to an XmlWriter object.

WriteXmlSchema(XmlWriter, Converter<Type,String>) WriteXmlSchema(XmlWriter, Converter<Type,String>) WriteXmlSchema(XmlWriter, Converter<Type,String>) WriteXmlSchema(XmlWriter, Converter<Type,String>)

Escribe la estructura de DataSet como un esquema XML en el objeto XmlWriter especificado.Writes the DataSet structure as an XML schema to the specified XmlWriter.

Eventos

Disposed Disposed Disposed Disposed

Agrega un controlador de eventos para escuchar el evento Disposed en el componente.Adds an event handler to listen to the Disposed event on the component.

(Inherited from MarshalByValueComponent)
Initialized Initialized Initialized Initialized

Se produce después de inicializar DataSet.Occurs after the DataSet is initialized.

MergeFailed MergeFailed MergeFailed MergeFailed

Se produce cuando unos DataRow de origen y de destino tienen el mismo valor de clave principal y EnforceConstraints se establece en true.Occurs when a target and source DataRow have the same primary key value, and EnforceConstraints is set to true.

Implementaciones de interfaz explícitas

IListSource.ContainsListCollection IListSource.ContainsListCollection IListSource.ContainsListCollection IListSource.ContainsListCollection

Para obtener una descripción de este miembro, vea ContainsListCollection.For a description of this member, see ContainsListCollection.

IListSource.GetList() IListSource.GetList() IListSource.GetList() IListSource.GetList()

Para obtener una descripción de este miembro, vea GetList().For a description of this member, see GetList().

ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Rellena un objeto de información de serialización con los datos necesarios para serializar DataSet.Populates a serialization information object with the data needed to serialize the DataSet.

IXmlSerializable.GetSchema() IXmlSerializable.GetSchema() IXmlSerializable.GetSchema() IXmlSerializable.GetSchema()

Para una descripción de este miembro, vea GetSchema().For a description of this member, see GetSchema().

IXmlSerializable.ReadXml(XmlReader) IXmlSerializable.ReadXml(XmlReader) IXmlSerializable.ReadXml(XmlReader) IXmlSerializable.ReadXml(XmlReader)

Para una descripción de este miembro, vea ReadXml(XmlReader).For a description of this member, see ReadXml(XmlReader).

IXmlSerializable.WriteXml(XmlWriter) IXmlSerializable.WriteXml(XmlWriter) IXmlSerializable.WriteXml(XmlWriter) IXmlSerializable.WriteXml(XmlWriter)

Para una descripción de este miembro, vea WriteXml(XmlWriter).For a description of this member, see WriteXml(XmlWriter).

Se aplica a

Seguridad para subprocesos

Este tipo es seguro para las operaciones de lectura multiproceso.This type is safe for multithreaded read operations. Debe sincronizar cualquier operación de escritura.You must synchronize any write operations.

Consulte también: