DataTableCollection 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 die Auflistung von Tabellen für das DataSet dar.
public ref class DataTableCollection sealed : System::Data::InternalDataCollectionBase
public ref class DataTableCollection : System::Data::InternalDataCollectionBase
[System.ComponentModel.ListBindable(false)]
public sealed class DataTableCollection : System.Data.InternalDataCollectionBase
[System.ComponentModel.ListBindable(false)]
[System.Serializable]
public class DataTableCollection : System.Data.InternalDataCollectionBase
[<System.ComponentModel.ListBindable(false)>]
type DataTableCollection = class
inherit InternalDataCollectionBase
[<System.ComponentModel.ListBindable(false)>]
[<System.Serializable>]
type DataTableCollection = class
inherit InternalDataCollectionBase
Public NotInheritable Class DataTableCollection
Inherits InternalDataCollectionBase
Public Class DataTableCollection
Inherits InternalDataCollectionBase
- Vererbung
- Attribute
Beispiele
Die erste Prozedur in diesem Beispiel ruft den DataTableCollection eines ab DataSet und gibt den Wert jeder Spalte in jeder Zeile jeder Tabelle aus. Die zweite Prozedur erstellt eine neue DataTable mit zwei Spalten und fügt sie dem DataTableCollectionhinzu.
private void GetTables(DataSet dataSet)
{
// Get Each DataTable in the DataTableCollection and
// print each row value.
foreach (DataTable table in dataSet.Tables)
foreach (DataRow row in table.Rows)
foreach (DataColumn column in table.Columns)
if (row[column] != null)
Console.WriteLine(row[column]);
}
private void CreateTable(DataSet dataSet)
{
DataTable newTable = new DataTable("table");
newTable.Columns.Add("ID", typeof(int));
newTable.Columns.Add("Name", typeof(string));
dataSet.Tables.Add(newTable);
}
Private Sub GetTables(dataSet As DataSet)
' Get Each DataTable in the DataTableCollection and
' print each row value.
Dim table As DataTable
Dim row As DataRow
Dim column As DataColumn
For Each table In dataSet.Tables
For Each row In table.Rows
For Each column in table.Columns
If Not (row(column) Is Nothing) Then
Console.WriteLine(row(column))
End If
Next
Next
Next
End Sub
Private Sub CreateTable(dataSet As DataSet)
Dim newTable As New DataTable("table")
newTable.Columns.Add("ID", Type.GetType("System.Int32"))
newTable.Columns.Add("Name", Type.GetType("System.String"))
dataSet.Tables.Add(newTable)
End Sub
Hinweise
Enthält DataTableCollection alle DataTable -Objekte für eine bestimmte DataSet. Verwenden Sie Tables die -Eigenschaft, um auf ein DataTableCollectionDataSetzuzugreifen.
Die DataTableCollection verwendet Methoden wie Add, Clearund Remove , um die Elemente in der Auflistung zu verwalten.
Verwenden Sie die Contains -Methode, um zu bestimmen, ob sich eine bestimmte Tabelle (entweder durch Index oder Name angegeben) in der Auflistung befindet.
Um von einer Tabelle zur anderen zu navigieren, verwenden Sie die ChildRelations - oder ParentRelations -Eigenschaft von , um auf die DataTable Sammlung von DataRelation -Objekten zuzugreifen. Sie können die Relations -Eigenschaft auch verwenden, um durch die übergeordneten/untergeordneten Beziehungen von in DataTables
einer bestimmten DataSet Auflistung zu navigieren.
Eigenschaften
Count |
Ruft die Gesamtzahl der Elemente in einer Auflistung ab. (Geerbt von InternalDataCollectionBase) |
IsReadOnly |
Ruft einen Wert ab, der angibt, ob die InternalDataCollectionBase schreibgeschützt ist. (Geerbt von InternalDataCollectionBase) |
IsSynchronized |
Ruft einen Wert ab, der angibt, ob die InternalDataCollectionBase synchronisiert ist. (Geerbt von InternalDataCollectionBase) |
Item[Int32] |
Ruft das DataTable-Objekt am angegebenen Index ab. |
Item[String, String] |
Ruft das DataTable-Objekt mit dem angegebenen Namen im angegebenen Namespace ab. |
Item[String] |
Ruft das DataTable-Objekt mit dem angegebenen Namen ab. |
List |
Ruft die Elemente der Auflistung als Liste ab. |
List |
Ruft die Elemente der Auflistung als Liste ab. (Geerbt von InternalDataCollectionBase) |
SyncRoot |
Ruft ein Objekt ab, mit dem die Auflistung synchronisiert werden kann. (Geerbt von InternalDataCollectionBase) |
Methoden
Add() |
Erstellt ein neues DataTable-Objekt mit einem Standardnamen und fügt es der Auflistung hinzu. |
Add(DataTable) |
Fügt der Auflistung den angegebenen |
Add(String) |
Erstellt ein DataTable-Objekt mit dem angegebenen Namen und fügt es der Auflistung hinzu. |
Add(String, String) |
Erstellt ein DataTable-Objekt mit dem angegebenen Namen und fügt es der Auflistung hinzu. |
AddRange(DataTable[]) |
Kopiert die Elemente des angegebenen DataTable-Arrays an das Ende der Auflistung. |
CanRemove(DataTable) |
Überprüft, ob das angegebene DataTable-Objekt aus der Auflistung entfernt werden kann. |
Clear() |
Löscht alle DataTable-Objekte aus der Auflistung. |
Contains(String) |
Ruft einen Wert ab, der angibt, ob ein DataTable-Objekt mit dem angegebenen Namen in der Auflistung vorhanden ist. |
Contains(String, String) |
Ruft einen Wert ab, der angibt, ob ein DataTable-Objekt mit dem angegebenen Namen und dem angegebenen Tabellennamespace in der Auflistung vorhanden ist. |
CopyTo(Array, Int32) |
Kopiert alle Elemente der aktuellen InternalDataCollectionBase in ein eindimensionales Array, beginnend am angegebenen InternalDataCollectionBase-Index. (Geerbt von InternalDataCollectionBase) |
CopyTo(DataTable[], Int32) |
Kopiert alle Elemente der aktuellen DataTableCollection in ein eindimensionales Array, wobei am angegebenen Index des Zielarrays begonnen wird. |
Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
GetEnumerator() |
Ruft einen IEnumerator für die Auflistung ab. (Geerbt von InternalDataCollectionBase) |
GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
IndexOf(DataTable) |
Ruft den Index des angegebenen DataTable-Objekts ab. |
IndexOf(String) |
Ruft den Index des DataTable-Objekts mit dem angegebenen Namen in der Auflistung ab. |
IndexOf(String, String) |
Ruft den Index des angegebenen DataTable-Objekts in der Auflistung ab. |
MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
OnCollectionChanged(CollectionChangeEventArgs) |
Löst das OnCollectionChanged(CollectionChangeEventArgs)-Ereignis aus. |
OnCollectionChanging(CollectionChangeEventArgs) |
Stellt die Auflistung von Tabellen für das DataSet dar. |
Remove(DataTable) |
Entfernt das angegebene DataTable-Objekt aus der Auflistung. |
Remove(String) |
Entfernt das DataTable-Objekt mit dem angegebenen Namen aus der Auflistung. |
Remove(String, String) |
Entfernt das DataTable-Objekt mit dem angegebenen Namen aus der Auflistung. |
RemoveAt(Int32) |
Entfernt das DataTable-Objekt am angegebenen Index aus der Sammlung. |
ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
Ereignisse
CollectionChanged |
Tritt ein, wenn die DataTableCollection aufgrund des Hinzufügens oder Entfernens von DataTable-Objekten geändert wurde. |
CollectionChanging |
Tritt ein, während die DataTableCollection aufgrund des Hinzufügens oder Entfernens von DataTable-Objekten geändert wird. |
Erweiterungsmethoden
Cast<TResult>(IEnumerable) |
Wandelt die Elemente eines IEnumerable in den angegebenen Typ um |
OfType<TResult>(IEnumerable) |
Filtert die Elemente eines IEnumerable anhand eines angegebenen Typs |
AsParallel(IEnumerable) |
Ermöglicht die Parallelisierung einer Abfrage. |
AsQueryable(IEnumerable) |
Konvertiert einen IEnumerable in einen IQueryable. |
Gilt für:
Threadsicherheit
Dieser Typ ist für Multithread-Lesevorgänge sicher. Sie müssen alle Schreibvorgänge synchronisieren.