Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.
Übersetzung
Original
1 von 1 fanden dies hilfreich - Dieses Thema bewerten.

DataSet-Klasse

Stellt einen speicherinternen Datencache dar.

Namespace:  System.Data
Assembly:  System.Data (in System.Data.dll)
[SerializableAttribute]
public class DataSet : MarshalByValueComponent, IListSource, 
	IXmlSerializable, ISupportInitializeNotification, ISupportInitialize, ISerializable

Der DataSet-Typ macht die folgenden Member verfügbar.

  Name Beschreibung
Öffentliche Methode Unterstützt von XNA Framework DataSet() Initialisiert eine neue Instanz der DataSet-Klasse.
Öffentliche Methode Unterstützt von XNA Framework DataSet(String) Initialisiert eine neue Instanz einer DataSet-Klasse mit dem angegebenen Namen.
Geschützte Methode DataSet(SerializationInfo, StreamingContext) Infrastruktur. Initialisiert eine neue Instanz einer DataSet-Klasse, die über die angegebenen Serialisierungsinformationen und den angegebenen Kontext verfügt.
Geschützte Methode DataSet(SerializationInfo, StreamingContext, Boolean) Infrastruktur. Initialisiert eine neue Instanz der DataSet-Klasse.
Zum Seitenanfang
  Name Beschreibung
Öffentliche Eigenschaft Unterstützt von XNA Framework CaseSensitive Ruft einen Wert ab, der angibt, ob bei Zeichenfolgenvergleichen in DataTable-Objekten die Groß- und Kleinschreibung berücksichtigt wird, oder legt diesen fest.
Öffentliche Eigenschaft Unterstützt von XNA Framework Container Ruft den Container für die Komponente ab. (Von MarshalByValueComponent geerbt.)
Öffentliche Eigenschaft Unterstützt von XNA Framework DataSetName Ruft den Namen des aktuellen DataSet ab oder legt diesen fest.
Öffentliche Eigenschaft Unterstützt von XNA Framework DefaultViewManager Ruft eine benutzerdefinierte Ansicht der im DataSet enthaltenen Daten ab, mit der unter Verwendung eines benutzerdefinierten DataViewManager gefiltert, gesucht und navigiert werden kann.
Öffentliche Eigenschaft Unterstützt von XNA Framework DesignMode Ruft einen Wert ab, der angibt, ob sich die Komponente gegenwärtig im Entwurfsmodus befindet. (Von MarshalByValueComponent geerbt.)
Öffentliche Eigenschaft Unterstützt von XNA Framework EnforceConstraints Ruft einen Wert ab, der angibt, ob bei Aktualisierungen Einschränkungsregeln beachtet werden, oder legt diesen fest.
Geschützte Eigenschaft Unterstützt von XNA Framework Events Ruft die Liste der an diese Komponente angefügten Ereignishandler ab. (Von MarshalByValueComponent geerbt.)
Öffentliche Eigenschaft Unterstützt von XNA Framework ExtendedProperties Ruft die dem DataSet zugeordnete Auflistung von benutzerdefinierten Benutzerinformationen ab.
Öffentliche Eigenschaft Unterstützt von XNA Framework HasErrors Ruft einen Wert ab, der angibt, ob in diesem DataSet in einem der DataTable-Objekte Fehler vorliegen.
Öffentliche Eigenschaft Unterstützt von XNA Framework IsInitialized Ruft einen Wert ab, der angibt, ob die DataSet initialisiert wurde.
Öffentliche Eigenschaft Unterstützt von XNA Framework Locale Ruft die Gebietsschemainformationen ab, die für den Vergleich von Zeichenfolgen in der Tabelle verwendet werden, oder legt diese fest.
Öffentliche Eigenschaft Unterstützt von XNA Framework Namespace Ruft den Namespace des DataSet ab oder legt diesen fest.
Öffentliche Eigenschaft Unterstützt von XNA Framework Prefix Ruft ein XML-Präfix ab, das als Alias für den Namespace des DataSet fungiert, oder legt dieses fest.
Öffentliche Eigenschaft Unterstützt von XNA Framework Relations Ruft die Auflistung der Beziehungen ab, die Tabellen verknüpfen und die Navigation von übergeordneten Tabellen zu untergeordneten Tabellen ermöglichen.
Öffentliche Eigenschaft RemotingFormat Ruft das SerializationFormat für das beim Remoting verwendete DataSet ab oder legt dieses fest.
Öffentliche Eigenschaft Unterstützt von XNA Framework SchemaSerializationMode Ruft einen SchemaSerializationMode für ein DataSet ab oder legt diesen fest.
Öffentliche Eigenschaft Unterstützt von XNA Framework Site Ruft eine System.ComponentModel.ISite für das DataSet ab oder legt diese fest. (Überschreibt MarshalByValueComponent.Site.)
Öffentliche Eigenschaft Unterstützt von XNA Framework Tables Ruft die Auflistung der im DataSet enthaltenen Tabellen ab.
Zum Seitenanfang
  Name Beschreibung
