DataSet DataSet DataSet DataSet Class

Definizione

Rappresenta una cache di dati in 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
Ereditarietà
Attributi
Implementazioni

Esempi

Nell'esempio seguente è costituito da diversi metodi che, combinato, creare e compilare un DataSet dal Northwind database.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 SqlCommand = 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 DataSet = 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 SqlDataAdapter = _
                New SqlDataAdapter()
            productsAdapter.TableMappings.Add("Table", "Products")

            Dim productsCommand As SqlCommand = 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 DataRelation = New _
               System.Data.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

Commenti

Il DataSet, ovvero una cache in memoria dei dati recuperati da un'origine dati, è un componente fondamentale dell'architettura 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. Il DataSet è costituito da una raccolta di DataTable gli oggetti che è possibile correlare reciprocamente con DataRelation oggetti.The DataSet consists of a collection of DataTable objects that you can relate to each other with DataRelation objects. È inoltre possibile applicare l'integrità dei dati nel DataSet usando il UniqueConstraint e ForeignKeyConstraint oggetti.You can also enforce data integrity in the DataSet by using the UniqueConstraint and ForeignKeyConstraint objects. Per altre informazioni sull'utilizzo con DataSet oggetti, vedere DataSet, DataTable e DataView.For further details about working with DataSet objects, see DataSets, DataTables, and DataViews.

Considerando DataTable oggetti contengono i dati, il DataRelationCollection consente lo spostamento tra la gerarchia delle tabelle.Whereas DataTable objects contain the data, the DataRelationCollection allows you to navigate though the table hierarchy. Le tabelle sono contenute in un DataTableCollection accessibili tramite il Tables proprietà.The tables are contained in a DataTableCollection accessed through the Tables property. Quando si accede a DataTable oggetti, si noti che sono prevedono la distinzione tra maiuscole e minuscole in modo condizionale.When accessing DataTable objects, note that they are conditionally case sensitive. Ad esempio, se uno DataTable viene denominato "mydatatable" e un altro è denominato "Mydatatable", stringa utilizzata per cercare una delle tabelle verrà applicata la distinzione tra maiuscole e minuscole.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. Tuttavia, se presente "mydatatable" e "Mydatatable" non esiste, la stringa di ricerca viene considerata come maiuscole e minuscole.However, if "mydatatable" exists and "Mydatatable" does not, the search string is regarded as case insensitive. Per altre informazioni sull'utilizzo con DataTable oggetti, vedere creazione di una DataTable.For more information about working with DataTable objects, see Creating a DataTable.

Oggetto DataSet possono leggere e scrivere dati e dello schema come documenti XML.A DataSet can read and write data and schema as XML documents. I dati e dello schema possono essere trasferiti tramite HTTP e usati da qualsiasi applicazione, in qualsiasi piattaforma che è abilitato per XML.The data and schema can then be transported across HTTP and used by any application, on any platform that is XML-enabled. È possibile salvare lo schema come schema XML con il WriteXmlSchema metodo e di schemi e i dati possono essere salvati utilizzando il WriteXml (metodo).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. Per leggere un documento XML che include lo schema sia dei dati, usare il ReadXml (metodo).To read an XML document that includes both schema and data, use the ReadXml method.

In una tipica implementazione a più livelli, i passaggi per la creazione e l'aggiornamento di un DataSet, e a sua volta, l'aggiornamento dei dati originali sono per:In a typical multiple-tier implementation, the steps for creating and refreshing a DataSet, and in turn, updating the original data are to:

  1. Compilare e inserire ognuna DataTable in un DataSet con i dati da un'origine dati usando un DataAdapter.Build and fill each DataTable in a DataSet with data from a data source using a DataAdapter.

  2. Modifica dei dati nei singoli DataTable oggetti per l'aggiunta, aggiornamento o eliminazione di DataRow oggetti.Change the data in individual DataTable objects by adding, updating, or deleting DataRow objects.

  3. Richiama il GetChanges per creare un secondo metodo DataSet che sono presenti solo le modifiche ai dati.Invoke the GetChanges method to create a second DataSet that features only the changes to the data.

  4. Chiamare il Update metodo per il DataAdapter, passando il secondo DataSet come argomento.Call the Update method of the DataAdapter, passing the second DataSet as an argument.

  5. Richiama il Merge metodo di unire le modifiche dal secondo DataSet nella prima.Invoke the Merge method to merge the changes from the second DataSet into the first.

  6. Richiama il AcceptChanges nella DataSet.Invoke the AcceptChanges on the DataSet. In alternativa, richiamare RejectChanges per annullare le modifiche.Alternatively, invoke RejectChanges to cancel the changes.

