DataSet Clase

Definición

Espacio de nombres:

System.Data

Ensamblado:

System.Data.dll

Representa una caché en memoria de datos.

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

[<System.Serializable>]
type DataSet = class
    inherit MarshalByValueComponent
    interface IListSource
    interface IXmlSerializable
    interface ISupportInitializeNotification
    interface ISupportInitialize
    interface ISerializable

Public Class DataSet
Inherits MarshalByValueComponent
Implements IListSource, ISerializable, ISupportInitializeNotification, IXmlSerializable

Herencia

Object

MarshalByValueComponent

DataSet

Atributos

SerializableAttribute

Implementaciones

IListSource ISupportInitialize ISerializable IXmlSerializable ISupportInitializeNotification

Ejemplos

El ejemplo siguiente consta de varios métodos que, combinados, crean y rellenan desde DataSet la base de datos Northwind .

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

Para obtener más información sobre esta API, consulte Comentarios complementarios de api para DataSet.

Constructores

Nombre	Description
DataSet()	Inicializa una nueva instancia de la clase DataSet.
DataSet(SerializationInfo, StreamingContext, Boolean)	Inicializa una nueva instancia de la DataSet clase con datos serializados.
DataSet(SerializationInfo, StreamingContext)	Inicializa una nueva instancia de la DataSet clase con datos serializados.
DataSet(String)	Inicializa una nueva instancia de la DataSet clase con el nombre especificado.

Propiedades

Nombre	Description
CaseSensitive	Obtiene o establece un valor que indica si las comparaciones de cadenas dentro DataTable de los objetos distinguen mayúsculas de minúsculas.
Container	Obtiene el contenedor del componente. (Heredado de MarshalByValueComponent)
DataSetName	Obtiene o establece el nombre del objeto actual DataSet.
DefaultViewManager	Obtiene una vista personalizada de los datos incluidos en DataSet para permitir el filtrado, la búsqueda y la navegación mediante un personalizado DataViewManager.
DesignMode	Obtiene un valor que indica si el componente está actualmente en modo de diseño. (Heredado de MarshalByValueComponent)
EnforceConstraints	Obtiene o establece un valor que indica si se siguen las reglas de restricción al intentar cualquier operación de actualización.
Events	Obtiene la lista de controladores de eventos que están asociados a este componente. (Heredado de MarshalByValueComponent)
ExtendedProperties	Obtiene la colección de información de usuario personalizada asociada a DataSet.
HasErrors	Obtiene un valor que indica si hay errores en cualquiera de los DataTable objetos de este DataSetobjeto .
IsInitialized	Obtiene un valor que indica si DataSet se inicializa .
Locale	Obtiene o establece la información de configuración regional utilizada para comparar cadenas dentro de la tabla.
Namespace	Obtiene o establece el espacio de nombres de DataSet.
Prefix	Obtiene o establece un prefijo XML que alias el espacio de nombres de DataSet.
Relations	Obtiene la colección de relaciones que vinculan las tablas y permiten la navegación de las tablas primarias a las tablas secundarias.
RemotingFormat	Obtiene o establece el formato de serialización del DataSet objeto que se usa durante la comunicación remota.
SchemaSerializationMode	Obtiene o establece un SchemaSerializationMode para un DataSetobjeto .
Site	Obtiene o establece un ISite para .DataSet
Tables	Obtiene la colección de tablas contenidas en .DataSet

Métodos