Öffentliche Methode Unterstützt von XNA Framework 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.
Öffentliche Methode Unterstützt von XNA Framework BeginInit Beginnt die Initialisierung eines DataSet, das in einem Formular oder von einer anderen Komponente verwendet wird. Die Initialisierung erfolgt zur Laufzeit.
Öffentliche Methode Unterstützt von XNA Framework Clear Entfernt alle Daten aus dem DataSet, indem alle Zeilen in sämtlichen Tabellen entfernt werden.
Öffentliche Methode Unterstützt von XNA Framework Clone Kopiert die Struktur des DataSet, einschließlich aller Schemas, Beziehungen und Einschränkungen von DataTable. Es werden keine Daten kopiert.
Öffentliche Methode Unterstützt von XNA Framework Copy Kopiert die Struktur und die Daten für dieses DataSet.
Öffentliche Methode Unterstützt von XNA Framework CreateDataReader() Gibt einen DataTableReader mit einem Resultset pro DataTable zurück, und zwar in der Reihenfolge der Tabellen in der Tables-Auflistung.
Öffentliche Methode Unterstützt von XNA Framework CreateDataReader(DataTable[]) Gibt einen DataTableReader mit einem Resultset pro DataTable zurück.
Geschützte Methode Unterstützt von XNA Framework DetermineSchemaSerializationMode(XmlReader) Bestimmt den SchemaSerializationMode für ein DataSet.
Geschützte Methode DetermineSchemaSerializationMode(SerializationInfo, StreamingContext) Bestimmt den SchemaSerializationMode für ein DataSet.
Öffentliche Methode Unterstützt von XNA Framework Dispose() Gibt sämtliche von der MarshalByValueComponent verwendeten Ressourcen frei. (Von MarshalByValueComponent geerbt.)
Geschützte Methode Unterstützt von XNA Framework Dispose(Boolean) Gibt die vom MarshalByValueComponent verwendeten nicht verwalteten Ressourcen und optional auch die verwalteten Ressourcen frei. (Von MarshalByValueComponent geerbt.)
Öffentliche Methode Unterstützt von XNA Framework EndInit Beendet die Initialisierung eines DataSet, das in einem Formular oder von einer anderen Komponente verwendet wird. Die Initialisierung erfolgt zur Laufzeit.
Öffentliche Methode Unterstützt von XNA Framework Equals(Object) Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.)
Geschützte Methode Unterstützt von XNA Framework Finalize Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der automatische Speicherbereinigung freigegeben wird. (Von MarshalByValueComponent geerbt.)
Öffentliche Methode Unterstützt von XNA Framework 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.
Öffentliche Methode Unterstützt von XNA Framework GetChanges(DataRowState) Ruft eine Kopie des DataSet ab, die sämtliche seit dem letzten Laden oder seit dem letzten Aufruf von AcceptChanges vorgenommenen Änderungen enthält, gefiltert durch DataRowState.
Öffentliche Methode Statischer Member Unterstützt von XNA Framework GetDataSetSchema Infrastruktur. Ruft eine Kopie von XmlSchemaSet für das DataSet ab.
Öffentliche Methode Unterstützt von XNA Framework GetHashCode Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
Öffentliche Methode GetObjectData Füllt ein Serialisierungsinformationsobjekt mit den Daten, die zum Serialisieren des DataSet erforderlich sind.
Geschützte Methode Unterstützt von XNA Framework GetSchemaSerializable Infrastruktur. Gibt eine serialisierbare XMLSchema-Instanz zurück.
Geschützte Methode GetSerializationData Infrastruktur. Deserialisiert die Tabellendaten aus dem Binär- oder XML-Stream.
Öffentliche Methode Unterstützt von XNA Framework GetService Ruft die Implementierung von IServiceProvider ab. (Von MarshalByValueComponent geerbt.)
Öffentliche Methode Unterstützt von XNA Framework GetType Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Öffentliche Methode Unterstützt von XNA Framework GetXml Gibt die XML-Darstellung der im DataSet gespeicherten Daten zurück.
Öffentliche Methode Unterstützt von XNA Framework GetXmlSchema Gibt das XSD-Schema für die XML-Darstellung der im DataSet gespeicherten Daten zurück.
Öffentliche Methode Unterstützt von XNA Framework HasChanges() Ruft einen Wert ab, der angibt, ob das DataSet Änderungen aufweist, einschließlich neuer, gelöschter oder geänderter Zeilen.
Öffentliche Methode Unterstützt von XNA Framework 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.
Öffentliche Methode Unterstützt von XNA Framework InferXmlSchema(Stream, String[]) Wendet das XML-Schema aus dem angegebenen Stream auf das DataSet an.
Öffentliche Methode Unterstützt von XNA Framework InferXmlSchema(String, String[]) Wendet das XML-Schema aus der angegebenen Datei auf das DataSet an.
Öffentliche Methode Unterstützt von XNA Framework InferXmlSchema(TextReader, String[]) Wendet das XML-Schema aus dem angegebenen TextReader auf das DataSet an.
Öffentliche Methode Unterstützt von XNA Framework InferXmlSchema(XmlReader, String[]) Wendet das XML-Schema aus dem angegebenen XmlReader auf das DataSet an.
Geschützte Methode Unterstützt von XNA Framework InitializeDerivedDataSet Infrastruktur. Deserialisiert alle Tabellendaten des Dataset aus dem Binär- oder XML-Stream.
Geschützte Methode IsBinarySerialized Überprüft das Format der serialisierten Darstellung des DataSet.
Öffentliche Methode Unterstützt von XNA Framework 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.
Öffentliche Methode Unterstützt von XNA Framework 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.
Öffentliche Methode Unterstützt von XNA Framework 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.
Geschützte Methode Unterstützt von XNA Framework MemberwiseClone Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Öffentliche Methode Unterstützt von XNA Framework Merge(DataRow[]) Führt ein Array von DataRow-Objekten mit dem aktuellen DataSet zusammen.
Öffentliche Methode Unterstützt von XNA Framework Merge(DataSet) Führt ein angegebenes DataSet und das entsprechende Schema mit dem aktuellen DataSet zusammen.
Öffentliche Methode Unterstützt von XNA Framework Merge(DataTable) Führt eine angegebene DataTable und das entsprechende Schema mit dem aktuellen DataSet zusammen.
Öffentliche Methode Unterstützt von XNA Framework 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.
Öffentliche Methode Unterstützt von XNA Framework 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.
Öffentliche Methode Unterstützt von XNA Framework 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.
Öffentliche Methode Unterstützt von XNA Framework 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.
Geschützte Methode Unterstützt von XNA Framework OnPropertyChanging Löst das OnPropertyChanging-Ereignis aus.
Geschützte Methode Unterstützt von XNA Framework OnRemoveRelation Tritt beim Entfernen eines DataRelation-Objekts aus einer DataTable ein.
Geschützte Methode Unterstützt von XNA Framework OnRemoveTable Tritt beim Entfernen einer DataTable aus einem DataSet ein.
Geschützte Methode Unterstützt von XNA Framework RaisePropertyChanging Sendet eine Benachrichtigung, dass die angegebene DataSet-Eigenschaft gerade geändert wird.
Öffentliche Methode Unterstützt von XNA Framework ReadXml(Stream) Liest mit dem angegebenen System.IO.Stream das XML-Schema und die XML-Daten in das DataSet.
Öffentliche Methode Unterstützt von XNA Framework ReadXml(String) Liest mithilfe der angegebenen Datei das XML-Schema und die XML-Daten in das DataSet.
Öffentliche Methode Unterstützt von XNA Framework ReadXml(TextReader) Liest mit dem angegebenen System.IO.TextReader das XML-Schema und die XML-Daten in das DataSet.
Öffentliche Methode Unterstützt von XNA Framework ReadXml(XmlReader) Liest mit dem angegebenen System.Xml.XmlReader das XML-Schema und die XML-Daten in das DataSet.
Öffentliche Methode Unterstützt von XNA Framework ReadXml(Stream, XmlReadMode) Liest mit dem angegebenen System.IO.Stream und im angegebenen XmlReadMode das XML-Schema und die XML-Daten in das DataSet.
Öffentliche Methode Unterstützt von XNA Framework ReadXml(String, XmlReadMode) Liest mit der angegebenen Datei und im angegebenen XmlReadMode das XML-Schema und die XML-Daten in das DataSet.
Öffentliche Methode Unterstützt von XNA Framework ReadXml(TextReader, XmlReadMode) Liest mit dem angegebenen System.IO.TextReader und im angegebenen XmlReadMode das XML-Schema und die XML-Daten in das DataSet.
Öffentliche Methode Unterstützt von XNA Framework ReadXml(XmlReader, XmlReadMode) Liest mit dem angegebenen System.Xml.XmlReader und im angegebenen XmlReadMode das XML-Schema und die XML-Daten in das DataSet.
Öffentliche Methode Unterstützt von XNA Framework ReadXmlSchema(Stream) Liest das XML-Schema aus dem angegebenen Stream in das DataSet.
Öffentliche Methode Unterstützt von XNA Framework ReadXmlSchema(String) Liest das XML-Schema aus der angegebenen Datei in das DataSet.
Öffentliche Methode Unterstützt von XNA Framework ReadXmlSchema(TextReader) Liest das XML-Schema aus dem angegebenen TextReader in das DataSet.
Öffentliche Methode Unterstützt von XNA Framework ReadXmlSchema(XmlReader) Liest das XML-Schema aus dem angegebenen XmlReader in das DataSet.
Geschützte Methode Unterstützt von XNA Framework ReadXmlSerializable Infrastruktur. Ignoriert Attribute und gibt ein leeres DataSet zurück.
Öffentliche Methode Unterstützt von XNA Framework RejectChanges Führt einen Rollback aller Änderungen aus, die am DataSet seit dessen Erstellung oder seit dem letzten Aufruf von DataSet.AcceptChanges vorgenommen wurden.
Öffentliche Methode Unterstützt von XNA Framework Reset Setzt das DataSet auf den ursprünglichen Zustand zurück. Untergeordnete Klassen müssen Reset überschreiben, um ein DataSet mit dem ursprünglichen Zustand wiederherzustellen.
Geschützte Methode Unterstützt von XNA Framework ShouldSerializeRelations Ruft einen Wert ab, der angibt, ob die Relations-Eigenschaft beibehalten werden soll.
Geschützte Methode Unterstützt von XNA Framework ShouldSerializeTables Ruft einen Wert ab, der angibt, ob die Tables-Eigenschaft beibehalten werden soll.
Öffentliche Methode Unterstützt von XNA Framework ToString Gibt einen String zurück, der den Namen dieser Component enthält, sofern vorhanden. Diese Methode sollte nicht überschrieben werden. (Von MarshalByValueComponent geerbt.)
Öffentliche Methode Unterstützt von XNA Framework WriteXml(Stream) Schreibt mit dem angegebenen System.IO.Stream die aktuellen Daten für das DataSet.
Öffentliche Methode Unterstützt von XNA Framework WriteXml(String) Schreibt die aktuellen Daten für das DataSet in die angegebene Datei.
Öffentliche Methode Unterstützt von XNA Framework WriteXml(TextWriter) Schreibt mit dem angegebenen TextWriter die aktuellen Daten für das DataSet.
Öffentliche Methode Unterstützt von XNA Framework WriteXml(XmlWriter) Schreibt die aktuellen Daten für das DataSet in den angegebenen XmlWriter.
Öffentliche Methode Unterstützt von XNA Framework WriteXml(Stream, XmlWriteMode) Schreibt mit dem angegebenen System.IO.Stream und im angegebenen XmlWriteMode die aktuellen Daten und bei Bedarf das Schema für das DataSet. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest.
Öffentliche Methode Unterstützt von XNA Framework WriteXml(String, XmlWriteMode) Schreibt im angegebenen XmlWriteMode die aktuellen Daten und bei Bedarf das Schema für das DataSet in die angegebene Datei. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest.
Öffentliche Methode Unterstützt von XNA Framework WriteXml(TextWriter, XmlWriteMode) Schreibt mit dem angegebenen TextWriter und im angegebenen XmlWriteMode die aktuellen Daten und bei Bedarf das Schema für das DataSet. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest.
Öffentliche Methode Unterstützt von XNA Framework WriteXml(XmlWriter, XmlWriteMode) Schreibt mit dem angegebenen XmlWriter und im angegebenen XmlWriteMode die aktuellen Daten und bei Bedarf das Schema für das DataSet. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest.
Öffentliche Methode Unterstützt von XNA Framework WriteXmlSchema(Stream) Schreibt die DataSet-Struktur als XML-Schema in das angegebene System.IO.Stream-Objekt.
Öffentliche Methode Unterstützt von XNA Framework WriteXmlSchema(String) Schreibt die DataSet-Struktur als XML-Schema in eine Datei.
Öffentliche Methode Unterstützt von XNA Framework WriteXmlSchema(TextWriter) Schreibt die DataSet-Struktur als XML-Schema in das angegebene TextWriter-Objekt.
Öffentliche Methode Unterstützt von XNA Framework WriteXmlSchema(XmlWriter) Schreibt die DataSet-Struktur als XML-Schema in ein XmlWriter-Objekt.
Öffentliche Methode WriteXmlSchema(Stream, Converter<Type, String>) Schreibt die DataSet-Struktur als XML-Schema in das angegebene System.IO.Stream-Objekt.
Öffentliche Methode WriteXmlSchema(String, Converter<Type, String>) Schreibt die DataSet-Struktur als XML-Schema in eine Datei.
Öffentliche Methode WriteXmlSchema(TextWriter, Converter<Type, String>) Schreibt die DataSet-Struktur als XML-Schema in den angegebenen TextWriter.
Öffentliche Methode WriteXmlSchema(XmlWriter, Converter<Type, String>) Schreibt die DataSet-Struktur als XML-Schema in den angegebenen XmlWriter.
Zum Seitenanfang
  Name Beschreibung