Nota

Il DataSet e DataTable oggetti ereditano da MarshalByValueComponente supporta il ISerializable interfaccia per la comunicazione remota.The DataSet and DataTable objects inherit from MarshalByValueComponent, and support the ISerializable interface for remoting. Si tratta degli unici oggetti ADO.NET che è possibile eseguire in remoto.These are the only ADO.NET objects that can be remoted.

Nota

Le classi ereditate dal DataSet non vengono finalizzati dal garbage collector, perché il finalizzatore è stato soppresso DataSet.Classes inherited from DataSet are not finalized by the garbage collector, because the finalizer has been suppressed in DataSet. La classe derivata può chiamare il ReRegisterForFinalize metodo nel costruttore per consentire alla classe di essere finalizzati dal garbage collector.The derived class can call the ReRegisterForFinalize method in its constructor to allow the class to be finalized by the garbage collector.

Costruttori

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

Inizializza una nuova istanza della classe DataSet.Initializes a new instance of the DataSet class.

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

Inizializza una nuova istanza di una classe DataSet avente le informazioni di serializzazione e il contesto specificati.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)

Inizializza una nuova istanza della classe DataSet.Initializes a new instance of the DataSet class.

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

Inizializza una nuova istanza di una classe DataSet con il nome specificato.Initializes a new instance of a DataSet class with the given name.

Proprietà

CaseSensitive CaseSensitive CaseSensitive CaseSensitive

Ottiene o imposta un valore che indica se nei confronti tra stringhe all'interno di oggetti DataTable viene applicata la distinzione tra maiuscole e minuscole.Gets or sets a value indicating whether string comparisons within DataTable objects are case-sensitive.

Container Container Container Container

Ottiene il contenitore del componente.Gets the container for the component.

(Inherited from MarshalByValueComponent)
DataSetName DataSetName DataSetName DataSetName

Ottiene o imposta il nome della classe DataSet corrente.Gets or sets the name of the current DataSet.

DefaultViewManager DefaultViewManager DefaultViewManager DefaultViewManager

Ottiene una visualizzazione personalizzata dei dati contenuti nell'oggetto DataSet per consentire di filtrare, eseguire ricerche ed esplorare mediante un oggetto DataViewManager personalizzato.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

Ottiene un valore che indica se il componente è in modalità progettazione.Gets a value indicating whether the component is currently in design mode.

(Inherited from MarshalByValueComponent)
EnforceConstraints EnforceConstraints EnforceConstraints EnforceConstraints

Ottiene o imposta un valore che indica se vengono seguite le regole sui vincoli quando si esegue un'operazione di aggiornamento.Gets or sets a value indicating whether constraint rules are followed when attempting any update operation.

Events Events Events Events

Ottiene l'elenco dei gestori eventi allegati a questo componente.Gets the list of event handlers that are attached to this component.

(Inherited from MarshalByValueComponent)
ExtendedProperties ExtendedProperties ExtendedProperties ExtendedProperties

Ottiene l'insieme di informazioni utente personalizzate associate all'oggetto DataSet.Gets the collection of customized user information associated with the DataSet.

HasErrors HasErrors HasErrors HasErrors

Ottiene un valore che indica se sono presenti errori in uno degli oggetti DataTable all'interno di questo oggetto DataSet.Gets a value indicating whether there are errors in any of the DataTable objects within this DataSet.

IsInitialized IsInitialized IsInitialized IsInitialized

Ottiene un valore che indica se la classe DataSet è inizializzata.Gets a value that indicates whether the DataSet is initialized.

Locale Locale Locale Locale

Ottiene o imposta le informazioni sulle impostazioni locali utilizzate per confrontare stringhe all'interno della tabella.Gets or sets the locale information used to compare strings within the table.

