DataSet DataSet DataSet DataSet Class

Definition

Stellt einen speicherinternen Datencache dar.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
Vererbung
Attribute
Implementiert

Beispiele

Im folgende Beispiel besteht aus mehreren Methoden, die in Kombination, erstellen und Auffüllen einer DataSet aus der Northwind Datenbank.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

Hinweise

Die DataSet, d.h. einen Cache im Arbeitsspeicher, der aus einer Datenquelle abgerufenen Daten ist eine Hauptkomponente der ADO.NET-Architektur.The DataSet, which is an in-memory cache of data retrieved from a data source, is a major component of the ADO.NET architecture. Die DataSet besteht aus einer Auflistung von DataTable Objekte, die Sie miteinander in Beziehung setzen können DataRelation Objekte.The DataSet consists of a collection of DataTable objects that you can relate to each other with DataRelation objects. Sie können auch Erzwingen der Datenintegrität in den DataSet mithilfe der UniqueConstraint und ForeignKeyConstraint Objekte.You can also enforce data integrity in the DataSet by using the UniqueConstraint and ForeignKeyConstraint objects. Weitere Informationen zum Arbeiten mit DataSet Objekten finden Sie DataSets, DataTables und DataViews.For further details about working with DataSet objects, see DataSets, DataTables, and DataViews.

Während DataTable Objekte enthalten, die Daten, die DataRelationCollection ermöglicht Ihnen das Navigieren in der Tabellenhierarchie.Whereas DataTable objects contain the data, the DataRelationCollection allows you to navigate though the table hierarchy. Die Tabellen befinden sich einem DataTableCollection erfolgt über die Tables Eigenschaft.The tables are contained in a DataTableCollection accessed through the Tables property. Beim Zugriff auf DataTable Objekte, beachten Sie, dass sie bedingt Groß-/Kleinschreibung beachtet werden.When accessing DataTable objects, note that they are conditionally case sensitive. Angenommen, ein DataTable "Mydatatable" den Namen und eine weitere "Mydatatable" benannt ist, wird in eine Zeichenfolge, die zum Suchen nach einer der Tabellen verwendet die Groß-/ Kleinschreibung.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. Allerdings wird Wenn "Mydatatable" vorhanden ist, und "Mydatatable", nicht aber, die zu suchende Zeichenfolge Groß-/Kleinschreibung betrachtet.However, if "mydatatable" exists and "Mydatatable" does not, the search string is regarded as case insensitive. Weitere Informationen zum Arbeiten mit DataTable anzuzeigen, Erstellen einer "DataTable".For more information about working with DataTable objects, see Creating a DataTable.

Ein DataSet lesen und Schreiben von Daten und das Schema als XML-Dokumente können.A DataSet can read and write data and schema as XML documents. Die Daten und das Schema, können klicken Sie dann über HTTP übertragen und von jeder Anwendung auf jeder Plattform, die XML-fähigen verwendet werden.The data and schema can then be transported across HTTP and used by any application, on any platform that is XML-enabled. Sie können das Schema als ein XML-Schema mit speichern die WriteXmlSchema -Methode, und Schema und Daten, können mit gespeichert werden die WriteXml Methode.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. Verwenden Sie zum Lesen eines XML-Dokuments, die sowohl Schema-als auch Daten umfasst die ReadXml Methode.To read an XML document that includes both schema and data, use the ReadXml method.

In einer typischen mehreren Ebenen, die Schritte zum Erstellen und Aktualisieren einer DataSet, und im Gegenzug die ursprünglichen Daten zu aktualisieren:In a typical multiple-tier implementation, the steps for creating and refreshing a DataSet, and in turn, updating the original data are to:

  1. Erstellen und füllen Sie jede DataTable in einem DataSet mit Daten aus einer Datenquelle mithilfe einer DataAdapter.Build and fill each DataTable in a DataSet with data from a data source using a DataAdapter.

  2. Ändern Sie die Daten in einzelnen DataTable Objekte hinzufügen, aktualisieren oder Löschen von DataRow Objekte.Change the data in individual DataTable objects by adding, updating, or deleting DataRow objects.

  3. Rufen Sie die GetChanges Methode, um ein zweites DataSet features zur Verfügung, nur die Änderungen an den Daten.Invoke the GetChanges method to create a second DataSet that features only the changes to the data.

  4. Rufen Sie die Update Methode der DataAdapter, übergeben Sie das zweite DataSet als Argument.Call the Update method of the DataAdapter, passing the second DataSet as an argument.

  5. Rufen Sie die Merge Methode zum Zusammenführen der Änderungen aus der zweiten DataSet in die erste.Invoke the Merge method to merge the changes from the second DataSet into the first.

  6. Rufen Sie die AcceptChanges auf die DataSet.Invoke the AcceptChanges on the DataSet. Rufen Sie alternativ RejectChanges um die Änderungen abzubrechen.Alternatively, invoke RejectChanges to cancel the changes.

