DataTableCollection Klasa

Definicja

Reprezentuje kolekcję tabel dla DataSet.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
Dziedziczenie
DataTableCollection
Atrybuty

Przykłady

Pierwsza procedura w tym przykładzie pobiera DataTableCollection DataSet i drukuje wartość każdej kolumny w każdym wierszu każdej tabeli.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. Druga procedura powoduje utworzenie nowego DataTable z dwiema kolumnami i dodanie go do DataTableCollection.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

Uwagi

DataTableCollection zawiera wszystkie obiekty DataTable dla określonego DataSet.The DataTableCollection contains all the DataTable objects for a particular DataSet. Aby uzyskać dostęp do DataTableCollection DataSet, użyj właściwości Tables.To access the DataTableCollection of a DataSet, use the Tables property.

DataTableCollection używa metod, takich jak Add, Cleari Remove do zarządzania elementami w kolekcji.The DataTableCollection uses methods such as Add, Clear, and Remove to manage the items in the collection.

Użyj metody Contains, aby określić, czy dana tabela (określona przez indeks lub nazwa) znajduje się w kolekcji.Use the Contains method to determine whether a particular table (specified by either index or name) is in the collection.

Aby nawigować z jednej tabeli do drugiej, użyj właściwości ChildRelations lub ParentRelations DataTable, aby uzyskać dostęp do swojej kolekcji obiektów DataRelation.To navigate from one table to another, use the ChildRelations or ParentRelations property of the DataTable to access its collection of DataRelation objects. Można również użyć właściwości Relations, aby nawigować między relacjami nadrzędny/podrzędny DataTables w określonej kolekcji DataSet.You can also use the Relations property to navigate through the parent/child relationships of the DataTables in a particular DataSet collection.

Właściwości

Count

Pobiera łączną liczbę elementów w kolekcji.Gets the total number of elements in a collection.

(Odziedziczone po InternalDataCollectionBase)
IsReadOnly

Pobiera wartość wskazującą, czy InternalDataCollectionBase jest tylko do odczytu.Gets a value that indicates whether the InternalDataCollectionBase is read-only.

(Odziedziczone po InternalDataCollectionBase)
IsSynchronized

Pobiera wartość wskazującą, czy InternalDataCollectionBase jest synchronizowana.Gets a value that indicates whether the InternalDataCollectionBase is synchronized.

(Odziedziczone po InternalDataCollectionBase)
Item[Int32]

Pobiera obiekt DataTable o określonym indeksie.Gets the DataTable object at the specified index.

Item[String, String]

Pobiera DataTable obiekt o określonej nazwie w określonym obszarze nazw.Gets the DataTable object with the specified name in the specified namespace.

Item[String]

Pobiera DataTable obiekt o określonej nazwie.Gets the DataTable object with the specified name.

List

Pobiera elementy kolekcji jako listę.Gets the items of the collection as a list.

(Odziedziczone po InternalDataCollectionBase)
SyncRoot

Pobiera obiekt, którego można użyć do zsynchronizowania kolekcji.Gets an object that can be used to synchronize the collection.

(Odziedziczone po InternalDataCollectionBase)

Metody

Add()

Tworzy nowy obiekt DataTable przy użyciu nazwy domyślnej i dodaje ją do kolekcji.Creates a new DataTable object by using a default name and adds it to the collection.

Add(DataTable)

Dodaje określony DataTable do kolekcji.Adds the specified DataTable to the collection.

Add(String)

Tworzy obiekt DataTable przy użyciu określonej nazwy i dodaje go do kolekcji.Creates a DataTable object by using the specified name and adds it to the collection.

Add(String, String)

Tworzy obiekt DataTable przy użyciu określonej nazwy i dodaje go do kolekcji.Creates a DataTable object by using the specified name and adds it to the collection.

AddRange(DataTable[])

Kopiuje elementy określonej tablicy DataTable na koniec kolekcji.Copies the elements of the specified DataTable array to the end of the collection.

CanRemove(DataTable)