Namespace Namespace Namespace Namespace

Ottiene o imposta lo spazio dei nomi della classe DataSet.Gets or sets the namespace of the DataSet.

Prefix Prefix Prefix Prefix

Ottiene o imposta un prefisso XML che rappresenta l'alias dello spazio dei nomi della classe DataSet.Gets or sets an XML prefix that aliases the namespace of the DataSet.

Relations Relations Relations Relations

Ottenere l'insieme di relazioni che collegano le tabelle e consentono la navigazione dalle tabelle padre a quelle figlio.Gets the collection of relations that link tables and allow navigation from parent tables to child tables.

RemotingFormat RemotingFormat RemotingFormat RemotingFormat

Ottiene o imposta un'enumerazione SerializationFormat per la classe DataSet utilizzata durante i servizi remoti.Gets or sets a SerializationFormat for the DataSet used during remoting.

SchemaSerializationMode SchemaSerializationMode SchemaSerializationMode SchemaSerializationMode

Ottiene o imposta un'enumerazione SchemaSerializationMode per una classe DataSet.Gets or sets a SchemaSerializationMode for a DataSet.

Site Site Site Site

Ottiene o imposta un oggetto ISite per l'oggetto DataSet.Gets or sets an ISite for the DataSet.

Tables Tables Tables Tables

Ottiene l'insieme di tabelle contenuto nell'oggetto DataSet.Gets the collection of tables contained in the DataSet.

Metodi

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

Esegue il commit di tutte le modifiche apportate a questo oggetto DataSet dal momento in cui è stato caricato o dall'ultima chiamata al metodo 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()

Avvia l'inizializzazione di una DataSet usata su un form o da un altro componente.Begins the initialization of a DataSet that is used on a form or used by another component. L'inizializzazione avviene in fase di esecuzione.The initialization occurs at run time.

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

Cancella tutti i dati dall'oggetto DataSet rimuovendo tutte le righe in tutte le tabelle.Clears the DataSet of any data by removing all rows in all tables.

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

Copia la struttura dell'oggetto DataSet, inclusi tutti gli schemi, le relazioni e i vincoli dell'oggetto DataTable.Copies the structure of the DataSet, including all DataTable schemas, relations, and constraints. Non vengono copiati i dati.Does not copy any data.

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

Copia la struttura e i dati per questa classe DataSet.Copies both the structure and data for this DataSet.

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

Restituisce una classe DataTableReader con un gruppo di risultati per la classe DataTable, nella stessa sequenza in cui le tabelle appaiono nell'insieme 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[])

Restituisce una classe DataTableReader con un gruppo di risultati per la classe DataTable.Returns a DataTableReader with one result set per DataTable.

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

Determina la proprietà SchemaSerializationMode per una classe DataSet.Determines the SchemaSerializationMode for a DataSet.

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

Determina la proprietà SchemaSerializationMode per una classe DataSet.Determines the SchemaSerializationMode for a DataSet.

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

Rilascia tutte le risorse usate da MarshalByValueComponent.Releases all resources used by the MarshalByValueComponent.

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

Rilascia le risorse non gestite usate da MarshalByValueComponent e, facoltativamente, le risorse gestite.Releases the unmanaged resources used by the MarshalByValueComponent and optionally releases the managed resources.

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

Termina l'inizializzazione di una classe DataSet usata su un form o da un altro componente.Ends the initialization of a DataSet that is used on a form or used by another component. L'inizializzazione avviene in fase di esecuzione.The initialization occurs at run time.

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

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

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

Ottiene una copia della classe DataSet contenente tutte le modifiche apportate a essa dal momento in cui è stata caricata o dall'ultima chiamata al metodo AcceptChanges().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)

Ottiene una copia della classe DataSet contenente tutte le modifiche apportate a essa dal momento in cui è stata caricata o dall'ultima chiamata al metodo AcceptChanges(), filtrata dall'enumerazione 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)

Ottiene una copia di XmlSchemaSet per il DataSet.Gets a copy of XmlSchemaSet for the DataSet.

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

Funge da funzione hash predefinita.Serves as the default hash function.

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