Öffentliches Ereignis Unterstützt von XNA Framework Disposed Fügt einen Ereignishandler hinzu, der das Disposed-Ereignis für die Komponente überwacht. (Von MarshalByValueComponent geerbt.)
Öffentliches Ereignis Unterstützt von XNA Framework Initialized Tritt nach dem Initialisieren des DataSet ein.
Öffentliches Ereignis Unterstützt von XNA Framework MergeFailed Tritt auf, wenn eine Ziel- und eine Quell-DataRow denselben Primärschlüsselwert aufweisen und EnforceConstraints auf True festgelegt ist.
Zum Seitenanfang
  Name Beschreibung
Explizite Schnittstellenimplementierung Private Eigenschaft Unterstützt von XNA Framework IListSource.ContainsListCollection Eine Beschreibung dieses Members finden Sie unter IListSource.ContainsListCollection.
Explizite Schnittstellenimplementierung Private Methode Unterstützt von XNA Framework IListSource.GetList Eine Beschreibung dieses Members finden Sie unter IListSource.GetList.
Explizite Schnittstellenimplementierung Private Methode Unterstützt von XNA Framework IXmlSerializable.GetSchema Eine Beschreibung dieses Members finden Sie unter der IXmlSerializable.GetSchema-Methode.
Explizite Schnittstellenimplementierung Private Methode Unterstützt von XNA Framework IXmlSerializable.ReadXml Eine Beschreibung dieses Members finden Sie unter IXmlSerializable.ReadXml.
Explizite Schnittstellenimplementierung Private Methode Unterstützt von XNA Framework IXmlSerializable.WriteXml Eine Beschreibung dieses Members finden Sie unter IXmlSerializable.WriteXml.
Zum Seitenanfang

