DataTable Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt eine Tabelle mit Speicherdaten dar.
public ref class DataTable : System::ComponentModel::MarshalByValueComponent, System::ComponentModel::IListSource, System::ComponentModel::ISupportInitialize, System::ComponentModel::ISupportInitializeNotification, System::Runtime::Serialization::ISerializable, System::Xml::Serialization::IXmlSerializable
public ref class DataTable
public ref class DataTable : System::ComponentModel::MarshalByValueComponent, System::ComponentModel::IListSource, System::ComponentModel::ISupportInitialize, System::Runtime::Serialization::ISerializable
public ref class DataTable : System::ComponentModel::MarshalByValueComponent, System::ComponentModel::IListSource, System::ComponentModel::ISupportInitializeNotification, System::Runtime::Serialization::ISerializable, System::Xml::Serialization::IXmlSerializable
[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.NonPublicConstructors | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)]
public class DataTable : System.ComponentModel.MarshalByValueComponent, System.ComponentModel.IListSource, System.ComponentModel.ISupportInitialize, System.ComponentModel.ISupportInitializeNotification, System.Runtime.Serialization.ISerializable, System.Xml.Serialization.IXmlSerializable
public class DataTable : System.ComponentModel.MarshalByValueComponent, System.ComponentModel.IListSource, System.ComponentModel.ISupportInitialize, System.ComponentModel.ISupportInitializeNotification, System.Runtime.Serialization.ISerializable, System.Xml.Serialization.IXmlSerializable
public class DataTable
[System.Serializable]
public class DataTable : System.ComponentModel.MarshalByValueComponent, System.ComponentModel.IListSource, System.ComponentModel.ISupportInitialize, System.Runtime.Serialization.ISerializable
[System.Serializable]
public class DataTable : System.ComponentModel.MarshalByValueComponent, System.ComponentModel.IListSource, System.ComponentModel.ISupportInitializeNotification, System.Runtime.Serialization.ISerializable, System.Xml.Serialization.IXmlSerializable
public class DataTable : System.ComponentModel.MarshalByValueComponent, System.ComponentModel.IListSource, System.ComponentModel.ISupportInitializeNotification, System.Runtime.Serialization.ISerializable, System.Xml.Serialization.IXmlSerializable
[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.NonPublicConstructors | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)>]
type DataTable = class
inherit MarshalByValueComponent
interface IListSource
interface ISupportInitialize
interface ISupportInitializeNotification
interface ISerializable
interface IXmlSerializable
type DataTable = class
inherit MarshalByValueComponent
interface IListSource
interface ISupportInitialize
interface ISupportInitializeNotification
interface ISerializable
interface IXmlSerializable
type DataTable = class
[<System.Serializable>]
type DataTable = class
inherit MarshalByValueComponent
interface IListSource
interface ISupportInitialize
interface ISerializable
[<System.Serializable>]
type DataTable = class
inherit MarshalByValueComponent
interface IListSource
interface ISupportInitializeNotification
interface ISupportInitialize
interface ISerializable
interface IXmlSerializable
Public Class DataTable
Inherits MarshalByValueComponent
Implements IListSource, ISerializable, ISupportInitialize, ISupportInitializeNotification, IXmlSerializable
Public Class DataTable
Public Class DataTable
Inherits MarshalByValueComponent
Implements IListSource, ISerializable, ISupportInitialize
Public Class DataTable
Inherits MarshalByValueComponent
Implements IListSource, ISerializable, ISupportInitializeNotification, IXmlSerializable
- Vererbung
- Vererbung
-
DataTable
- Abgeleitet
- Attribute
- Implementiert
Beispiele
In diesem Beispiel wird veranschaulicht, wie Sie eine DataTable manuell mit bestimmten Schemadefinitionen erstellen:
- Erstellen Sie mehrere DataTables, und definieren Sie die anfangsspalten.
- Erstellen Sie die Tabelleneinschränkungen.
- Fügen Sie die Werte ein, und zeigen Sie die Tabellen an.
- Erstellen Sie die Ausdrucksspalten, und zeigen Sie die Tabellen an.
using System;
using System.Data;
class Program
{
static void Main()
{
// Create two tables and add them into the DataSet.
DataTable orderTable = CreateOrderTable();
DataTable orderDetailTable = CreateOrderDetailTable();
DataSet salesSet = new();
salesSet.Tables.Add(orderTable);
salesSet.Tables.Add(orderDetailTable);
// Set the relations between the tables
// and create the related constraint.
salesSet.Relations.Add(
"OrderOrderDetail",
orderTable.Columns["OrderId"],
orderDetailTable.Columns["OrderId"],
true);
Console.WriteLine("After creating the foreign key constraint, " +
"you'll see the following error if you insert " +
"an order detail with the wrong OrderId:\n");
try
{
DataRow errorRow = orderDetailTable.NewRow();
errorRow[0] = 1;
errorRow[1] = "O0007";
orderDetailTable.Rows.Add(errorRow);
}
catch (Exception e)
{
Console.WriteLine(e.Message);
}
Console.WriteLine();
// Insert the rows into the table.
InsertOrders(orderTable);
InsertOrderDetails(orderDetailTable);
Console.WriteLine("The initial Order table.");
ShowTable(orderTable);
Console.WriteLine("The OrderDetail table.");
ShowTable(orderDetailTable);
// Use the Aggregate-Sum on the child table column to get the result.
DataColumn colSub = new("SubTotal", typeof(decimal), "Sum(Child.LineTotal)");
orderTable.Columns.Add(colSub);
// Compute the tax by referencing the SubTotal expression column.
DataColumn colTax = new("Tax", typeof(decimal), "SubTotal*0.1");
orderTable.Columns.Add(colTax);
// If the OrderId is 'Total', compute the amount due on all orders; otherwise, compute the amount due on this order.
DataColumn colTotal = new(
"TotalDue",
typeof(decimal),
"IIF(OrderId='Total',Sum(SubTotal)+Sum(Tax),SubTotal+Tax)");
orderTable.Columns.Add(colTotal);
DataRow row = orderTable.NewRow();
row["OrderId"] = "Total";
orderTable.Rows.Add(row);
Console.WriteLine("The Order table with the expression columns.");
ShowTable(orderTable);
Console.WriteLine("Press any key to exit.....");
Console.ReadKey();
}
private static DataTable CreateOrderTable()
{
DataTable orderTable = new("Order");
// Define the columns one at a time.
DataColumn colId = new("OrderId", typeof(string));
orderTable.Columns.Add(colId);
DataColumn colDate = new("OrderDate", typeof(DateTime));
orderTable.Columns.Add(colDate);
// Set the OrderId column as the primary key.
orderTable.PrimaryKey = [colId];
return orderTable;
}
private static DataTable CreateOrderDetailTable()
{
DataTable orderDetailTable = new("OrderDetail");
// Define all the columns at once.
DataColumn[] cols =
[
new DataColumn("OrderDetailId", typeof(int)),
new DataColumn("OrderId", typeof(string)),
new DataColumn("Product", typeof(string)),
new DataColumn("UnitPrice", typeof(decimal)),
new DataColumn("OrderQty", typeof(int)),
new DataColumn("LineTotal", typeof(decimal), "UnitPrice*OrderQty")
];
orderDetailTable.Columns.AddRange(cols);
orderDetailTable.PrimaryKey = [orderDetailTable.Columns["OrderDetailId"]];
return orderDetailTable;
}
private static void InsertOrders(DataTable orderTable)
{
// Add one row at a time.
DataRow row1 = orderTable.NewRow();
row1["OrderId"] = "O0001";
row1["OrderDate"] = new DateTime(2013, 3, 1);
orderTable.Rows.Add(row1);
DataRow row2 = orderTable.NewRow();
row2["OrderId"] = "O0002";
row2["OrderDate"] = new DateTime(2013, 3, 12);
orderTable.Rows.Add(row2);
DataRow row3 = orderTable.NewRow();
row3["OrderId"] = "O0003";
row3["OrderDate"] = new DateTime(2013, 3, 20);
orderTable.Rows.Add(row3);
}
private static void InsertOrderDetails(DataTable orderDetailTable)
{
// Use an Object array to insert all the rows.
// Values in the array are matched sequentially to the columns,
// based on the order in which they appear in the table.
object[][] rows =
[
[1, "O0001", "Mountain Bike", 1419.5, 36],
[2, "O0001", "Road Bike", 1233.6, 16],
[3, "O0001", "Touring Bike", 1653.3, 32],
[4, "O0002", "Mountain Bike", 1419.5, 24],
[5, "O0002", "Road Bike", 1233.6, 12],
[6, "O0003", "Mountain Bike", 1419.5, 48],
[7, "O0003", "Touring Bike", 1653.3, 8],
];
foreach (object[] row in rows)
{
orderDetailTable.Rows.Add(row);
}
}
private static void ShowTable(DataTable table)
{
foreach (DataColumn col in table.Columns)
{
Console.Write("{0,-14}", col.ColumnName);
}
Console.WriteLine();
foreach (DataRow row in table.Rows)
{
foreach (DataColumn col in table.Columns)
{
if (col.DataType.Equals(typeof(DateTime)))
Console.Write("{0,-14:d}", row[col]);
else if (col.DataType.Equals(typeof(decimal)))
Console.Write("{0,-14:C}", row[col]);
else
Console.Write("{0,-14}", row[col]);
}
Console.WriteLine();
}
Console.WriteLine();
}
}
' Put the next line into the Declarations section.
private dataSet As DataSet
Private Sub MakeDataTables()
' Run all of the functions.
MakeParentTable()
MakeChildTable()
MakeDataRelation()
BindToDataGrid()
End Sub
Private Sub MakeParentTable()
' Create a new DataTable.
Dim table As New DataTable("ParentTable")
' Declare variables for DataColumn and DataRow objects.
Dim column As DataColumn
Dim row As DataRow
' 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.
Dim PrimaryKeyColumns(0) As DataColumn
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
Dim i As Integer
For i = 0 to 2
row = table.NewRow()
row("id") = i
row("ParentItem") = "ParentItem " + i.ToString()
table.Rows.Add(row)
Next i
End Sub
Private Sub MakeChildTable()
' Create a new DataTable.
Dim table As New DataTable("childTable")
Dim column As DataColumn
Dim row As DataRow
' 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.
Dim i As Integer
For i = 0 to 4
row = table.NewRow()
row("childID") = i
row("ChildItem") = "Item " + i.ToString()
row("ParentID") = 0
table.Rows.Add(row)
Next i
For i = 0 to 4
row = table.NewRow()
row("childID") = i + 5
row("ChildItem") = "Item " + i.ToString()
row("ParentID") = 1
table.Rows.Add(row)
Next i
For i = 0 to 4
row = table.NewRow()
row("childID") = i + 10
row("ChildItem") = "Item " + i.ToString()
row("ParentID") = 2
table.Rows.Add(row)
Next i
End Sub
Private Sub MakeDataRelation()
' DataRelation requires two DataColumn
' (parent and child) and a name.
Dim parentColumn As DataColumn = _
dataSet.Tables("ParentTable").Columns("id")
Dim childColumn As DataColumn = _
dataSet.Tables("ChildTable").Columns("ParentID")
Dim relation As DataRelation = new _
DataRelation("parent2Child", parentColumn, childColumn)
dataSet.Tables("ChildTable").ParentRelations.Add(relation)
End Sub
Private Sub BindToDataGrid()
' Instruct the DataGrid to bind to the DataSet, with the
' ParentTable as the topmost DataTable.
DataGrid1.SetDataBinding(dataSet,"ParentTable")
End Sub
Hinweise
Die DataTable Klasse ist ein zentrales Objekt in der ADO.NET Bibliothek. Andere Objekte, die DataTable verwenden, umfassen DataSet und DataView.
DataTable-Objektnamen sind bedingt vertraulich. Wenn beispielsweise ein DataTable „mydatatable” heißt und das andere Objekt „Mydatatable”, wird bei einer Zeichenfolge, die zum Suchen nach einer der Tabellen verwendet wird, die Groß-/Kleinschreibung berücksichtigt. Wenn jedoch „mydatatable” vorhanden ist und „Mydatatable” nicht, wird die Suchzeichenfolge unabhängig von der Groß- und Kleinschreibung betrachtet. A DataSet kann zwei DataTable Objekte enthalten, die denselben TableName Eigenschaftswert, aber unterschiedliche Namespace Eigenschaftswerte aufweisen. Weitere Informationen zum Arbeiten mit DataTable Objekten finden Sie unter Erstellen einer DataTable.
Wenn Sie ein DataTable programmatisch erstellen, müssen Sie zuerst sein Schema definieren, indem Sie DataColumn Objekte zu DataColumnCollection hinzufügen (auf die über die Columns Eigenschaft zugegriffen wird). Weitere Informationen zum Hinzufügen von DataColumn Objekten finden Sie unter Hinzufügen von Spalten zu einer DataTable.
Zum Hinzufügen von Zeilen zu einem DataTableObjekt müssen Sie zunächst die NewRow Methode verwenden, um ein neues DataRow Objekt zurückzugeben. Die NewRow Methode gibt eine Zeile mit dem Schema des DataTable, wie sie durch die Tabelle DataColumnCollectiondefiniert wird . Die maximale Anzahl von Zeilen, die ein DataTable Speicher speichern kann, beträgt 16.777.216. Weitere Informationen finden Sie unter Hinzufügen von Daten zu einer DataTable.
Dies DataTable enthält auch eine Auflistung von Constraint Objekten, die verwendet werden können, um die Integrität der Daten sicherzustellen. Weitere Informationen finden Sie unter DataTable Constraints.
Es gibt viele DataTable Ereignisse, die verwendet werden können, um zu bestimmen, wann Änderungen an einer Tabelle vorgenommen werden. Dazu gehören RowChanged, RowChanging, RowDeletingund RowDeleted. Weitere Informationen zu den Ereignissen, die mit einem DataTableverwendet werden können, finden Sie unter Behandeln von DataTable-Ereignissen.
Wenn eine Instanz von DataTable erstellt wird, werden einige der Lese-/Schreibeigenschaften auf Anfangswerte festgelegt. Eine Liste dieser Werte finden Sie im DataTable Konstruktor.
Note
Die Objekte DataSet und DataTable erben von MarshalByValueComponent und unterstützen die ISerializable Schnittstelle für .NET Remoting. Dies sind die einzigen ADO.NET Objekte, die Sie für .NET-Remoting verwenden können.
Sicherheitsüberlegungen
Informationen zur Sicherheit von DataSet und DataTable finden Sie unter Sicherheitsleitfaden.
Konstruktoren
| Name | Beschreibung |
|---|---|
| DataTable() |
Initialisiert eine neue Instanz der DataTable Klasse ohne Argumente. |
| DataTable(SerializationInfo, StreamingContext) |
Veraltet.
Initialisiert eine neue Instanz der DataTable Klasse mit serialisierten Daten. |
| DataTable(String, String) |
Initialisiert eine neue Instanz der DataTable Klasse mithilfe des angegebenen Tabellennamens und Namespaces. |
| DataTable(String) |
Initialisiert eine neue Instanz der DataTable Klasse mit dem angegebenen Tabellennamen. |
Felder
| Name | Beschreibung |
|---|---|
| fInitInProgress |
Überprüft, ob die Initialisierung ausgeführt wird. Die Initialisierung erfolgt zur Laufzeit. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| CaseSensitive |
Gibt an, ob Zeichenfolgenvergleiche innerhalb der Tabelle groß-/kleinschreibung beachtet werden. |
| ChildRelations |
Ruft die Auflistung der untergeordneten Beziehungen für diese DataTableab. |
| Columns |
Ruft die Auflistung der Spalten ab, die zu dieser Tabelle gehören. |
| Constraints |
Ruft die Auflistung von Einschränkungen ab, die von dieser Tabelle verwaltet werden. |
| Container |
Ruft den Container für die Komponente ab. (Geerbt von MarshalByValueComponent) |
| DataSet |
Ruft die DataSet Tabelle ab, zu der diese Tabelle gehört. |
| DefaultView |
Ruft eine angepasste Ansicht der Tabelle ab, die eine gefilterte Ansicht oder eine Cursorposition enthalten kann. |
| DesignMode |
Ruft einen Wert ab, der angibt, ob sich die Komponente derzeit im Entwurfsmodus befindet. (Geerbt von MarshalByValueComponent) |
| DisplayExpression |
Dient zum Abrufen oder Festlegen des Ausdrucks, der einen Wert zurückgibt, der zur Darstellung dieser Tabelle auf der Benutzeroberfläche verwendet wird. Mit |
| Events |
Ruft die Liste der Ereignishandler ab, die an diese Komponente angefügt sind. (Geerbt von MarshalByValueComponent) |
| ExtendedProperties |
Ruft die Sammlung von benutzerdefinierten Benutzerinformationen ab. |
| HasErrors |
Ruft einen Wert ab, der angibt, ob in einer der Zeilen in einer der Tabellen der DataSet Tabelle, zu der die Tabelle gehört, Fehler vorhanden sind. |
| IsInitialized |
Ruft einen Wert ab, der angibt, ob die DataTable Initialisierung erfolgt. |
| Locale |
Ruft die Gebietsschemainformationen ab, die zum Vergleichen von Zeichenfolgen in der Tabelle verwendet werden, oder legt diese fest. |
| MinimumCapacity |
Ruft die anfängliche Anfangsgröße für diese Tabelle ab, oder legt diese fest. |
| Namespace |
Ruft den Namespace für die XML-Darstellung der in der DataTableDatei gespeicherten Daten ab oder legt den Namespace fest. |
| ParentRelations |
Ruft die Auflistung der übergeordneten Beziehungen für dies DataTableab. |
| Prefix |
Ruft den Namespace für die XML-Darstellung der in der DataTableDatei gespeicherten Daten ab oder legt den Namespace fest. |
| PrimaryKey |
Dient zum Abrufen oder Festlegen eines Arrays von Spalten, die als Primärschlüssel für die Datentabelle funktionieren. |
| RemotingFormat |
Ruft ab oder legt das Serialisierungsformat fest. |
| Rows |
Ruft die Auflistung von Zeilen ab, die zu dieser Tabelle gehören. |
| Site |
Dient zum Abrufen oder Festlegen eines ISite Werts für die DataTable. |
| TableName |
Dient zum Abrufen oder Festlegen des Namens der DataTable. |
Methoden
| Name | Beschreibung |
|---|---|
| AcceptChanges() |
Führt einen Commit für alle An dieser Tabelle vorgenommenen Änderungen seit dem letzten Aufruf AcceptChanges() durch. |
| BeginInit() |
Beginnt mit der Initialisierung eines Formulars DataTable , das in einem Formular verwendet wird oder von einer anderen Komponente verwendet wird. Die Initialisierung erfolgt zur Laufzeit. |
| BeginLoadData() |
Deaktiviert Benachrichtigungen, Indexwartung und Einschränkungen beim Laden von Daten. |
| Clear() |
Löscht alle DataTable Daten. |
| Clone() |
Klont die Struktur der DataTable, einschließlich aller DataTable Schemas und Einschränkungen. |
| Compute(String, String) |
Berechnet den angegebenen Ausdruck für die aktuellen Zeilen, die die Filterkriterien übergeben. |
| Copy() |
Kopiert sowohl die Struktur als auch die Daten dafür DataTable. |
| CreateDataReader() |
Gibt einen DataTableReader entsprechenden Wert für die Daten in diesem DataTableFormat zurück. |
| CreateInstance() |
Erstellt eine neue Instanz von DataTable. |
| Dispose() |
Gibt alle vom MarshalByValueComponentverwendeten Ressourcen frei. (Geerbt von MarshalByValueComponent) |
| Dispose(Boolean) |
Gibt die nicht verwalteten Ressourcen frei, die von den MarshalByValueComponent verwalteten Ressourcen verwendet werden, und gibt optional die verwalteten Ressourcen frei. (Geerbt von MarshalByValueComponent) |
| EndInit() |
Beendet die Initialisierung eines Formulars DataTable , das in einem Formular verwendet wird oder von einer anderen Komponente verwendet wird. Die Initialisierung erfolgt zur Laufzeit. |
| EndLoadData() |
Aktiviert Benachrichtigungen, Indexwartung und Einschränkungen nach dem Laden von Daten. |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| GetChanges() |
Ruft eine Kopie der Datei ab, die DataTable alle daran vorgenommenen Änderungen enthält, seit sie geladen wurde oder AcceptChanges() zuletzt aufgerufen wurde. |
| GetChanges(DataRowState) |
Ruft eine Kopie der DataTable enthaltenden Änderungen ab, die seit dem letzten Laden oder seit AcceptChanges() dem Aufruf vorgenommen wurden, gefiltert nach DataRowState. |
| GetDataTableSchema(XmlSchemaSet) |
Diese Methode gibt eine XmlSchemaSet Instanz zurück, die die Webdienstbeschreibungssprache (Web Services Description Language, WSDL) enthält, die die DataTable Für Webdienste beschreibt. |
| GetErrors() |
Ruft ein Array von DataRow Objekten ab, die Fehler enthalten. |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetObjectData(SerializationInfo, StreamingContext) |
Veraltet.
Füllt ein Serialisierungsinformationsobjekt mit den Daten auf, die zum Serialisieren des DataTableObjekts erforderlich sind. |
| GetRowType() |
Ruft den Zeilentyp ab. |
| GetSchema() |
Eine Beschreibung dieses Mitglieds finden Sie unter GetSchema(). |
| GetService(Type) |
Ruft den Implementierer der IServiceProvider. (Geerbt von MarshalByValueComponent) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| ImportRow(DataRow) |
Kopiert ein Element DataRow in eine DataTable, wobei alle Eigenschaftseinstellungen beibehalten werden, sowie originale und aktuelle Werte. |
| Load(IDataReader, LoadOption, FillErrorEventHandler) |
Füllt einen DataTable Wert mit Werten aus einer Datenquelle mithilfe des bereitgestellten IDataReader Fehlerbehandlungsdelegats aus. |
| Load(IDataReader, LoadOption) |
Füllt einen DataTable Wert mit Werten aus einer Datenquelle mithilfe der angegebenen IDataReader. Wenn die |
| Load(IDataReader) |
Füllt einen DataTable Wert mit Werten aus einer Datenquelle mithilfe der angegebenen IDataReader. Wenn die DataTable bereits Vorhandenen Zeilen enthalten, werden die eingehenden Daten aus der Datenquelle mit den vorhandenen Zeilen zusammengeführt. |
| LoadDataRow(Object[], Boolean) |
Sucht und aktualisiert eine bestimmte Zeile. Wenn keine übereinstimmende Zeile gefunden wird, wird mithilfe der angegebenen Werte eine neue Zeile erstellt. |
| LoadDataRow(Object[], LoadOption) |
Sucht und aktualisiert eine bestimmte Zeile. Wenn keine übereinstimmende Zeile gefunden wird, wird mithilfe der angegebenen Werte eine neue Zeile erstellt. |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| Merge(DataTable, Boolean, MissingSchemaAction) |
Führen Sie den angegebenen DataTable Wert mit dem aktuellen |
| Merge(DataTable, Boolean) |
Führen Sie den angegebenen DataTable Wert mit dem aktuellen |
| Merge(DataTable) |
Führen Sie das angegebene DataTable Mit dem aktuellen DataTableZusammenführen aus. |
| NewRow() |
Erstellt ein neues DataRow Schema mit demselben Schema wie die Tabelle. |
| NewRowArray(Int32) |
Gibt ein Array von DataRowzurück. |
| NewRowFromBuilder(DataRowBuilder) |
Erstellt eine neue Zeile aus einer vorhandenen Zeile. |
| OnColumnChanged(DataColumnChangeEventArgs) |
Löst das ColumnChanged-Ereignis aus. |
| OnColumnChanging(DataColumnChangeEventArgs) |
Löst das ColumnChanging-Ereignis aus. |
| OnPropertyChanging(PropertyChangedEventArgs) |
Löst das PropertyChanged-Ereignis aus. |
| OnRemoveColumn(DataColumn) |
Benachrichtigt, DataTable dass eine DataColumn entfernt wird. |
| OnRowChanged(DataRowChangeEventArgs) |
Löst das RowChanged-Ereignis aus. |
| OnRowChanging(DataRowChangeEventArgs) |
Löst das RowChanging-Ereignis aus. |
| OnRowDeleted(DataRowChangeEventArgs) |
Löst das RowDeleted-Ereignis aus. |
| OnRowDeleting(DataRowChangeEventArgs) |
Löst das RowDeleting-Ereignis aus. |
| OnTableCleared(DataTableClearEventArgs) |
Löst das TableCleared-Ereignis aus. |
| OnTableClearing(DataTableClearEventArgs) |
Löst das TableClearing-Ereignis aus. |
| OnTableNewRow(DataTableNewRowEventArgs) |
Löst das TableNewRow-Ereignis aus. |
| ReadXml(Stream) |
Liest XML-Schema und -Daten in die verwendung der DataTable angegebenen Stream. |
| ReadXml(String) |
Liest XML-Schema und -Daten in die DataTable aus der angegebenen Datei. |
| ReadXml(TextReader) |
Liest XML-Schema und -Daten in die verwendung der DataTable angegebenen TextReader. |
| ReadXml(XmlReader) |
Liest XML-Schema und -Daten in die verwendung der DataTable angegebenen XmlReader. |
| ReadXmlSchema(Stream) |
Liest ein XML-Schema in der DataTable Verwendung des angegebenen Datenstroms. |
| ReadXmlSchema(String) |
Liest ein XML-Schema aus DataTable der angegebenen Datei. |
| ReadXmlSchema(TextReader) |
Liest ein XML-Schema in die DataTable verwendung der angegebenen TextReader. |
| ReadXmlSchema(XmlReader) |
Liest ein XML-Schema in die DataTable verwendung der angegebenen XmlReader. |
| ReadXmlSerializable(XmlReader) |
Liest aus einem XML-Datenstrom. |
| RejectChanges() |
Rollback aller Änderungen, die seit dem Laden an der Tabelle vorgenommen wurden, oder das letzte Mal AcceptChanges() aufgerufen wurde. |
| Reset() |
Setzt den DataTable ursprünglichen Zustand zurück. Durch zurücksetzen werden alle Daten, Indizes, Beziehungen und Spalten der Tabelle entfernt. Wenn ein DataSet eine DataTable enthält, ist die Tabelle nach dem Zurücksetzen der Tabelle weiterhin Teil des DataSet. |
| Select() |
Ruft ein Array aller DataRow Objekte ab. |
| Select(String, String, DataViewRowState) |
Ruft ein Array aller DataRow Objekte ab, die dem Filter in der Reihenfolge der Sortierung entsprechen, die dem angegebenen Zustand entsprechen. |
| Select(String, String) |
Ruft ein Array aller DataRow Objekte ab, die den Filterkriterien entsprechen, in der angegebenen Sortierreihenfolge. |
| Select(String) |
Ruft ein Array aller DataRow Objekte ab, die den Filterkriterien entsprechen. |
| ToString() |
Ruft die TableName und DisplayExpression, wenn eine als verkettete Zeichenfolge vorhanden ist. |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
| WriteXml(Stream, Boolean) |
Schreibt den aktuellen Inhalt des DataTable xml-Codes mithilfe des angegebenen Stream. Um die Daten für die Tabelle und alle untergeordneten Elemente zu speichern, legen Sie den |
| WriteXml(Stream, XmlWriteMode, Boolean) |
Schreibt die aktuellen Daten und optional das Schema für die DataTable angegebene Datei mithilfe der angegebenen XmlWriteModeDatei. Um das Schema zu schreiben, legen Sie den Wert für den |
| WriteXml(Stream, XmlWriteMode) |
Schreibt die aktuellen Daten und optional das Schema für die DataTable angegebene Datei mithilfe der angegebenen XmlWriteModeDatei. Um das Schema zu schreiben, legen Sie den Wert für den |
| WriteXml(Stream) |
Schreibt den aktuellen Inhalt des DataTable xml-Codes mithilfe des angegebenen Stream. |
| WriteXml(String, Boolean) |
Schreibt den aktuellen Inhalt des DataTable XML-Codes mithilfe der angegebenen Datei. Um die Daten für die Tabelle und alle untergeordneten Elemente zu speichern, legen Sie den |
| WriteXml(String, XmlWriteMode, Boolean) |
Schreibt die aktuellen Daten und optional das Schema für die DataTable Verwendung der angegebenen Datei und XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den |
| WriteXml(String, XmlWriteMode) |
Schreibt die aktuellen Daten und optional das Schema für die DataTable Verwendung der angegebenen Datei und XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den |
| WriteXml(String) |
Schreibt den aktuellen Inhalt des DataTable XML-Codes mithilfe der angegebenen Datei. |
| WriteXml(TextWriter, Boolean) |
Schreibt den aktuellen Inhalt des DataTable xml-Codes mithilfe des angegebenen TextWriter. Um die Daten für die Tabelle und alle untergeordneten Elemente zu speichern, legen Sie den |
| WriteXml(TextWriter, XmlWriteMode, Boolean) |
Schreibt die aktuellen Daten und optional das Schema für die DataTable Verwendung der angegebenen TextWriter und XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den |
| WriteXml(TextWriter, XmlWriteMode) |
Schreibt die aktuellen Daten und optional das Schema für die DataTable Verwendung der angegebenen TextWriter und XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den |
| WriteXml(TextWriter) |
Schreibt den aktuellen Inhalt des DataTable xml-Codes mithilfe des angegebenen TextWriter. |
| WriteXml(XmlWriter, Boolean) |
Schreibt den aktuellen Inhalt des DataTable xml-Codes mithilfe des angegebenen XmlWriter. |
| WriteXml(XmlWriter, XmlWriteMode, Boolean) |
Schreibt die aktuellen Daten und optional das Schema für die DataTable Verwendung der angegebenen XmlWriter und XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den |
| WriteXml(XmlWriter, XmlWriteMode) |
Schreibt die aktuellen Daten und optional das Schema für die DataTable Verwendung der angegebenen XmlWriter und XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den |
| WriteXml(XmlWriter) |
Schreibt den aktuellen Inhalt des DataTable xml-Codes mithilfe des angegebenen XmlWriter. |
| WriteXmlSchema(Stream, Boolean) |
Schreibt die aktuelle Datenstruktur der DataTable als XML-Schema in den angegebenen Datenstrom. Um das Schema für die Tabelle und alle untergeordneten Elemente zu speichern, legen Sie den |
| WriteXmlSchema(Stream) |
Schreibt die aktuelle Datenstruktur der DataTable als XML-Schema in den angegebenen Datenstrom. |
| WriteXmlSchema(String, Boolean) |
Schreibt die aktuelle Datenstruktur der DataTable als XML-Schema in die angegebene Datei. Um das Schema für die Tabelle und alle untergeordneten Elemente zu speichern, legen Sie den |
| WriteXmlSchema(String) |
Schreibt die aktuelle Datenstruktur der DataTable als XML-Schema in die angegebene Datei. |
| WriteXmlSchema(TextWriter, Boolean) |
Schreibt die aktuelle Datenstruktur des DataTable ALS XML-Schemas mithilfe des angegebenen TextWriter. Um das Schema für die Tabelle und alle untergeordneten Elemente zu speichern, legen Sie den |
| WriteXmlSchema(TextWriter) |
Schreibt die aktuelle Datenstruktur des DataTable ALS XML-Schemas mithilfe des angegebenen TextWriter. |
| WriteXmlSchema(XmlWriter, Boolean) |
Schreibt die aktuelle Datenstruktur des DataTable ALS XML-Schemas mithilfe des angegebenen XmlWriter. Um das Schema für die Tabelle und alle untergeordneten Elemente zu speichern, legen Sie den |
| WriteXmlSchema(XmlWriter) |
Schreibt die aktuelle Datenstruktur des DataTable ALS XML-Schemas mithilfe des angegebenen XmlWriter. |
Ereignisse
| Name | Beschreibung |
|---|---|
| ColumnChanged |
Tritt auf, nachdem ein Wert für die angegebene DataColumn in einer DataRow. |
| ColumnChanging |
Tritt auf, wenn ein Wert für die angegebene DataColumn in einer DataRow. |
| Disposed |
Fügt einen Ereignishandler hinzu, um auf das Ereignis in der Disposed Komponente zu lauschen. (Geerbt von MarshalByValueComponent) |
| Initialized |
Tritt nach der Initialisierung auf DataTable . |
| RowChanged |
Tritt ein, nachdem eine DataRow erfolgreich geändert wurde. |
| RowChanging |
Tritt auf, wenn eine DataRow Änderung erfolgt. |
| RowDeleted |
Tritt ein, nachdem eine Zeile in der Tabelle gelöscht wurde. |
| RowDeleting |
Tritt auf, bevor eine Zeile in der Tabelle gelöscht werden soll. |
| TableCleared |
Tritt auf, nachdem ein DataTable Löscht wurde. |
| TableClearing |
Tritt auf, wenn eine DataTable gelöscht wird. |
| TableNewRow |
Tritt auf, wenn ein neues DataRow eingefügt wird. |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| IListSource.ContainsListCollection |
Eine Beschreibung dieses Mitglieds finden Sie unter ContainsListCollection. |
| IListSource.GetList() |
Eine Beschreibung dieses Mitglieds finden Sie unter GetList(). |
| ISerializable.GetObjectData(SerializationInfo, StreamingContext) |
Füllt ein Serialisierungsinformationsobjekt mit den Daten auf, die zum Serialisieren des DataTableObjekts erforderlich sind. |
| IXmlSerializable.GetSchema() |
Eine Beschreibung dieses Mitglieds finden Sie unter GetSchema(). |
| IXmlSerializable.ReadXml(XmlReader) |
Eine Beschreibung dieses Mitglieds finden Sie unter ReadXml(XmlReader). |
| IXmlSerializable.WriteXml(XmlWriter) |
Eine Beschreibung dieses Mitglieds finden Sie unter WriteXml(XmlWriter). |
Erweiterungsmethoden
| Name | Beschreibung |
|---|---|
| AsDataView(DataTable) |
Erstellt und gibt ein LINQ-fähiges DataView Objekt zurück. |
| AsEnumerable(DataTable) |
Gibt ein IEnumerable<T> Objekt zurück, wobei der generische Parameter |
| CreateAsyncScope(IServiceProvider) |
Erstellt eine neue AsyncServiceScope , die zum Auflösen von bereichsbezogenen Diensten verwendet werden kann. |
| CreateScope(IServiceProvider) |
Erstellt eine neue IServiceScope , die zum Auflösen von bereichsbezogenen Diensten verwendet werden kann. |
| GetKeyedService(IServiceProvider, Type, Object) |
Rufen Sie den Dienst des Typs |
| GetKeyedService<T>(IServiceProvider, Object) |
Rufen Sie den Dienst des Typs |
| GetKeyedServices(IServiceProvider, Type, Object) |
Dient zum Abrufen einer Enumeration von Diensten vom Typ |
| GetKeyedServices<T>(IServiceProvider, Object) |
Dient zum Abrufen einer Enumeration von Diensten vom Typ |
| GetRequiredKeyedService(IServiceProvider, Type, Object) |
Rufen Sie den Dienst des Typs |
| GetRequiredKeyedService<T>(IServiceProvider, Object) |
Rufen Sie den Dienst des Typs |
| GetRequiredService(IServiceProvider, Type) |
Rufen Sie den Dienst des Typs |
| GetRequiredService<T>(IServiceProvider) |
Rufen Sie den Dienst des Typs |
| GetService<T>(IServiceProvider) |
Rufen Sie den Dienst des Typs |
| GetServices(IServiceProvider, Type) |
Dient zum Abrufen einer Enumeration von Diensten vom Typ |
| GetServices<T>(IServiceProvider) |
Dient zum Abrufen einer Enumeration von Diensten vom Typ |
Gilt für:
Threadsicherheit
Dieser Typ ist für Multithread-Lesevorgänge sicher. Sie müssen alle Schreibvorgänge synchronisieren.