Popola un oggetto di informazioni di serializzazione con i dati necessari per serializzare l'istanza di DataSet.Populates a serialization information object with the data needed to serialize the DataSet.

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

Restituisce un'istanza di XmlSchema serializzabile.Returns a serializable XmlSchema instance.

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

Deserializza i dati della tabella dal flusso binario o XML.Deserializes the table data from the binary or XML stream.

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

Ottiene l'implementatore dell'interfaccia IServiceProvider.Gets the implementer of the IServiceProvider.

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

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

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

Restituisce la rappresentazione XML dei dati memorizzati nell'oggetto DataSet.Returns the XML representation of the data stored in the DataSet.

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

Restituisce lo schema XML per la rappresentazione XML dei dati memorizzati nell'oggetto DataSet.Returns the XML Schema for the XML representation of the data stored in the DataSet.

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

Ottiene un valore che indica se l'oggetto DataSet presenta delle modifiche, quali righe nuove, eliminate o modificate.Gets a value indicating whether the DataSet has changes, including new, deleted, or modified rows.

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

Ottiene un valore che indica se l'oggetto DataSet presenta delle modifiche, quali righe nuove, eliminate o modificate, filtrate in base all'oggetto 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[])

Lo schema XML dalla classe Stream specificata viene applicato alla classe DataSet.Applies the XML schema from the specified Stream to the DataSet.

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

Lo schema XML dal file specificato viene applicato all'oggetto DataSet.Applies the XML schema from the specified file to the DataSet.

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

Lo schema XML dalla classe TextReader specificata viene applicato alla classe DataSet.Applies the XML schema from the specified TextReader to the DataSet.

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

Lo schema XML dalla classe XmlReader specificata viene applicato alla classe DataSet.Applies the XML schema from the specified XmlReader to the DataSet.

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

Deserializza tutti i dati delle tabelle del DataSet dal flusso binario 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)

Esamina il formato della rappresentazione serializzata di 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[])

Riempie una classe DataSet con valori da un'origine dati, utilizzando l'interfaccia IDataReader fornita, tramite una matrice di istanze della classe DataTable, per fornire informazioni relative allo schema e allo spazio dei nomi.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[])

Riempie una classe DataSet con valori da un'origine dati, utilizzando l'interfaccia IDataReader fornita, tramite una matrice di istanze della classe DataTable, per fornire informazioni relative allo schema e allo spazio dei nomi.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[])

Riempie una classe DataSet con valori da un'origine dati, utilizzando l'interfaccia IDataReader fornita e una matrice di stringhe, per rendere disponibili i nomi delle tabelle all'interno della classe 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 superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

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

Unisce una matrice di oggetti DataRow nell'oggetto DataSet corrente.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)

Unisce una matrice di oggetti DataRow nell'oggetto DataSet corrente, mantenendo o ignorando eventuali modifiche apportate a DataSet e gestendo uno schema incompatibile secondo gli argomenti definiti.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)

Unisce una classe DataSet specificata e il relativo schema nella classe DataSet corrente.Merges a specified DataSet and its schema into the current DataSet.

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

Unisce un oggetto DataSet specificato e il relativo schema nell'oggetto DataSet corrente, mantenendo o ignorando eventuali modifiche apportate a DataSet secondo l'argomento definito.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)

Unisce un oggetto DataSet specificato e il relativo schema nell'oggetto DataSet corrente, mantenendo o ignorando eventuali modifiche apportate all'oggetto DataSet corrente e gestendo uno schema incompatibile secondo gli argomenti definiti.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)

Unisce una classe DataTable specificata e il relativo schema nella classe DataSet corrente.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)

Unisce un oggetto DataTable specificato e il relativo schema nell'oggetto DataSet corrente, mantenendo o ignorando eventuali modifiche apportate all'oggetto DataSet e gestendo uno schema incompatibile secondo gli argomenti definiti.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 l'evento OnPropertyChanging(PropertyChangedEventArgs).Raises the OnPropertyChanging(PropertyChangedEventArgs) event.

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

Viene generato quando si rimuove un oggetto DataRelation da un oggetto DataTable.Occurs when a DataRelation object is removed from a DataTable.

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