Das DataSet, ein aus einer Datenquelle abgerufener Datencache im Arbeitsspeicher, ist eine Hauptkomponente der ADO.NET-Architektur. Das DataSet besteht aus einer Auflistung von DataTable-Objekten, die Sie mit DataRelation-Objekten aufeinander beziehen können. Sie können die Datenintegrität im DataSet auch mithilfe des UniqueConstraint-Objekts und des ForeignKeyConstraint-Objekts erzwingen. Weitere Informationen über das Arbeiten mit DataSet-Objekten finden Sie unter DataSets, DataTables und DataViews (ADO.NET).

Während DataTable-Objekte die Daten enthalten, ermöglicht Ihnen DataRelationCollection das Navigieren in der Tabellenhierarchie. Die Tabellen befinden sich in einer DataTableCollection, auf die Sie über die Tables-Eigenschaft zugreifen. Beachten Sie beim Zugriff auf DataTable-Objekte, dass für diese die Groß- bzw. Kleinschreibung bedingt beachtet wird. Wenn z. B. eine DataTable "mydatatable" und eine weitere "Mydatatable" benannt ist, wird in einer Zeichenfolge zum Suchen einer dieser Tabellen die Groß- und Kleinschreibung unterschieden. Wenn jedoch "mydatatable", aber nicht "Mydatatable" vorhanden ist, wird in der Suchzeichenfolge die Groß- und Kleinschreibung nicht unterschieden. Weitere Informationen über das Arbeiten mit DataTable-Objekten finden Sie unter Erstellen einer 'DataTable' (ADO.NET).