Hinweis

Die DataSet und DataTable Objekte erben von MarshalByValueComponent, und unterstützen die ISerializable -Schnittstelle für das Remoting.The DataSet and DataTable objects inherit from MarshalByValueComponent, and support the ISerializable interface for remoting. Dies sind die einzigen ADO.NET-Objekte, die remotingfähig sind.These are the only ADO.NET objects that can be remoted.

Hinweis

Klassen vererbt DataSet werden nicht vom Garbage Collector, beendet, da in der Finalizer unterdrückt wird DataSet.Classes inherited from DataSet are not finalized by the garbage collector, because the finalizer has been suppressed in DataSet. Die abgeleitete Klasse aufrufen, kann die ReRegisterForFinalize -Methode in seinem Konstruktor auf die Klasse durch den Garbage Collector beendet werden kann.The derived class can call the ReRegisterForFinalize method in its constructor to allow the class to be finalized by the garbage collector.

Konstruktoren

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

Initialisiert eine neue Instanz der DataSet-Klasse.Initializes a new instance of the DataSet class.

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

Initialisiert eine neue Instanz einer DataSet-Klasse, die über die angegebenen Serialisierungsinformationen und den angegebenen Kontext verfügt.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)

Initialisiert eine neue Instanz der DataSet-Klasse.Initializes a new instance of the DataSet class.

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

Initialisiert eine neue Instanz einer DataSet-Klasse mit dem angegebenen Namen.Initializes a new instance of a DataSet class with the given name.

Eigenschaften

CaseSensitive CaseSensitive CaseSensitive CaseSensitive

Ruft einen Wert ab, der angibt, ob bei Zeichenfolgenvergleichen in DataTable-Objekten die Groß- und Kleinschreibung berücksichtigt wird, oder legt diesen fest.Gets or sets a value indicating whether string comparisons within DataTable objects are case-sensitive.

Container Container Container Container

Ruft den Container für die Komponente ab.Gets the container for the component.

(Inherited from MarshalByValueComponent)
DataSetName DataSetName DataSetName DataSetName

Ruft den Namen des aktuellen DataSet ab oder legt diesen fest.Gets or sets the name of the current DataSet.

DefaultViewManager DefaultViewManager DefaultViewManager DefaultViewManager

Ruft eine benutzerdefinierte Ansicht der im DataSet enthaltenen Daten ab, mit der unter Verwendung eines benutzerdefinierten DataViewManager gefiltert, gesucht und navigiert werden kann.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

Ruft einen Wert ab, der angibt, ob sich die Komponente gegenwärtig im Entwurfsmodus befindet.Gets a value indicating whether the component is currently in design mode.

(Inherited from MarshalByValueComponent)
EnforceConstraints EnforceConstraints EnforceConstraints EnforceConstraints

Ruft einen Wert ab, der angibt, ob bei Aktualisierungen Einschränkungsregeln beachtet werden, oder legt diesen fest.Gets or sets a value indicating whether constraint rules are followed when attempting any update operation.

Events Events Events Events

Ruft die Liste der an diese Komponente angefügten Ereignishandler ab.Gets the list of event handlers that are attached to this component.

(Inherited from MarshalByValueComponent)
ExtendedProperties ExtendedProperties ExtendedProperties ExtendedProperties

Ruft die dem DataSet zugeordnete Auflistung von benutzerdefinierten Benutzerinformationen ab.Gets the collection of customized user information associated with the DataSet.

HasErrors HasErrors HasErrors HasErrors

Ruft einen Wert ab, der angibt, ob in diesem DataTable in einem der DataSet-Objekte Fehler vorliegen.Gets a value indicating whether there are errors in any of the DataTable objects within this DataSet.

IsInitialized IsInitialized IsInitialized IsInitialized