Nombre	Description
AcceptChanges()	Confirma todos los cambios realizados en esto DataSet desde que se cargó o desde la última vez AcceptChanges() que se llamó a .
BeginInit()	Comienza la inicialización de un DataSet objeto que se usa en un formulario o que usa otro componente. La inicialización se produce en tiempo de ejecución.
Clear()	Borra los DataSet datos quitando todas las filas de todas las tablas.
Clone()	Copia la estructura de DataSet, incluidos todos los DataTable esquemas, relaciones y restricciones. No copia ningún dato.
Copy()	Copia tanto la estructura como los datos de este DataSetobjeto .
CreateDataReader()	Devuelve un objeto con un DataTableReader conjunto de resultados por DataTable, en la misma secuencia que las tablas aparecen en la Tables colección.
CreateDataReader(DataTable[])	Devuelve un DataTableReader objeto con un conjunto de resultados por DataTable.
DetermineSchemaSerializationMode(SerializationInfo, StreamingContext)	Determina para SchemaSerializationMode un DataSetobjeto .
DetermineSchemaSerializationMode(XmlReader)	Determina para SchemaSerializationMode un DataSetobjeto .
Dispose()	Libera todos los recursos usados por .MarshalByValueComponent (Heredado de MarshalByValueComponent)
Dispose(Boolean)	Libera los recursos no administrados utilizados por MarshalByValueComponent y, opcionalmente, libera los recursos administrados. (Heredado de MarshalByValueComponent)
EndInit()	Finaliza la inicialización de un DataSet objeto que se usa en un formulario o que usa otro componente. La inicialización se produce en tiempo de ejecución.
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
GetChanges()	Obtiene una copia de que DataSet contiene todos los cambios realizados en él desde que se cargó o desde AcceptChanges() que se llamó por última vez.
GetChanges(DataRowState)	Obtiene una copia de que DataSet contiene todos los cambios realizados en él desde que se cargó por última vez, o desde AcceptChanges() que se llamó, filtrado por DataRowState.
GetDataSetSchema(XmlSchemaSet)	Obtiene una copia de para El conjunto de XmlSchemaSet datos.
GetHashCode()	Actúa como la función hash predeterminada. (Heredado de Object)
GetObjectData(SerializationInfo, StreamingContext)	Rellena un objeto de información de serialización con los datos necesarios para serializar .DataSet
GetSchemaSerializable()	Devuelve una instancia serializable XmlSchema .
GetSerializationData(SerializationInfo, StreamingContext)	Deserializa los datos de tabla de la secuencia binaria o XML.
GetService(Type)	Obtiene el implementador de .IServiceProvider (Heredado de MarshalByValueComponent)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
GetXml()	Devuelve la representación XML de los datos almacenados en .DataSet
GetXmlSchema()	Devuelve el esquema XML para la representación XML de los datos almacenados en .DataSet
HasChanges()	Obtiene un valor que indica si DataSet tiene cambios, incluidas las filas nuevas, eliminadas o modificadas.
HasChanges(DataRowState)	Obtiene un valor que indica si DataSet tiene cambios, incluidas las filas nuevas, eliminadas o modificadas, filtradas por DataRowState.
InferXmlSchema(Stream, String[])	Aplica el esquema XML del especificado Stream a .DataSet
InferXmlSchema(String, String[])	Aplica el esquema XML del archivo especificado a DataSet.
InferXmlSchema(TextReader, String[])	Aplica el esquema XML del especificado TextReader a .DataSet
InferXmlSchema(XmlReader, String[])	Aplica el esquema XML del especificado XmlReader a .DataSet
InitializeDerivedDataSet()	Deserialice todos los datos de tablas del conjunto de datos del flujo binario o XML.
IsBinarySerialized(SerializationInfo, StreamingContext)	Inspecciona el formato de la representación serializada de .DataSet
Load(IDataReader, LoadOption, DataTable[])	Rellena un DataSet objeto con valores de un origen de datos mediante el proporcionado IDataReadermediante una matriz de DataTable instancias para proporcionar la información del esquema y del espacio de nombres.
Load(IDataReader, LoadOption, FillErrorEventHandler, DataTable[])	Rellena un DataSet objeto con valores de un origen de datos mediante el proporcionado IDataReadermediante una matriz de DataTable instancias para proporcionar la información del esquema y del espacio de nombres.
Load(IDataReader, LoadOption, String[])	Rellena un DataSet objeto con valores de un origen de datos mediante el proporcionado IDataReadermediante una matriz de cadenas para proporcionar los nombres de las tablas dentro de DataSet.
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
Merge(DataRow[], Boolean, MissingSchemaAction)	Combina una matriz de DataRow objetos en el actual DataSet, conservando o descartando los cambios en y DataSet controlando un esquema incompatible según los argumentos especificados.
Merge(DataRow[])	Combina una matriz de DataRow objetos en el objeto actual DataSet.
Merge(DataSet, Boolean, MissingSchemaAction)	Combina un especificado DataSet y su esquema con el actual DataSet, conservando o descartando los cambios en el actual DataSet y controlando un esquema incompatible según los argumentos especificados.
Merge(DataSet, Boolean)	Combina un objeto especificado DataSet y su esquema en el actual DataSet, conservando o descartando los cambios en esto DataSet según el argumento especificado.
Merge(DataSet)	Combina un objeto especificado DataSet y su esquema en el objeto actual DataSet.
Merge(DataTable, Boolean, MissingSchemaAction)	Combina un especificado DataTable y su esquema en el actual DataSet, conservando o descartando los cambios en y DataSet controlando un esquema incompatible según los argumentos especificados.
Merge(DataTable)	Combina un objeto especificado DataTable y su esquema en el objeto actual DataSet.
OnPropertyChanging(PropertyChangedEventArgs)	Genera el evento OnPropertyChanging(PropertyChangedEventArgs).
OnRemoveRelation(DataRelation)	Se produce cuando se quita un DataRelation objeto de .DataTable
OnRemoveTable(DataTable)	Se produce cuando se quita un DataTable de .DataSet
RaisePropertyChanging(String)	Envía una notificación de que la propiedad especificada DataSet está a punto de cambiar.
ReadXml(Stream, XmlReadMode)	Lee el esquema XML y los datos en mediante DataSet el especificado Stream y XmlReadMode.
ReadXml(Stream)	Lee el esquema XML y los datos en mediante DataSet el especificado Stream.
ReadXml(String, XmlReadMode)	Lee el esquema XML y los datos en mediante DataSet el archivo especificado y XmlReadMode.
ReadXml(String)	Lee el esquema XML y los datos en el DataSet utilizando el archivo especificado.
ReadXml(TextReader, XmlReadMode)	Lee el esquema XML y los datos en mediante DataSet el especificado TextReader y XmlReadMode.
ReadXml(TextReader)	Lee el esquema XML y los datos en mediante DataSet el especificado TextReader.
ReadXml(XmlReader, XmlReadMode)	Lee el esquema XML y los datos en mediante DataSet el especificado XmlReader y XmlReadMode.
ReadXml(XmlReader)	Lee el esquema XML y los datos en mediante DataSet el especificado XmlReader.
ReadXmlSchema(Stream)	Lee el esquema XML del especificado Stream en .DataSet
ReadXmlSchema(String)	Lee el esquema XML del archivo especificado en .DataSet
ReadXmlSchema(TextReader)	Lee el esquema XML del especificado TextReader en .DataSet
ReadXmlSchema(XmlReader)	Lee el esquema XML del especificado XmlReader en .DataSet
ReadXmlSerializable(XmlReader)	Omite los atributos y devuelve un DataSet vacío.
RejectChanges()	Revierte todos los cambios realizados en DataSet desde que se creó o desde la última vez AcceptChanges() que se llamó a .
Reset()	Borra todas las tablas y quita todas las relaciones, restricciones externas y tablas de .DataSet Las subclases deben invalidar Reset() para restaurar un objeto DataSet a su estado original.
ShouldSerializeRelations()	Obtiene un valor que indica si Relations se debe conservar la propiedad .
ShouldSerializeTables()	Obtiene un valor que indica si Tables se debe conservar la propiedad .
ToString()	Devuelve un String objeto que contiene el nombre de Component, si existe. Este método no se debe invalidar. (Heredado de MarshalByValueComponent)
WriteXml(Stream, XmlWriteMode)	Escribe los datos actuales y, opcionalmente, el esquema , para el DataSet que usa los valores especificados Stream y XmlWriteMode. Para escribir el esquema, establezca el valor del mode parámetro WriteSchemaen .
WriteXml(Stream)	Escribe los datos actuales para utilizando DataSet el especificado Stream.
WriteXml(String, XmlWriteMode)	Escribe los datos actuales y, opcionalmente, el esquema , para en DataSet el archivo especificado mediante el especificado XmlWriteMode. Para escribir el esquema, establezca el valor del mode parámetro WriteSchemaen .
WriteXml(String)	Escribe los datos actuales para en DataSet el archivo especificado.
WriteXml(TextWriter, XmlWriteMode)	Escribe los datos actuales y, opcionalmente, el esquema , para el DataSet que usa los valores especificados TextWriter y XmlWriteMode. Para escribir el esquema, establezca el valor del mode parámetro WriteSchemaen .
WriteXml(TextWriter)	Escribe los datos actuales para utilizando DataSet el especificado TextWriter.
WriteXml(XmlWriter, XmlWriteMode)	Escribe los datos actuales y, opcionalmente, el esquema , para el DataSet que usa los valores especificados XmlWriter y XmlWriteMode. Para escribir el esquema, establezca el valor del mode parámetro WriteSchemaen .
WriteXml(XmlWriter)	Escribe los datos actuales de en DataSet el objeto especificado XmlWriter.
WriteXmlSchema(Stream, Converter<Type,String>)	Escribe la DataSet estructura como un esquema XML en el objeto especificado Stream .
WriteXmlSchema(Stream)	Escribe la DataSet estructura como un esquema XML en el objeto especificado Stream .
WriteXmlSchema(String, Converter<Type,String>)	Escribe la DataSet estructura como un esquema XML en un archivo.
WriteXmlSchema(String)	Escribe la DataSet estructura como un esquema XML en un archivo.
WriteXmlSchema(TextWriter, Converter<Type,String>)	Escribe la DataSet estructura como un esquema XML en el especificado TextWriter.
WriteXmlSchema(TextWriter)	Escribe la DataSet estructura como un esquema XML en el objeto especificado TextWriter .
WriteXmlSchema(XmlWriter, Converter<Type,String>)	Escribe la DataSet estructura como un esquema XML en el especificado XmlWriter.
WriteXmlSchema(XmlWriter)	Escribe la DataSet estructura como un esquema XML en un XmlWriter objeto .

Eventos

Nombre	Description
Disposed	Agrega un controlador de eventos para escuchar el Disposed evento en el componente. (Heredado de MarshalByValueComponent)
Initialized	Se produce después de DataSet inicializar .
MergeFailed	Se produce cuando un destino y DataRow un origen tienen el mismo valor de clave principal y EnforceConstraints se establece en true.

Implementaciones de interfaz explícitas

Nombre	Description
IListSource.ContainsListCollection	Para obtener una descripción de este miembro, vea ContainsListCollection.
IListSource.GetList()	Para obtener una descripción de este miembro, vea GetList().
IXmlSerializable.GetSchema()	Para obtener una descripción de este miembro, vea GetSchema().
IXmlSerializable.ReadXml(XmlReader)	Para obtener una descripción de este miembro, vea ReadXml(XmlReader).
IXmlSerializable.WriteXml(XmlWriter)	Para obtener una descripción de este miembro, vea WriteXml(XmlWriter).

Seguridad para subprocesos

Este tipo es seguro para las operaciones de lectura multiproceso. Debe sincronizar las operaciones de escritura.

Consulte también

• Usando conjuntos de datos en ADO.NET