Viene generato quando si rimuove un oggetto DataTable da un oggetto DataSet.Occurs when a DataTable is removed from a DataSet.

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

Invia una notifica nella quale è indicato che la proprietà dell'oggetto DataSet specificato sta per essere modificata.Sends a notification that the specified DataSet property is about to change.

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

Legge i dati e lo schema XML nella classe DataSet utilizzando la classe Stream specificata.Reads XML schema and data into the DataSet using the specified Stream.

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

Legge i dati e lo schema XML nella classe DataSet utilizzando la classe Stream e l'enumerazione XmlReadMode specificate.Reads XML schema and data into the DataSet using the specified Stream and XmlReadMode.

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

Legge i dati e lo schema XML nell'oggetto DataSet utilizzando il file specificato.Reads XML schema and data into the DataSet using the specified file.

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

Legge i dati e lo schema XML nell'oggetto DataSet utilizzando il file e l'oggetto XmlReadMode specificati.Reads XML schema and data into the DataSet using the specified file and XmlReadMode.

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

Legge i dati e lo schema XML nella classe DataSet utilizzando la classe TextReader specificata.Reads XML schema and data into the DataSet using the specified TextReader.

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

Legge i dati e lo schema XML nella classe DataSet utilizzando la classe TextReader e l'enumerazione XmlReadMode specificate.Reads XML schema and data into the DataSet using the specified TextReader and XmlReadMode.

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

Legge i dati e lo schema XML nella classe DataSet utilizzando la classe XmlReader specificata.Reads XML schema and data into the DataSet using the specified XmlReader.

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

Legge i dati e lo schema XML nella classe DataSet utilizzando la classe XmlReader e l'enumerazione XmlReadMode specificate.Reads XML schema and data into the DataSet using the specified XmlReader and XmlReadMode.

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

Legge lo schema XML dalla classe Stream specificata nella classe DataSet.Reads the XML schema from the specified Stream into the DataSet.

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

Legge lo schema XML dal file specificato nell'oggetto DataSet.Reads the XML schema from the specified file into the DataSet.

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

Legge lo schema XML dalla classe TextReader specificata nella classe DataSet.Reads the XML schema from the specified TextReader into the DataSet.

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

Legge lo schema XML dalla classe XmlReader specificata nella classe DataSet.Reads the XML schema from the specified XmlReader into the DataSet.

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

Ignora gli attributi e restituisce un DataSet vuoto.Ignores attributes and returns an empty DataSet.

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

Annulla tutte le modifiche apportate all'oggetto DataSet dal momento in cui è stato creato o sin dall'ultima chiamata al metodo 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()

Rimuove tutte le tabelle e rimuove tutte le relazioni, vincoli stranieri e tabelle da DataSet.Clears all tables and removes all relations, foreign constraints, and tables from the DataSet. Per ripristinare lo stato originale dell'oggetto Reset(), è necessario eseguire l'override del metodo DataSet mediante le sottoclassi.Subclasses should override Reset() to restore a DataSet to its original state.

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

Ottiene un valore che indica se la proprietà Relations deve essere resa persistente.Gets a value indicating whether Relations property should be persisted.

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

Ottiene un valore che indica se la proprietà Tables deve essere resa persistente.Gets a value indicating whether Tables property should be persisted.

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

Restituisce un oggetto String che contiene il nome dell'eventuale oggetto Component.Returns a String containing the name of the Component, if any. Questo metodo non deve essere sottoposto a override.This method should not be overridden.

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

Scrive i dati correnti per la classe DataSet utilizzando la classe Stream specificata.Writes the current data for the DataSet using the specified Stream.

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

Scrive i dati correnti e, facoltativamente, lo schema per l'oggetto DataSet utilizzando l'oggetto Stream e l'oggetto XmlWriteMode specificati.Writes the current data, and optionally the schema, for the DataSet using the specified Stream and XmlWriteMode. Per scrivere lo schema, impostare il valore del parametro mode su WriteSchema.To write the schema, set the value for the mode parameter to WriteSchema.

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

Scrive i dati correnti per l'oggetto DataSet nel file specificato.Writes the current data for the DataSet to the specified file.

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

