Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. |
Übersetzung
Original
|
DataTable-Klasse
Stellt eine Tabelle mit speicherinternen Daten dar.
System.ComponentModel.MarshalByValueComponent
System.Data.DataTable
System.Data.TypedTableBase<T>
Assembly: System.Data (in System.Data.dll)
Der DataTable-Typ macht die folgenden Member verfügbar.
| Name | Beschreibung | |
|---|---|---|
|
DataTable() | Initialisiert eine neue Instanz der DataTable-Klasse ohne Argumente. |
|
DataTable(String) | Initialisiert eine neue Instanz der DataTable-Klasse mit dem angegebenen Tabellennamen. |
|
DataTable(SerializationInfo, StreamingContext) | Initialisiert eine neue Instanz der DataTable-Klasse mit der SerializationInfo und dem StreamingContext. |
|
DataTable(String, String) | Initialisiert eine neue Instanz der DataTable-Klasse mit dem angegebenen Tabellennamen und Namespace. |
| Name | Beschreibung | |
|---|---|---|
|
CaseSensitive | Gibt an, ob Vergleiche zwischen Zeichenfolgen in der Tabelle unter Berücksichtigung der Groß- und Kleinschreibung ausgeführt werden. |
|
ChildRelations | Ruft die Auflistung untergeordneter Beziehungen für diese DataTable ab. |
|
Columns | Ruft die Auflistung der Spalten ab, die zu dieser Tabelle gehören. |
|
Constraints | Ruft die Auflistung der Einschränkungen ab, die von dieser Tabelle verwaltet werden. |
|
Container | Ruft den Container für die Komponente ab. (Von MarshalByValueComponent geerbt.) |
|
DataSet | Ruft das DataSet ab, zu dem diese Tabelle gehört. |
|
DefaultView | Ruft eine benutzerdefinierte Sicht der Tabelle ab, wobei es sich um eine gefilterte Sicht oder eine Cursorposition handeln kann. |
|
DesignMode | Ruft einen Wert ab, der angibt, ob sich die Komponente gegenwärtig im Entwurfsmodus befindet. (Von MarshalByValueComponent geerbt.) |
|
DisplayExpression | Ruft den Ausdruck ab, der einen Wert für die Darstellung dieser Tabelle auf der Benutzeroberfläche zurückgibt, oder legt diesen fest. Mit der DisplayExpression-Eigenschaft können Sie den Namen dieser Tabelle auf einer Benutzeroberfläche anzeigen. |
|
Events | Ruft die Liste der an diese Komponente angefügten Ereignishandler ab. (Von MarshalByValueComponent geerbt.) |
|
ExtendedProperties | Ruft die Auflistung benutzerdefinierter Benutzerinformationen ab. |
|
HasErrors | Ruft einen Wert ab, der angibt, ob in einer Zeile in einer Tabelle des DataSet, zu dem die Tabelle gehört, Fehler aufgetreten sind. |
|
IsInitialized | Ruft einen Wert ab, der angibt, ob die DataTable initialisiert wurde. |
|
Locale | Ruft die Gebietsschemainformationen ab, die für den Vergleich von Zeichenfolgen in der Tabelle verwendet werden, oder legt diese fest. |
|
MinimumCapacity | Ruft die Ausgangsgröße für diese Tabelle ab oder legt diese fest. |
|
Namespace | Ruft den Namespace für die XML-Darstellung der in der DataTable gespeicherten Daten ab oder legt diesen fest. |
|
ParentRelations | Ruft die Auflistung übergeordneter Beziehungen für diese DataTable ab. |
|
Prefix | Ruft den Namespace für die XML-Darstellung der in der DataTable gespeicherten Daten ab oder legt diesen fest. |
|
PrimaryKey | Ruft ein Array von Spalten ab, die als Primärschlüssel für die Datentabelle verwendet werden, oder legt dieses fest. |
|
RemotingFormat | Ruft das Serialisierungsformat ab oder legt dieses fest. |
|
Rows | Ruft die Auflistung der Zeilen ab, die zu dieser Tabelle gehören. |
|
Site | Ruft eine System.ComponentModel.ISite für die DataTable ab oder legt diese fest. (Überschreibt MarshalByValueComponent.Site.) |
|
TableName | Ruft den Namen der DataTable ab oder legt diesen fest. |
| Name | Beschreibung | |
|---|---|---|
|
AcceptChanges | Übernimmt alle Änderungen, die an dieser Tabelle seit dem letzten Aufruf von AcceptChanges vorgenommen wurden. |
|
BeginInit | Beginnt die Initialisierung einer DataTable, die in einem Formular oder von einer anderen Komponente verwendet wird. Die Initialisierung erfolgt zur Laufzeit. |
|
BeginLoadData | Deaktiviert während des Ladens von Daten Benachrichtigungen, Indexverwaltung und Einschränkungen. |
|
Clear | Löscht alle Daten aus der DataTable. |
|
Clone | Klont die Struktur der DataTable, einschließlich aller Schemas und Einschränkungen der DataTable. |
|
Compute | Berechnet den angegebenen Ausdruck für die aktuellen Zeilen, die die Filterkriterien erfüllen. |
|
Copy | Kopiert die Struktur und die Daten für diese DataTable. |
|
CreateDataReader | Gibt einen DataTableReader zurück, der den Daten innerhalb dieser DataTable entspricht. |
|
CreateInstance | Infrastruktur. Erstellt eine neue Instanz von DataTable. |
|
Dispose() | Gibt sämtliche von der MarshalByValueComponent verwendeten Ressourcen frei. (Von MarshalByValueComponent geerbt.) |
|
Dispose(Boolean) | Gibt die vom MarshalByValueComponent verwendeten nicht verwalteten Ressourcen und optional auch die verwalteten Ressourcen frei. (Von MarshalByValueComponent geerbt.) |
|
EndInit | Beendet die Initialisierung einer DataTable, die in einem Formular oder von einer anderen Komponente verwendet wird. Die Initialisierung erfolgt zur Laufzeit. |
|
EndLoadData | Aktiviert nach dem Laden von Daten Benachrichtigungen, Indexverwaltung und Einschränkungen. |
|
Equals(Object) | Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.) |
|
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.) |
|
GetChanges() | Ruft eine Kopie der DataTable ab, die alle seit dem letzten Laden oder seit dem letzten Aufruf von AcceptChanges vorgenommenen Änderungen enthält. |
|
GetChanges(DataRowState) | Ruft eine Kopie der DataTable ab, die alle seit dem letzten Laden oder seit dem letzten Aufruf von AcceptChanges vorgenommenen und durch DataRowState gefilterten Änderungen enthält. |
|
GetDataTableSchema | Diese Methode gibt eine XmlSchemaSet-Instanz mit der WSDL (Web Services Description Language) zurück, die die DataTable für Webdienste beschreibt. |
|
GetErrors | Ruft ein Array von DataRow-Objekten ab, die Fehler enthalten. |
|
GetHashCode | Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.) |
|
GetObjectData | Füllt ein Serialisierungsinformationsobjekt mit den Daten, die zum Serialisieren des DataTable erforderlich sind. |
|
GetRowType | Infrastruktur. Ruft den Zeilentyp ab. |
|
GetSchema | Infrastruktur. Eine Beschreibung dieses Members finden Sie unter IXmlSerializable.GetSchema. |
|
GetService | Ruft die Implementierung von IServiceProvider ab. (Von MarshalByValueComponent geerbt.) |
|
GetType | Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.) |
|
ImportRow | Kopiert eine DataRow in eine DataTable, wobei alle Eigenschafteneinstellungen sowie die ursprünglichen und die aktuellen Werte beibehalten werden. |
|
Load(IDataReader) | Füllt eine DataTable mit Werten aus einer Datenquelle, die den angegebenen IDataReader verwendet. Wenn die DataTable bereits Zeilen enthält, werden die eingehenden Daten aus der Datenquelle mit den vorhandenen Zeilen zusammengeführt. |
|
Load(IDataReader, LoadOption) | Füllt eine DataTable mit Werten aus einer Datenquelle, die den angegebenen IDataReader verwendet. Wenn die DataTable bereits Zeilen enthält, werden die eingehenden Daten gemäß dem Wert des loadOption-Parameters aus der Datenquelle mit den vorhandenen Zeilen zusammengeführt. |
|
Load(IDataReader, LoadOption, FillErrorEventHandler) | Füllt eine DataTable mit Werten aus einer Datenquelle mit dem bereitgestellten IDataReader und unter Verwendung eines Fehlerbehandlungsdelegaten. |
|
LoadDataRow(Object[], Boolean) | Sucht eine bestimmte Zeile und aktualisiert diese. Wenn keine übereinstimmende Zeile gefunden werden kann, wird eine neue Zeile mit den angegebenen Werten erstellt. |
|
LoadDataRow(Object[], LoadOption) | Sucht eine bestimmte Zeile und aktualisiert diese. Wenn keine übereinstimmende Zeile gefunden werden kann, wird eine neue Zeile mit den angegebenen Werten erstellt. |
|
MemberwiseClone | Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.) |
|
Merge(DataTable) | Führen Sie die angegebene DataTable mit der aktuellen DataTable zusammen. |
|
Merge(DataTable, Boolean) | Führen Sie die angegebene DataTable mit der aktuellen DataTable zusammen, und geben Sie an, ob die Änderungen in der aktuellen DataTable beibehalten werden sollen. |
|
Merge(DataTable, Boolean, MissingSchemaAction) | Führen Sie die angegebene DataTable mit der aktuellen DataTable zusammen, und geben Sie an, ob die Änderungen in der aktuellen DataTable beibehalten werden sollen und wie das fehlende Schema behandelt werden soll. |
|
NewRow | Erstellt eine neue DataRow mit dem Schema der Tabelle. |
|
NewRowArray | Infrastruktur. Gibt ein DataRow-Array zurück. |
|
NewRowFromBuilder | Erstellt eine neue Zeile aus einer vorhandenen Zeile. |
|
OnColumnChanged | Löst das ColumnChanged-Ereignis aus. |
|
OnColumnChanging | Löst das ColumnChanging-Ereignis aus. |
|
OnPropertyChanging | Löst das PropertyChanged-Ereignis aus. |
|
OnRemoveColumn | Benachrichtigt die DataTable, dass eine DataColumn entfernt wird. |
|
OnRowChanged | Löst das RowChanged-Ereignis aus. |
|
OnRowChanging | Löst das RowChanging-Ereignis aus. |
|
OnRowDeleted | Löst das RowDeleted-Ereignis aus. |
|
OnRowDeleting | Löst das RowDeleting-Ereignis aus. |
|
OnTableCleared | Löst das TableCleared-Ereignis aus. |
|
OnTableClearing | Löst das TableClearing-Ereignis aus. |
|
OnTableNewRow | Löst das TableNewRow-Ereignis aus. |
|
ReadXml(Stream) | Liest mit dem angegebenen Stream das XML-Schema und die XML-Daten in die DataTable. |
|
ReadXml(String) | Liest das XML-Schema und die XML-Daten in die DataTable aus der angegebenen Datei. |
|
ReadXml(TextReader) | Liest mit dem angegebenen TextReader das XML-Schema und die XML-Daten in die DataTable. |
|
ReadXml(XmlReader) | Liest das XML-Schema und die XML-Daten mit dem angegebenen XmlReader in die DataTable. |
|
ReadXmlSchema(Stream) | Liest ein XML-Schema mit dem angegebenen Stream in die DataTable. |
|
ReadXmlSchema(String) | Liest ein XML-Schema aus der angegebenen Datei in die DataTable. |
|
ReadXmlSchema(TextReader) | Liest ein XML-Schema mit dem angegebenen TextReader in die DataTable. |
|
ReadXmlSchema(XmlReader) | Liest ein XML-Schema mit dem angegebenen XmlReader in die DataTable. |
|
ReadXmlSerializable | Infrastruktur. Liest aus einem XML-Stream. |
|
RejectChanges | Führt einen Rollback aller Änderungen durch, die an der Tabelle seit dem Laden oder seit dem letzten Aufruf von AcceptChanges vorgenommen wurden. |
|
Reset | Setzt die DataTable auf den ursprünglichen Zustand zurück. |
|
Select() | Ruft ein Array aller DataRow-Objekte ab. |
|
Select(String) | Ruft ein Array aller DataRow-Objekte ab, die den Filterkriterien entsprechen. |
|
Select(String, String) | Ruft ein Array aller DataRow-Objekte, die die Filterkriterien erfüllen, in der angegebenen Sortierreihenfolge ab. |
|
Select(String, String, DataViewRowState) | Ruft ein Array aller DataRow-Objekte ab, die die Filterkriterien in der Sortierreihenfolge erfüllen und zum angegebenen Zustand passen. |
|
ToString | Ruft den TableName und den DisplayExpression, sofern vorhanden, als verkettete Zeichenfolge ab. (Überschreibt MarshalByValueComponent.ToString().) |
|
WriteXml(Stream) | Schreibt den aktuellen Inhalt der DataTable als XML mit dem angegebenen Stream. |
|
WriteXml(String) | Schreibt den aktuellen Inhalt der DataTable als XML mit der angegebenen Datei. |
|
WriteXml(TextWriter) | Schreibt den aktuellen Inhalt der DataTable als XML mit dem angegebenen TextWriter. |
|
WriteXml(XmlWriter) | Schreibt den aktuellen Inhalt der DataTable als XML mit dem angegebenen XmlWriter. |
|
WriteXml(Stream, Boolean) | Schreibt den aktuellen Inhalt der DataTable als XML mit dem angegebenen Stream. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest. |
|
WriteXml(Stream, XmlWriteMode) | Schreibt im angegebenen XmlWriteMode die aktuellen Daten und bei Bedarf das Schema für die DataTable in die angegebene Datei. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest. |
|
WriteXml(String, Boolean) | Schreibt den aktuellen Inhalt der DataTable als XML mit der angegebenen Datei. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest. |
|
WriteXml(String, XmlWriteMode) | Schreibt mit der angegebenen Datei und im angegebenen XmlWriteMode die aktuellen Daten und bei Bedarf das Schema für das DataTable. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest. |
|
WriteXml(TextWriter, Boolean) | Schreibt den aktuellen Inhalt der DataTable als XML mit dem angegebenen TextWriter. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest. |
|
WriteXml(TextWriter, XmlWriteMode) | Schreibt mit dem angegebenen TextWriter und im angegebenen XmlWriteMode die aktuellen Daten und bei Bedarf das Schema für die DataTable. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest. |
|
WriteXml(XmlWriter, Boolean) | Schreibt den aktuellen Inhalt der DataTable als XML mit dem angegebenen XmlWriter. |
|
WriteXml(XmlWriter, XmlWriteMode) | Schreibt mit dem angegebenen XmlWriter und im angegebenen XmlWriteMode die aktuellen Daten und bei Bedarf das Schema für die DataTable. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest. |
|
WriteXml(Stream, XmlWriteMode, Boolean) | Schreibt im angegebenen XmlWriteMode die aktuellen Daten und bei Bedarf das Schema für die DataTable in die angegebene Datei. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest. |
|
WriteXml(String, XmlWriteMode, Boolean) | Schreibt mit der angegebenen Datei und im angegebenen XmlWriteMode die aktuellen Daten und bei Bedarf das Schema für das DataTable. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest. |
|
WriteXml(TextWriter, XmlWriteMode, Boolean) | Schreibt mit dem angegebenen TextWriter und im angegebenen XmlWriteMode die aktuellen Daten und bei Bedarf das Schema für die DataTable. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest. |
|
WriteXml(XmlWriter, XmlWriteMode, Boolean) | Schreibt mit dem angegebenen XmlWriter und im angegebenen XmlWriteMode die aktuellen Daten und bei Bedarf das Schema für die DataTable. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest. |
|
WriteXmlSchema(Stream) | Schreibt die aktuelle Datenstruktur der DataTable als XML-Schema in den angegebenen Stream. |
|
WriteXmlSchema(String) | Schreibt die aktuelle Datenstruktur der DataTable als XML-Schema in die angegebene Datei. |
|
WriteXmlSchema(TextWriter) | Schreibt die aktuelle Datenstruktur der DataTable als XML-Schema unter Verwendung des angegebenen TextWriter. |
|
WriteXmlSchema(XmlWriter) | Schreibt die aktuelle Datenstruktur der DataTable als XML-Schema unter Verwendung des angegebenen XmlWriter. |
|
WriteXmlSchema(Stream, Boolean) | Schreibt die aktuelle Datenstruktur der DataTable als XML-Schema in den angegebenen Stream. Legen Sie zum Speichern des Schemas für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest. |
|
WriteXmlSchema(String, Boolean) | Schreibt die aktuelle Datenstruktur der DataTable als XML-Schema in die angegebene Datei. Legen Sie zum Speichern des Schemas für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest. |
|
WriteXmlSchema(TextWriter, Boolean) | Schreibt die aktuelle Datenstruktur der DataTable als XML-Schema unter Verwendung des angegebenen TextWriter. Legen Sie zum Speichern des Schemas für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest. |
|
WriteXmlSchema(XmlWriter, Boolean) | Schreibt die aktuelle Datenstruktur der DataTable als XML-Schema unter Verwendung des angegebenen XmlWriter. Legen Sie zum Speichern des Schemas für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest. |
| Name | Beschreibung | |
|---|---|---|
|
ColumnChanged | Tritt ein, nachdem ein Wert für die angegebene DataColumn in einer DataRow geändert wurde. |
|
ColumnChanging | Tritt ein, wenn ein Wert für die angegebene DataColumn in einer DataRow geändert wird. |
|
Disposed | Fügt einen Ereignishandler hinzu, der das Disposed-Ereignis für die Komponente überwacht. (Von MarshalByValueComponent geerbt.) |
|
Initialized | Tritt nach dem Initialisieren der DataTable auf. |
|
RowChanged | Tritt ein, nachdem eine DataRow erfolgreich geändert wurde. |
|
RowChanging | Tritt ein, wenn eine DataRow geändert wird. |
|
RowDeleted | Tritt ein, nachdem eine Zeile in der Tabelle gelöscht wurde. |
|
RowDeleting | Tritt ein, bevor eine Zeile in der Tabelle gelöscht wird. |
|
TableCleared | Tritt ein, nachdem eine DataTable gelöscht wurde. |
|
TableClearing | Tritt ein, wenn eine DataTable gelöscht wird. |
|
TableNewRow | Tritt ein, wenn eine neue DataRow eingefügt wird. |
| Name | Beschreibung | |
|---|---|---|
|
AsDataView | Erstellt ein LINQ-aktiviertes DataView-Objekt und gibt es zurück. (Durch DataTableExtensions definiert.) |
|
AsEnumerable | Gibt ein IEnumerable<T>-Objekt zurück, bei dem der generische Parameter T gleich DataRow ist. Dieses Objekt kann in einem LINQ-Ausdruck oder einer Methodenabfrage verwendet werden. (Durch DataTableExtensions definiert.) |
| Name | Beschreibung | |
|---|---|---|
|
fInitInProgress | Infrastruktur. Überprüft, ob die Initialisierung gegenwärtig ausgeführt wird. Die Initialisierung erfolgt zur Laufzeit. |
| Name | Beschreibung | |
|---|---|---|
|
IListSource.ContainsListCollection | Eine Beschreibung dieses Members finden Sie unter IListSource.ContainsListCollection. |
|
IListSource.GetList | Eine Beschreibung dieses Members finden Sie unter IListSource.GetList. |
|
IXmlSerializable.GetSchema | Eine Beschreibung dieses Members finden Sie unter der IXmlSerializable.GetSchema-Methode. |
|
IXmlSerializable.ReadXml | Eine Beschreibung dieses Members finden Sie unter IXmlSerializable.ReadXml. |
|
IXmlSerializable.WriteXml | Eine Beschreibung dieses Members finden Sie unter IXmlSerializable.WriteXml. |
DataTable ist ein zentrales Objekt in der ADO.NET-Bibliothek. Zu den weiteren Objekten, die DataTable verwenden, zählen DataSet und DataView.
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. Ein DataSet kann zwei DataTable-Objekte mit demselben TableName-Eigenschaftswert, aber unterschiedlichen Namespace-Eigenschaftswerten enthalten. Weitere Informationen über das Arbeiten mit DataTable-Objekten finden Sie unter Erstellen einer 'DataTable' (ADO.NET).
Beim programmgesteuerten Erstellen einer DataTable müssen Sie zuerst deren Schema definieren, indem Sie der DataColumnCollection (Zugriff über die Columns-Eigenschaft) DataColumn-Objekte hinzufügen. Weitere Informationen über das Hinzufügen von DataColumn-Objekten finden Sie unter Hinzufügen von Spalten zu einer 'DataTable' (ADO.NET).
Wenn Sie einer DataTable Zeilen hinzufügen möchten, müssen Sie zunächst mit der NewRow-Methode ein neues DataRow-Objekt zurückgeben. Mit der NewRow-Methode wird eine Zeile zurückgegeben, die das durch die DataColumnCollection der Tabelle definierte Schema der DataTable enthält. Die maximale Anzahl von Zeilen, die von einer DataTable gespeichert werden kann, ist 16.777.216. Weitere Informationen finden Sie unter Hinzufügen von Daten zu einer 'DataTable'.
Die DataTable enthält außerdem eine Auflistung von Constraint-Objekten, mit denen die Datenintegrität sichergestellt werden kann. Weitere Informationen finden Sie unter 'DataTable'-Einschränkungen (ADO.NET).
Es steht eine Vielzahl von DataTable-Ereignissen zur Verfügung, mit denen Änderungen an einer Tabelle bestimmt werden können. Dazu gehören RowChanged, RowChanging, RowDeleting und RowDeleted. Weitere Informationen über die Ereignisse, die mit einer DataTable verwendet werden können, finden Sie unter Behandeln von DataTable-Ereignissen (ADO.NET).
Wenn eine Instanz von DataTable erstellt wird, werden einige Lese-/Schreibeigenschaften auf die Anfangswerte festgelegt. Eine Liste dieser Werte finden Sie im Thema zum DataTable.DataTable-Konstruktor.
Hinweis
|
|---|
|
Das DataSet-Objekt und das DataTable-Objekt erben von MarshalByValueComponent und unterstützen die ISerializable-Schnittstelle für .NET Framework Remoting. Dies sind die einzigen ADO.NET-Objekte, die Sie für .NET Framework Remoting verwenden können. |
Im folgenden Beispiel werden zwei DataTable-Objekte und ein DataRelation-Objekt erstellt, und die neuen Objekte werden einem DataSet hinzugefügt. Die Tabellen werden dann in einem DataGridView-Steuerelement angezeigt.
// Put the next line into the Declarations section. private System.Data.DataSet dataSet; private void MakeDataTables() { // Run all of the functions. MakeParentTable(); MakeChildTable(); MakeDataRelation(); BindToDataGrid(); } private void MakeParentTable() { // Create a new DataTable. System.Data.DataTable table = new DataTable("ParentTable"); // Declare variables for DataColumn and DataRow objects. DataColumn column; DataRow row; // Create new DataColumn, set DataType, // ColumnName and add to DataTable. column = new DataColumn(); column.DataType = System.Type.GetType("System.Int32"); column.ColumnName = "id"; column.ReadOnly = true; column.Unique = true; // Add the Column to the DataColumnCollection. table.Columns.Add(column); // Create second column. column = new DataColumn(); column.DataType = System.Type.GetType("System.String"); column.ColumnName = "ParentItem"; column.AutoIncrement = false; column.Caption = "ParentItem"; column.ReadOnly = false; column.Unique = false; // Add the column to the table. table.Columns.Add(column); // Make the ID column the primary key column. DataColumn[] PrimaryKeyColumns = new DataColumn[1]; PrimaryKeyColumns[0] = table.Columns["id"]; table.PrimaryKey = PrimaryKeyColumns; // Instantiate the DataSet variable. dataSet = new DataSet(); // Add the new DataTable to the DataSet. dataSet.Tables.Add(table); // Create three new DataRow objects and add // them to the DataTable for (int i = 0; i<= 2; i++) { row = table.NewRow(); row["id"] = i; row["ParentItem"] = "ParentItem " + i; table.Rows.Add(row); } } private void MakeChildTable() { // Create a new DataTable. DataTable table = new DataTable("childTable"); DataColumn column; DataRow row; // Create first column and add to the DataTable. column = new DataColumn(); column.DataType= System.Type.GetType("System.Int32"); column.ColumnName = "ChildID"; column.AutoIncrement = true; column.Caption = "ID"; column.ReadOnly = true; column.Unique = true; // Add the column to the DataColumnCollection. table.Columns.Add(column); // Create second column. column = new DataColumn(); column.DataType= System.Type.GetType("System.String"); column.ColumnName = "ChildItem"; column.AutoIncrement = false; column.Caption = "ChildItem"; column.ReadOnly = false; column.Unique = false; table.Columns.Add(column); // Create third column. column = new DataColumn(); column.DataType= System.Type.GetType("System.Int32"); column.ColumnName = "ParentID"; column.AutoIncrement = false; column.Caption = "ParentID"; column.ReadOnly = false; column.Unique = false; table.Columns.Add(column); dataSet.Tables.Add(table); // Create three sets of DataRow objects, // five rows each, and add to DataTable. for(int i = 0; i <= 4; i ++) { row = table.NewRow(); row["childID"] = i; row["ChildItem"] = "Item " + i; row["ParentID"] = 0 ; table.Rows.Add(row); } for(int i = 0; i <= 4; i ++) { row = table.NewRow(); row["childID"] = i + 5; row["ChildItem"] = "Item " + i; row["ParentID"] = 1 ; table.Rows.Add(row); } for(int i = 0; i <= 4; i ++) { row = table.NewRow(); row["childID"] = i + 10; row["ChildItem"] = "Item " + i; row["ParentID"] = 2 ; table.Rows.Add(row); } } private void MakeDataRelation() { // DataRelation requires two DataColumn // (parent and child) and a name. DataColumn parentColumn = dataSet.Tables["ParentTable"].Columns["id"]; DataColumn childColumn = dataSet.Tables["ChildTable"].Columns["ParentID"]; DataRelation relation = new DataRelation("parent2Child", parentColumn, childColumn); dataSet.Tables["ChildTable"].ParentRelations.Add(relation); } private void BindToDataGrid() { // Instruct the DataGrid to bind to the DataSet, with the // ParentTable as the topmost DataTable. dataGrid1.SetDataBinding(dataSet,"ParentTable"); }
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.
Hinweis