DataTableCollection Klasse

Definition

Stellt die Auflistung von Tabellen für das DataSet dar.Represents the collection of tables for the DataSet.

public ref class DataTableCollection sealed : System::Data::InternalDataCollectionBase
[System.ComponentModel.ListBindable(false)]
[System.Serializable]
public sealed class DataTableCollection : System.Data.InternalDataCollectionBase
type DataTableCollection = class
    inherit InternalDataCollectionBase
Public NotInheritable Class DataTableCollection
Inherits InternalDataCollectionBase
Vererbung
DataTableCollection
Attribute

Beispiele

Das erste Verfahren in diesem Beispiel ruft den DataTableCollection DataSet eines ab und druckt den Wert jeder Spalte (in jeder Zeile) der einzelnen Tabellen.The first procedure in this example retrieves the DataTableCollection of a DataSet and prints the value of each column, in each row, of each table. Mit dem zweiten Verfahren wird ein DataTable neues mit zwei Spalten erstellt und dem DataTableCollectionhinzugefügt.The second procedure creates a new DataTable with two columns, and adds it to the DataTableCollection.

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

Der DataTableCollection enthält DataSetalle-Objekte für einen bestimmten. DataTableThe DataTableCollection contains all the DataTable objects for a particular DataSet. Um auf die DataTableCollection DataSeteines zuzugreifen, verwenden Sie Tables die-Eigenschaft.To access the DataTableCollection of a DataSet, use the Tables property.

Verwendet Methoden Addwie, Clear undRemove zum Verwalten der Elemente in der Auflistung. DataTableCollectionThe DataTableCollection uses methods such as Add, Clear, and Remove to manage the items in the collection.

Verwenden Sie Contains die-Methode, um zu bestimmen, ob eine bestimmte (durch Index oder Name angegebene) Tabelle in der Auflistung aufgeführt ist.Use the Contains method to determine whether a particular table (specified by either index or name) is in the collection.

Um von einer Tabelle zu einer anderen zu navigieren, ChildRelations verwenden ParentRelations Sie die- DataTable Eigenschaft oder die-Eigenschaft DataRelation des, um auf die Objekt Auflistung zuzugreifen.To navigate from one table to another, use the ChildRelations or ParentRelations property of the DataTable to access its collection of DataRelation objects. Sie können auch die Relations -Eigenschaft verwenden, um durch die Beziehungen DataTables zwischen übergeordneten und untergeordneten Elementen DataSet in einer bestimmten Auflistung zu navigieren.You can also use the Relations property to navigate through the parent/child relationships of the DataTables in a particular DataSet collection.

Eigenschaften

Count

Ruft die Gesamtzahl der Elemente in einer Auflistung ab.Gets the total number of elements in a collection.

(Geerbt von InternalDataCollectionBase)
IsReadOnly

Ruft einen Wert ab, der angibt, ob die InternalDataCollectionBase schreibgeschützt ist.Gets a value that indicates whether the InternalDataCollectionBase is read-only.

(Geerbt von InternalDataCollectionBase)
IsSynchronized

Ruft einen Wert ab, der angibt, ob die InternalDataCollectionBase synchronisiert ist.Gets a value that indicates whether the InternalDataCollectionBase is synchronized.

(Geerbt von InternalDataCollectionBase)
Item[Int32]

Ruft das DataTable-Objekt am angegebenen Index ab.Gets the DataTable object at the specified index.

Item[String, String]

Ruft das DataTable-Objekt mit dem angegebenen Namen im angegebenen Namespace ab.Gets the DataTable object with the specified name in the specified namespace.

Item[String]

Ruft das DataTable-Objekt mit dem angegebenen Namen ab.Gets the DataTable object with the specified name.

List

Ruft die Elemente der Auflistung als Liste ab.Gets the items of the collection as a list.

(Geerbt von InternalDataCollectionBase)
SyncRoot

Ruft ein Objekt ab, mit dem die Auflistung synchronisiert werden kann.Gets an object that can be used to synchronize the collection.

(Geerbt von InternalDataCollectionBase)

Methoden

Add()

Erstellt ein neues DataTable-Objekt mit einem Standardnamen und fügt es der Auflistung hinzu.Creates a new DataTable object by using a default name and adds it to the collection.

Add(DataTable)