Scrive i dati correnti e, facoltativamente, lo schema per l'oggetto DataSet nel file specificato utilizzando l'oggetto XmlWriteMode specificato.Writes the current data, and optionally the schema, for the DataSet to the specified file using the specified XmlWriteMode. Per scrivere lo schema, impostare il valore del parametro mode su WriteSchema.To write the schema, set the value for the mode parameter to WriteSchema.

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

Scrive i dati correnti per la classe DataSet utilizzando la classe TextWriter specificata.Writes the current data for the DataSet using the specified TextWriter.

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

Scrive i dati correnti e, facoltativamente, lo schema per l'oggetto DataSet utilizzando l'oggetto TextWriter e l'oggetto XmlWriteMode specificati.Writes the current data, and optionally the schema, for the DataSet using the specified TextWriter and XmlWriteMode. Per scrivere lo schema, impostare il valore del parametro mode su WriteSchema.To write the schema, set the value for the mode parameter to WriteSchema.

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

Scrive i dati correnti per l'oggetto DataSet nell'oggetto XmlWriter specificato.Writes the current data for the DataSet to the specified XmlWriter.

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

Scrive i dati correnti e, facoltativamente, lo schema per l'oggetto DataSet utilizzando l'oggetto XmlWriter e l'oggetto XmlWriteMode specificati.Writes the current data, and optionally the schema, for the DataSet using the specified XmlWriter and XmlWriteMode. Per scrivere lo schema, impostare il valore del parametro mode su WriteSchema.To write the schema, set the value for the mode parameter to WriteSchema.

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

Scrive la struttura DataSet come schema XML nell'oggetto Stream specificato.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>)

Scrive la struttura DataSet come schema XML nell'oggetto Stream specificato.Writes the DataSet structure as an XML schema to the specified Stream object.

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

Scrive la struttura dell'oggetto DataSet come schema XML in un file.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>)

Scrive la struttura dell'oggetto DataSet come schema XML in un file.Writes the DataSet structure as an XML schema to a file.

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

Scrive la struttura DataSet come schema XML nell'oggetto TextWriter specificato.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>)

Scrive la struttura di DataSet come XML Schema nell'oggetto TextWriter specificato.Writes the DataSet structure as an XML schema to the specified TextWriter.

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

Scrive la struttura dell'oggetto DataSet come schema XML in un oggetto 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>)

Scrive la struttura di DataSet come XML Schema nell'oggetto XmlWriter specificato.Writes the DataSet structure as an XML schema to the specified XmlWriter.

Eventi

Disposed Disposed Disposed Disposed

Aggiunge un gestore eventi per restare in attesa dell'evento Disposed sul componente.Adds an event handler to listen to the Disposed event on the component.

(Inherited from MarshalByValueComponent)
Initialized Initialized Initialized Initialized

Si verifica dopo l'inizializzazione dell'oggetto DataSet.Occurs after the DataSet is initialized.

MergeFailed MergeFailed MergeFailed MergeFailed

Viene generato quando due oggetti DataRow di origine e di destinazione presentano la stessa chiave primaria e la proprietà EnforceConstraints è impostata su true.Occurs when a target and source DataRow have the same primary key value, and EnforceConstraints is set to true.

Implementazioni dell'interfaccia esplicita

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

Per una descrizione di questo membro, vedere ContainsListCollection.For a description of this member, see ContainsListCollection.

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

Per una descrizione di questo membro, vedere 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)

Popola un oggetto di informazioni di serializzazione con i dati necessari per serializzare l'istanza di DataSet.Populates a serialization information object with the data needed to serialize the DataSet.

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

Per una descrizione di questo membro, vedere GetSchema().For a description of this member, see GetSchema().

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

Per una descrizione di questo membro, vedere ReadXml(XmlReader).For a description of this member, see ReadXml(XmlReader).

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

Per una descrizione di questo membro, vedere WriteXml(XmlWriter).For a description of this member, see WriteXml(XmlWriter).

Si applica a

Thread safety

Questo tipo è sicuro per le operazioni di lettura a thread multipli.This type is safe for multithreaded read operations. È necessario sincronizzare qualsiasi operazione di scrittura.You must synchronize any write operations.

Vedi anche