Ruft einen Wert ab, der angibt, ob die DataSet initialisiert wurde.Gets a value that indicates whether the DataSet is initialized.

Locale Locale Locale Locale

Ruft die Gebietsschemainformationen ab, die für den Vergleich von Zeichenfolgen in der Tabelle verwendet werden, oder legt diese fest.Gets or sets the locale information used to compare strings within the table.

Namespace Namespace Namespace Namespace

Ruft den Namespace der DataSet ab oder legt diesen fest.Gets or sets the namespace of the DataSet.

Prefix Prefix Prefix Prefix

Ruft ein XML-Präfix ab, das als Alias für den Namespace der DataSet fungiert, oder legt dieses fest.Gets or sets an XML prefix that aliases the namespace of the DataSet.

Relations Relations Relations Relations

Ruft die Collection der Beziehungen ab, die Tabellen verknüpfen und die Navigation von übergeordneten Tabellen zu untergeordneten Tabellen ermöglichen.Gets the collection of relations that link tables and allow navigation from parent tables to child tables.

RemotingFormat RemotingFormat RemotingFormat RemotingFormat

Ruft das SerializationFormat für das beim Remoting verwendete DataSet ab oder legt dieses fest.Gets or sets a SerializationFormat for the DataSet used during remoting.

SchemaSerializationMode SchemaSerializationMode SchemaSerializationMode SchemaSerializationMode

Ruft einen SchemaSerializationMode für ein DataSet ab oder legt diesen fest.Gets or sets a SchemaSerializationMode for a DataSet.

Site Site Site Site

Ruft eine ISite für die DataSet ab oder legt diese fest.Gets or sets an ISite for the DataSet.

Tables Tables Tables Tables

Ruft die Auflistung der im DataSet enthaltenen Tabellen ab.Gets the collection of tables contained in the DataSet.

Methoden

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

Führt einen Commit für alle Änderungen aus, die an diesem DataSet seit dem letzten Ladevorgang oder seit dem letzten Aufruf von AcceptChanges() vorgenommen wurden.Commits all the changes made to this DataSet since it was loaded or since the last time AcceptChanges() was called.

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

Beginnt die Initialisierung einer DataSet, die in einem Formular oder von einer anderen Komponente verwendet wird.Begins the initialization of a DataSet that is used on a form or used by another component. Die Initialisierung erfolgt zur Laufzeit.The initialization occurs at run time.

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

Entfernt alle Daten aus dem DataSet, indem alle Zeilen in sämtlichen Tabellen entfernt werden.Clears the DataSet of any data by removing all rows in all tables.

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

Kopiert die Struktur des DataSet, einschließlich aller Schemas, Beziehungen und Einschränkungen von DataTable.Copies the structure of the DataSet, including all DataTable schemas, relations, and constraints. Es werden keine Daten kopiert.Does not copy any data.

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

Kopiert die Struktur und die Daten für diese DataSet.Copies both the structure and data for this DataSet.

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

Gibt einen DataTableReader mit einem Resultset pro DataTable zurück, und zwar in der Reihenfolge der Tabellen in der Tables-Auflistung.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[])

Gibt einen DataTableReader mit einem Resultset pro DataTable zurück.Returns a DataTableReader with one result set per DataTable.

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

Bestimmt den SchemaSerializationMode für ein DataSet.Determines the SchemaSerializationMode for a DataSet.

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

Bestimmt den SchemaSerializationMode für ein DataSet.Determines the SchemaSerializationMode for a DataSet.

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

Gibt alle vom MarshalByValueComponent verwendeten Ressourcen frei.Releases all resources used by the MarshalByValueComponent.

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

Gibt die von MarshalByValueComponent verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.Releases the unmanaged resources used by the MarshalByValueComponent and optionally releases the managed resources.

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

Beendet die Initialisierung eines DataSet, der in einem Formular oder von einer anderen Komponente verwendet wird.Ends the initialization of a DataSet that is used on a form or used by another component. Die Initialisierung erfolgt zur Laufzeit.The initialization occurs at run time.

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

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

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

Ruft eine Kopie des DataSet ab, die sämtliche seit dem letzten Laden oder seit dem letzten Aufruf von AcceptChanges() vorgenommenen Änderungen enthält.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)

Ruft eine Kopie der DataSet ab, die alle seit dem letzten Laden oder seit dem letzten Aufruf von AcceptChanges() vorgenommenen und durch DataRowState gefilterten Änderungen enthält.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)