Ein DataSet kann Daten sowie das Schema als XML-Dokumente lesen und schreiben. Die Daten und das Schema können dann über HTTP übertragen und von sämtlichen Anwendungen auf allen XML-fähigen Plattformen verwendet werden. Sie können das Schema mit der WriteXmlSchema-Methode als XML-Schema speichern. Das Schema und die Daten können mithilfe der WriteXml-Methode gespeichert werden. Verwenden Sie zum Lesen eines XML-Dokuments mit Schema und Daten die ReadXml-Methode.

In einer typischen Implementierung mit mehreren Ebenen werden die folgenden Schritte zum Erstellen und Aktualisieren eines DataSet und zum anschließenden Aktualisieren der ursprünglichen Daten ausgeführt:

  1. Erstellen Sie mithilfe eines DataAdapter jede DataTable in einem DataSet, und füllen Sie sie mit Daten aus einer Datenquelle.

  2. Ändern Sie die Daten in einzelnen DataTable-Objekten, indem Sie DataRow-Objekte hinzufügen, aktualisieren oder löschen.

  3. Rufen Sie die GetChanges-Methode auf, um ein zweites DataSet zu erstellen, das nur die Änderungen an den Daten darstellt.

  4. Rufen Sie die Update-Methode von DataAdapter auf, und übergeben Sie das zweite DataSet als Argument.

  5. Rufen Sie die Merge-Methode auf, um die Änderungen aus dem zweiten DataSet mit dem ersten zusammenzuführen.

  6. Rufen Sie AcceptChanges für das DataSet auf. Sie können auch RejectChanges aufrufen, um die Änderungen zu verwerfen.

Hinweis Hinweis

Das DataSet-Objekt und das DataTable-Objekt erben von MarshalByValueComponent und unterstützen die ISerializable-Schnittstelle für Remoting. Remoting kann nur für diese ADO.NET-Objekte ausgeführt werden.

Hinweis Hinweis

Von DataSet geerbte Klassen werden nicht vom Garbage Collector finalisiert, da der Finalizer in DataSet unterdrückt wird. Die abgeleitete Klasse kann die ReRegisterForFinalize-Methode in ihrem Konstruktor aufrufen, damit die Klasse vom Garbage Collector finalisiert werden kann.

Im folgenden Beispiel erstellen und füllen mehrere kombinierte Methoden ein DataSet aus der Datenbank Northwind.


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

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

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

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

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

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

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

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

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

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

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

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

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

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


.NET Framework

Unterstützt in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Dieser Typ ist bei Multithread-Lesevorgängen sicher. Sie müssen alle Schreibvorgänge synchronisieren.

Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
Community-Inhalt Hinzufügen
Anmerkungen FAQ