Sprawdza, czy określony DataTable obiektu można usunąć z kolekcji.Verifies whether the specified DataTable object can be removed from the collection.

Clear()

Czyści kolekcję wszystkich obiektów DataTable.Clears the collection of all DataTable objects.

Contains(String)

Pobiera wartość wskazującą, czy obiekt DataTable o określonej nazwie istnieje w kolekcji.Gets a value that indicates whether a DataTable object with the specified name exists in the collection.

Contains(String, String)

Pobiera wartość wskazującą, czy obiekt DataTable o określonej nazwie i przestrzeni nazw tabeli istnieje w kolekcji.Gets a value that indicates whether a DataTable object with the specified name and table namespace exists in the collection.

CopyTo(Array, Int32)

Kopiuje wszystkie elementy bieżącego InternalDataCollectionBase do jednowymiarowego Array, rozpoczynając od określonego indeksu InternalDataCollectionBase.Copies all the elements of the current InternalDataCollectionBase to a one-dimensional Array, starting at the specified InternalDataCollectionBase index.

(Odziedziczone po InternalDataCollectionBase)
CopyTo(DataTable[], Int32)

Kopiuje wszystkie elementy bieżącego DataTableCollection do jednowymiarowego Array, rozpoczynając od określonego indeksu tablicy docelowej.Copies all the elements of the current DataTableCollection to a one-dimensional Array, starting at the specified destination array index.

Equals(Object)

Określa, czy określony obiekt jest równy bieżącemu obiektowi.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetEnumerator()

Pobiera IEnumerator dla kolekcji.Gets an IEnumerator for the collection.

(Odziedziczone po InternalDataCollectionBase)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetType()

Pobiera Type bieżącego wystąpienia.Gets the Type of the current instance.

(Odziedziczone po Object)
IndexOf(DataTable)

Pobiera indeks określonego obiektu DataTable.Gets the index of the specified DataTable object.

IndexOf(String)

Pobiera indeks w kolekcji obiektu DataTable o określonej nazwie.Gets the index in the collection of the DataTable object with the specified name.

IndexOf(String, String)

Pobiera indeks w kolekcji określonego obiektu DataTable.Gets the index in the collection of the specified DataTable object.

MemberwiseClone()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
Remove(DataTable)

Usuwa określony obiekt DataTable z kolekcji.Removes the specified DataTable object from the collection.

Remove(String)

Usuwa obiekt DataTable o określonej nazwie z kolekcji.Removes the DataTable object with the specified name from the collection.

Remove(String, String)

Usuwa obiekt DataTable o określonej nazwie z kolekcji.Removes the DataTable object with the specified name from the collection.

RemoveAt(Int32)

Usuwa obiekt DataTable o określonym indeksie z kolekcji.Removes the DataTable object at the specified index from the collection.

ToString()

Zwraca ciąg, który reprezentuje bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Zdarzenia

CollectionChanged

Występuje po zmianie DataTableCollection ze względu na dodanie lub usunięcie obiektów DataTable.Occurs after the DataTableCollection is changed because of DataTable objects being added or removed.

CollectionChanging

Występuje, gdy DataTableCollection zmienia się ze względu na dodawanie lub usuwanie obiektów DataTable.Occurs while the DataTableCollection is changing because of DataTable objects being added or removed.

Metody rozszerzania

Cast<TResult>(IEnumerable)

Rzutuje elementy IEnumerable określonego typu.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtruje elementy IEnumerable w oparciu o określony typ.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Włącza przetwarzanie równoległe zapytania.Enables parallelization of a query.

AsQueryable(IEnumerable)

Konwertuje IEnumerable na IQueryable.Converts an IEnumerable to an IQueryable.

Dotyczy

Bezpieczeństwo wątkowe

Ten typ jest bezpieczny dla wielowątkowych operacji odczytu.This type is safe for multithreaded read operations. Należy zsynchronizować wszystkie operacje zapisu.You must synchronize any write operations.

Zobacz też