Ruft eine Kopie von XmlSchemaSet für das DataSet ab.Gets a copy of XmlSchemaSet for the DataSet.

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

Fungiert als Standardhashfunktion.Serves as the default hash function.

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

Füllt ein Serialisierungsinformationsobjekt mit den Daten, die zum Serialisieren des DataSet erforderlich sind.Populates a serialization information object with the data needed to serialize the DataSet.

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

Gibt eine serialisierbare XmlSchema-Instanz zurück.Returns a serializable XmlSchema instance.

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

Deserialisiert die Tabellendaten aus dem Binär- oder XML-Stream.Deserializes the table data from the binary or XML stream.

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

Ruft die Implementierung von IServiceProvider ab.Gets the implementer of the IServiceProvider.

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

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

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

Gibt die XML-Darstellung der im DataSet gespeicherten Daten zurück.Returns the XML representation of the data stored in the DataSet.

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

Gibt das XSD-Schema für die XML-Darstellung der im DataSet gespeicherten Daten zurück.Returns the XML Schema for the XML representation of the data stored in the DataSet.

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

Ruft einen Wert ab, der angibt, ob das DataSet Änderungen aufweist, einschließlich neuer, gelöschter oder geänderter Zeilen.Gets a value indicating whether the DataSet has changes, including new, deleted, or modified rows.

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

Ruft einen Wert ab, der angibt, ob das DataSet Änderungen aufweist, einschließlich neuer, gelöschter oder geänderter Zeilen, gefiltert durch 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[])

Wendet das XML-Schema aus dem angegebenen Stream auf das DataSet an.Applies the XML schema from the specified Stream to the DataSet.

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

Wendet das XML-Schema aus der angegebenen Datei auf das DataSet an.Applies the XML schema from the specified file to the DataSet.

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

Wendet das XML-Schema aus dem angegebenen TextReader auf das DataSet an.Applies the XML schema from the specified TextReader to the DataSet.

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

Wendet das XML-Schema aus dem angegebenen XmlReader auf das DataSet an.Applies the XML schema from the specified XmlReader to the DataSet.

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

Deserialisiert alle Tabellendaten des Dataset aus dem Binär- oder XML-Stream.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)

Überprüft das Format der serialisierten Darstellung des 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[])

Füllt ein DataSet mit Werten aus einer Datenquelle. Dazu werden der bereitgestellte IDataReader sowie ein Array von DataTable-Instanzen verwendet, mit dem Schema- und Namespaceinformationen bereitgestellt werden.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[])

Füllt ein DataSet mit Werten aus einer Datenquelle. Dazu werden der bereitgestellte IDataReader sowie ein Array von DataTable-Instanzen verwendet, mit dem Schema- und Namespaceinformationen bereitgestellt werden.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[])

Füllt ein DataSet mit Werten aus einer Datenquelle. Dazu wird der bereitgestellte IDataReader sowie ein Array von Zeichenfolgen verwendet, mit dem die Namen der Tabellen im DataSet bereitgestellt werden.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()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

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

Führt ein Array von DataRow-Objekten mit dem aktuellen DataSet zusammen.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)

Führt ein Array von DataRow-Objekten mit dem aktuellen DataSet zusammen. Dabei werden Änderungen des DataSet entsprechend den angegebenen Argumenten beibehalten oder verworfen, und ein nicht kompatibles Schema wird entsprechend den angegebenen Argumenten behandelt.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)

Führt ein angegebenes DataSet und das entsprechende Schema mit dem aktuellen DataSet zusammen.Merges a specified DataSet and its schema into the current DataSet.

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

Führt ein angegebenes DataSet und sein Schema mit dem aktuellen DataSet zusammen. Dabei werden entsprechend dem angegebenen Argument alle Änderungen in diesem DataSet beibehalten oder verworfen.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)

Führt ein angegebenes DataSet und sein Schema mit dem aktuellen DataSet zusammen. Dabei werden Änderungen des aktuellen DataSet entsprechend den angegebenen Argumenten beibehalten oder verworfen, und ein nicht kompatibles Schema wird entsprechend den angegebenen Argumenten behandelt.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)

Führt ein angegebenes DataTable und das entsprechende Schema mit dem aktuellen DataSet zusammen.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)

