DataTableCollection Klasa

Definicja

Przestrzeń nazw:

System.Data

Zestawy:

netstandard.dll, System.Data.Common.dll

Źródło:

DataTableCollection.cs

Reprezentuje kolekcję tabel dla elementu DataSet.

public ref class DataTableCollection sealed : System::Data::InternalDataCollectionBase

[System.ComponentModel.ListBindable(false)]
public sealed class DataTableCollection : System.Data.InternalDataCollectionBase

[<System.ComponentModel.ListBindable(false)>]
type DataTableCollection = class
    inherit InternalDataCollectionBase

Public NotInheritable Class DataTableCollection
Inherits InternalDataCollectionBase

Dziedziczenie

Object

InternalDataCollectionBase

DataTableCollection

Atrybuty

ListBindableAttribute

Przykłady

Pierwsza procedura w tym przykładzie pobiera DataTableCollection wartość elementu DataSet i wyświetla wartość każdej kolumny w każdym wierszu każdej tabeli. Druga procedura tworzy nową DataTable z dwiema kolumnami i dodaje ją do obiektu 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

Uwagi

Obiekt DataTableCollection zawiera wszystkie DataTable obiekty dla określonego DataSetelementu . Aby uzyskać dostęp do DataTableCollection obiektu DataSet, użyj Tables właściwości .

Metoda DataTableCollection używa metod, takich jak Add, Cleari Remove do zarządzania elementami w kolekcji.

Contains Użyj metody , aby określić, czy określona tabela (określona przez indeks lub nazwa) znajduje się w kolekcji.

Aby przejść z jednej tabeli do innej, użyj ChildRelations właściwości DataTable lub ParentRelations , aby uzyskać dostęp do kolekcji DataRelation obiektów. Możesz również użyć Relations właściwości , aby przejść przez relacje elementu nadrzędnego/podrzędnego DataTables w określonej DataSet kolekcji.

Właściwości

Nazwa	Opis
Count	Pobiera łączną liczbę elementów w kolekcji. (Odziedziczone po InternalDataCollectionBase)
IsReadOnly	Pobiera wartość wskazującą, czy InternalDataCollectionBase element jest tylko do odczytu. (Odziedziczone po InternalDataCollectionBase)
IsSynchronized	Pobiera wartość wskazującą, czy InternalDataCollectionBase element jest zsynchronizowany. (Odziedziczone po InternalDataCollectionBase)
Item[Int32]	DataTable Pobiera obiekt w określonym indeksie.
Item[String, String]	DataTable Pobiera obiekt o określonej nazwie w określonej przestrzeni nazw.
Item[String]	DataTable Pobiera obiekt o określonej nazwie.
List	Pobiera elementy kolekcji jako listę. (Odziedziczone po InternalDataCollectionBase)
SyncRoot	Pobiera obiekt, który może służyć do synchronizowania kolekcji. (Odziedziczone po InternalDataCollectionBase)

Metody

Nazwa	Opis
Add()	Tworzy nowy DataTable obiekt przy użyciu domyślnej nazwy i dodaje go do kolekcji.
Add(DataTable)	Dodaje określony DataTable element do kolekcji.
Add(String, String)	Tworzy DataTable obiekt przy użyciu określonej nazwy i dodaje go do kolekcji.
Add(String)	Tworzy DataTable obiekt przy użyciu określonej nazwy i dodaje go do kolekcji.
AddRange(DataTable[])	Kopiuje elementy określonej DataTable tablicy na końcu kolekcji.
CanRemove(DataTable)	Sprawdza, czy określony DataTable obiekt można usunąć z kolekcji.
Clear()	Czyści kolekcję wszystkich DataTable obiektów.
Contains(String, String)	Pobiera wartość wskazującą, czy DataTable obiekt o określonej nazwie i przestrzeni nazw tabeli istnieje w kolekcji.
Contains(String)	Pobiera wartość wskazującą, czy DataTable obiekt o określonej nazwie istnieje w kolekcji.
CopyTo(Array, Int32)	Kopiuje wszystkie elementy bieżącego InternalDataCollectionBase do jednowymiarowego Array, zaczynając od określonego InternalDataCollectionBase indeksu. (Odziedziczone po InternalDataCollectionBase)
CopyTo(DataTable[], Int32)	Kopiuje wszystkie elementy bieżącego DataTableCollection do jednowymiarowego Array, zaczynając od określonego indeksu tablicy docelowej.
Equals(Object)	Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object)
GetEnumerator()	Pobiera element IEnumerator dla kolekcji. (Odziedziczone po InternalDataCollectionBase)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
IndexOf(DataTable)	Pobiera indeks określonego DataTable obiektu.
IndexOf(String, String)	Pobiera indeks w kolekcji określonego DataTable obiektu.
IndexOf(String)	Pobiera indeks w kolekcji DataTable obiektu o określonej nazwie.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
Remove(DataTable)	Usuwa określony DataTable obiekt z kolekcji.
Remove(String, String)	DataTable Usuwa obiekt o określonej nazwie z kolekcji.
Remove(String)	DataTable Usuwa obiekt o określonej nazwie z kolekcji.
RemoveAt(Int32)	DataTable Usuwa obiekt w określonym indeksie z kolekcji.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zdarzenia

Nazwa	Opis
CollectionChanged	Występuje po zmianie obiektu DataTableCollection z powodu dodawania DataTable lub usuwania obiektów.
CollectionChanging	Występuje podczas DataTableCollection zmiany obiektu z powodu dodawania DataTable lub usuwania obiektów.

Metody rozszerzania

Nazwa	Opis
AsParallel(IEnumerable)	Umożliwia równoległość zapytania.
AsQueryable(IEnumerable)	Konwertuje IEnumerable na IQueryable.
Cast<TResult>(IEnumerable)	Rzutuje elementy IEnumerable do określonego typu.
OfType<TResult>(IEnumerable)	Filtruje elementy IEnumerable na podstawie określonego typu.

Bezpieczeństwo wątkowe

Ten typ jest bezpieczny w przypadku wielowątkowych operacji odczytu. Należy zsynchronizować wszystkie operacje zapisu.

Zobacz też

• DataColumn
• DataRow
• DataTable
• DataSet