Fügt der Auflistung den angegebenen DataTable hinzu.Adds the specified DataTable to the collection.

Add(String)

Erstellt ein DataTable-Objekt mit dem angegebenen Namen und fügt es der Auflistung hinzu.Creates a DataTable object by using the specified name and adds it to the collection.

Add(String, String)

Erstellt ein DataTable-Objekt mit dem angegebenen Namen und fügt es der Auflistung hinzu.Creates a DataTable object by using the specified name and adds it to the collection.

AddRange(DataTable[])

Kopiert die Elemente des angegebenen DataTable-Arrays an das Ende der Auflistung.Copies the elements of the specified DataTable array to the end of the collection.

CanRemove(DataTable)

Überprüft, ob das angegebene DataTable-Objekt aus der Auflistung entfernt werden kann.Verifies whether the specified DataTable object can be removed from the collection.

Clear()

Löscht alle DataTable-Objekte aus der Auflistung.Clears the collection of all DataTable objects.

Contains(String)

Ruft einen Wert ab, der angibt, ob ein DataTable-Objekt mit dem angegebenen Namen in der Auflistung vorhanden ist.Gets a value that indicates whether a DataTable object with the specified name exists in the collection.

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.Gets a value that indicates whether a DataTable object with the specified name and table namespace exists in the collection.

CopyTo(Array, Int32)

Kopiert alle Elemente der aktuellen InternalDataCollectionBase in ein eindimensionales Array, beginnend am angegebenen InternalDataCollectionBase-Index.Copies all the elements of the current InternalDataCollectionBase to a one-dimensional Array, starting at the specified 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.Copies all the elements of the current DataTableCollection to a one-dimensional Array, starting at the specified destination array index.

Equals(Object)

Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetEnumerator()

Ruft einen IEnumerator für die Auflistung ab.Gets an IEnumerator for the collection.

(Geerbt von InternalDataCollectionBase)
GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetType()

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

(Geerbt von Object)
IndexOf(DataTable)

Ruft den Index des angegebenen DataTable-Objekts ab.Gets the index of the specified DataTable object.

IndexOf(String)

Ruft den Index des DataTable-Objekts mit dem angegebenen Namen in der Auflistung ab.Gets the index in the collection of the DataTable object with the specified name.

IndexOf(String, String)

Ruft den Index des angegebenen DataTable-Objekts in der Auflistung ab.Gets the index in the collection of the specified DataTable object.

MemberwiseClone()

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

(Geerbt von Object)
Remove(DataTable)

Entfernt das angegebene DataTable-Objekt aus der Auflistung.Removes the specified DataTable object from the collection.

Remove(String)

Entfernt das DataTable-Objekt mit dem angegebenen Namen aus der Auflistung.Removes the DataTable object with the specified name from the collection.

Remove(String, String)

Entfernt das DataTable-Objekt mit dem angegebenen Namen aus der Auflistung.Removes the DataTable object with the specified name from the collection.

RemoveAt(Int32)

Entfernt das DataTable-Objekt am angegebenen Index aus der Auflistung.Removes the DataTable object at the specified index from the collection.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Ereignisse

CollectionChanged

Tritt ein, wenn die DataTableCollection aufgrund des Hinzufügens oder Entfernens von DataTable-Objekten geändert wurde.Occurs after the DataTableCollection is changed because of DataTable objects being added or removed.

CollectionChanging

Tritt ein, während die DataTableCollection aufgrund des Hinzufügens oder Entfernens von DataTable-Objekten geändert wird.Occurs while the DataTableCollection is changing because of DataTable objects being added or removed.

Erweiterungsmethoden

Cast<TResult>(IEnumerable)

Wandelt die Elemente eines IEnumerable in den angegebenen Typ umCasts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtert die Elemente eines IEnumerable anhand eines angegebenen TypsFilters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Ermöglicht die Parallelisierung einer Abfrage.Enables parallelization of a query.

AsQueryable(IEnumerable)

Konvertiert einen IEnumerable in einen IQueryable.Converts an IEnumerable to an IQueryable.

Gilt für:

Threadsicherheit

Dieser Typ ist für multithreadlesevorgänge sicher.This type is safe for multithreaded read operations. Sie müssen alle Schreibvorgänge synchronisieren.You must synchronize any write operations.

Siehe auch