Führt eine angegebene DataTable und ihr Schema mit dem aktuellen DataSet zusammen. Dabei werden Änderungen des aktuellen DataSet entsprechend den angegebenen Argumenten beibehalten oder verworfen, und ein nicht kompatibles Schema wird entsprechend den angegebenen Argumenten behandelt.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)

Löst das OnPropertyChanging(PropertyChangedEventArgs)-Ereignis aus.Raises the OnPropertyChanging(PropertyChangedEventArgs) event.

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

Tritt beim Entfernen eines DataRelation-Objekts aus einer DataTable ein.Occurs when a DataRelation object is removed from a DataTable.

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

Tritt beim Entfernen einer DataTable aus einem DataSet ein.Occurs when a DataTable is removed from a DataSet.

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

Sendet eine Benachrichtigung, dass die angegebene DataSet-Eigenschaft gerade geändert wird.Sends a notification that the specified DataSet property is about to change.

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

Liest mit dem angegebenen DataSet das XML-Schema und die XML-Daten in die Stream.Reads XML schema and data into the DataSet using the specified Stream.

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

Liest mit dem angegebenen DataSet und im angegebenen Stream das XML-Schema und die XML-Daten in das XmlReadMode.Reads XML schema and data into the DataSet using the specified Stream and XmlReadMode.

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

Liest mithilfe der angegebenen Datei das XML-Schema und die XML-Daten in das DataSet.Reads XML schema and data into the DataSet using the specified file.

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

Liest mit der angegebenen Datei und im angegebenen DataSet das XML-Schema und die XML-Daten in das XmlReadMode.Reads XML schema and data into the DataSet using the specified file and XmlReadMode.

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

Liest mit dem angegebenen DataSet das XML-Schema und die XML-Daten in die TextReader.Reads XML schema and data into the DataSet using the specified TextReader.

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

Liest mit dem angegebenen DataSet und im angegebenen TextReader das XML-Schema und die XML-Daten in das XmlReadMode.Reads XML schema and data into the DataSet using the specified TextReader and XmlReadMode.

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

Liest mit dem angegebenen DataSet das XML-Schema und die XML-Daten in die XmlReader.Reads XML schema and data into the DataSet using the specified XmlReader.

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

Liest mit dem angegebenen DataSet und im angegebenen XmlReader das XML-Schema und die XML-Daten in das XmlReadMode.Reads XML schema and data into the DataSet using the specified XmlReader and XmlReadMode.

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

Liest das XML-Schema aus dem angegebenen Stream in das DataSet.Reads the XML schema from the specified Stream into the DataSet.

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

Liest das XML-Schema aus der angegebenen Datei in das DataSet.Reads the XML schema from the specified file into the DataSet.

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

Liest das XML-Schema aus dem angegebenen TextReader in das DataSet.Reads the XML schema from the specified TextReader into the DataSet.

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

Liest das XML-Schema aus dem angegebenen XmlReader in das DataSet.Reads the XML schema from the specified XmlReader into the DataSet.

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

Ignoriert Attribute und gibt ein leeres DataSet zurück.Ignores attributes and returns an empty DataSet.

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

Führt einen Rollback aller Änderungen aus, die am DataSet seit dessen Erstellung oder seit dem letzten Aufruf von AcceptChanges() vorgenommen wurden.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()

Löscht alle Tabellen und entfernt alle Beziehungen, Einschränkungen und fremden Tabellen von DataSet.Clears all tables and removes all relations, foreign constraints, and tables from the DataSet. Untergeordnete Klassen müssen Reset() überschreiben, um ein DataSet mit dem ursprünglichen Zustand wiederherzustellen.Subclasses should override Reset() to restore a DataSet to its original state.

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

Ruft einen Wert ab, der angibt, ob die Relations-Eigenschaft beibehalten werden soll.Gets a value indicating whether Relations property should be persisted.

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

Ruft einen Wert ab, der angibt, ob die Tables-Eigenschaft beibehalten werden soll.Gets a value indicating whether Tables property should be persisted.

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

Gibt einen String zurück, der den Namen der Component enthält (sofern vorhanden).Returns a String containing the name of the Component, if any. Diese Methode darf nicht überschrieben werden.This method should not be overridden.

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

Schreibt mit dem angegebenen DataSet die aktuellen Daten für das Stream.Writes the current data for the DataSet using the specified Stream.

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

Schreibt mit dem angegebenen DataSet und im angegebenen Stream die aktuellen Daten und bei Bedarf das Schema für die XmlWriteMode.Writes the current data, and optionally the schema, for the DataSet using the specified Stream and XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest.To write the schema, set the value for the mode parameter to WriteSchema.

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

Schreibt die aktuellen Daten für das DataSet in die angegebene Datei.Writes the current data for the DataSet to the specified file.

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

Schreibt im angegebenen DataSet die aktuellen Daten und bei Bedarf das Schema für die XmlWriteMode in die angegebene Datei.Writes the current data, and optionally the schema, for the DataSet to the specified file using the specified XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest.To write the schema, set the value for the mode parameter to WriteSchema.

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

Schreibt mit dem angegebenen DataSet die aktuellen Daten für das TextWriter.Writes the current data for the DataSet using the specified TextWriter.

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

Schreibt mit dem angegebenen DataSet und im angegebenen TextWriter die aktuellen Daten und bei Bedarf das Schema für die XmlWriteMode.Writes the current data, and optionally the schema, for the DataSet using the specified TextWriter and XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest.To write the schema, set the value for the mode parameter to WriteSchema.

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

Schreibt die aktuellen Daten für das DataSet in den angegebenen XmlWriter.Writes the current data for the DataSet to the specified XmlWriter.

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

Schreibt mit dem angegebenen DataSet und im angegebenen XmlWriter die aktuellen Daten und bei Bedarf das Schema für die XmlWriteMode.Writes the current data, and optionally the schema, for the DataSet using the specified XmlWriter and XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest.To write the schema, set the value for the mode parameter to WriteSchema.

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

Schreibt die DataSet-Struktur als XML-Schema in das angegebene Stream-Objekt.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>)

Schreibt die DataSet-Struktur als XML-Schema in das angegebene Stream-Objekt.Writes the DataSet structure as an XML schema to the specified Stream object.

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

Schreibt die DataSet-Struktur als XML-Schema in eine Datei.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>)

Schreibt die DataSet-Struktur als XML-Schema in eine Datei.Writes the DataSet structure as an XML schema to a file.

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

Schreibt die DataSet-Struktur als XML-Schema in das angegebene TextWriter-Objekt.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>)

Schreibt die DataSet-Struktur als XML-Schema in den angegebenen TextWriter.Writes the DataSet structure as an XML schema to the specified TextWriter.

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

Schreibt die DataSet-Struktur als XML-Schema in ein XmlWriter-Objekt.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>)

Schreibt die DataSet-Struktur als XML-Schema in den angegebenen XmlWriter.Writes the DataSet structure as an XML schema to the specified XmlWriter.

Ereignisse

Disposed Disposed Disposed Disposed

Fügt einen Ereignishandler hinzu, der das Disposed-Ereignis für die Komponente überwacht.Adds an event handler to listen to the Disposed event on the component.

(Inherited from MarshalByValueComponent)
Initialized Initialized Initialized Initialized

Tritt nach dem Initialisieren der DataSet auf.Occurs after the DataSet is initialized.

MergeFailed MergeFailed MergeFailed MergeFailed

Tritt auf, wenn eine Ziel- und eine Quell-DataRow denselben Primärschlüsselwert aufweisen und EnforceConstraints auf True festgelegt ist.Occurs when a target and source DataRow have the same primary key value, and EnforceConstraints is set to true.

Explizite Schnittstellenimplementierungen

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

Eine Beschreibung dieses Members finden Sie unter ContainsListCollection.For a description of this member, see ContainsListCollection.

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

Eine Beschreibung dieses Members finden Sie unter 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)

Füllt ein Serialisierungsinformationsobjekt mit den Daten, die zum Serialisieren des DataSet erforderlich sind.Populates a serialization information object with the data needed to serialize the DataSet.

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

Eine Beschreibung dieses Members finden Sie unter GetSchema().For a description of this member, see GetSchema().

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

Eine Beschreibung dieses Members finden Sie unter ReadXml(XmlReader).For a description of this member, see ReadXml(XmlReader).

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

Eine Beschreibung dieses Members finden Sie unter WriteXml(XmlWriter).For a description of this member, see WriteXml(XmlWriter).

Gilt für:

Threadsicherheit

Dieser Typ ist für schreibgeschützte Vorgänge mit mehreren Threads sicher.This type is safe for multithreaded read operations. Sie müssen die Schreibvorgänge synchronisieren.You must synchronize any write operations.

Siehe auch