DataTableCollection Класс

Определение

Пространство имен:

System.Data

Сборки:

netstandard.dll, System.Data.Common.dll

Исходный код:

DataTableCollection.cs

Представляет коллекцию таблиц для .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

Наследование

Object

InternalDataCollectionBase

DataTableCollection

Атрибуты

ListBindableAttribute

Примеры

Первая процедура в этом примере извлекает DataTableCollectionDataSet и выводит значение каждого столбца в каждой строке каждой таблицы. Вторая процедура создает новый DataTable с двумя столбцами и добавляет его в .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

Комментарии

Содержит DataTableCollection все DataTable объекты для конкретного DataSetобъекта. Чтобы получить доступ к DataTableCollection свойствуDataSetTables, используйте это свойство.

Использует DataTableCollection такие методы, как Add, Clearи Remove управление элементами в коллекции.

Contains Используйте метод, чтобы определить, находится ли в коллекции определенная таблица (указанная индексом или именем).

Чтобы перейти из одной таблицы в другую, используйте ChildRelations свойство или ParentRelations свойство DataTable для доступа к коллекции DataRelation объектов. Вы также можете использовать Relations свойство для перехода по связям родительского или дочернего DataTables объекта в определенной DataSet коллекции.

Свойства

Имя	Описание
Count	Возвращает общее количество элементов в коллекции. (Унаследовано от InternalDataCollectionBase)
IsReadOnly	Возвращает значение, указывающее, доступен ли доступ InternalDataCollectionBase только для чтения. (Унаследовано от InternalDataCollectionBase)
IsSynchronized	Возвращает значение, указывающее, синхронизирован ли он InternalDataCollectionBase . (Унаследовано от InternalDataCollectionBase)
Item[Int32]	Возвращает объект по указанному DataTable индексу.
Item[String, String]	DataTable Возвращает объект с указанным именем в указанном пространстве имен.
Item[String]	DataTable Возвращает объект с указанным именем.
List	Возвращает элементы коллекции в виде списка. (Унаследовано от InternalDataCollectionBase)
SyncRoot	Возвращает объект, который можно использовать для синхронизации коллекции. (Унаследовано от InternalDataCollectionBase)

Методы

Имя	Описание
Add()	Создает новый DataTable объект с помощью имени по умолчанию и добавляет его в коллекцию.
Add(DataTable)	Добавляет указанный DataTable в коллекцию.
Add(String, String)	DataTable Создает объект с помощью указанного имени и добавляет его в коллекцию.
Add(String)	DataTable Создает объект с помощью указанного имени и добавляет его в коллекцию.
AddRange(DataTable[])	Копирует элементы указанного DataTable массива в конец коллекции.
CanRemove(DataTable)	Проверяет, можно ли удалить указанный DataTable объект из коллекции.
Clear()	Очищает коллекцию всех DataTable объектов.
Contains(String, String)	Возвращает значение, указывающее, существует ли DataTable объект с указанным именем и пространством имен таблицы в коллекции.
Contains(String)	Возвращает значение, указывающее, существует ли DataTable объект с указанным именем в коллекции.
CopyTo(Array, Int32)	Копирует все элементы текущего InternalDataCollectionBase в одномерный Array, начиная с указанного InternalDataCollectionBase индекса. (Унаследовано от InternalDataCollectionBase)
CopyTo(DataTable[], Int32)	Копирует все элементы текущего DataTableCollection в одномерный Arrayиндекс, начиная с указанного индекса целевого массива.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetEnumerator()	IEnumerator Возвращает коллекцию. (Унаследовано от InternalDataCollectionBase)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
IndexOf(DataTable)	Возвращает индекс указанного DataTable объекта.
IndexOf(String, String)	Возвращает индекс в коллекции указанного DataTable объекта.
IndexOf(String)	Возвращает индекс в коллекции DataTable объекта с указанным именем.
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
Remove(DataTable)	Удаляет указанный DataTable объект из коллекции.
Remove(String, String)	Удаляет DataTable объект с указанным именем из коллекции.
Remove(String)	Удаляет DataTable объект с указанным именем из коллекции.
RemoveAt(Int32)	Удаляет DataTable объект по указанному индексу из коллекции.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

События

Имя	Описание
CollectionChanged	Происходит после DataTableCollection изменения из-за DataTable добавления или удаления объектов.
CollectionChanging	Происходит во время DataTableCollection изменения из-за DataTable добавления или удаления объектов.

Методы расширения

Имя	Описание
AsParallel(IEnumerable)	Включает параллелизацию запроса.
AsQueryable(IEnumerable)	Преобразует IEnumerable в IQueryable.
Cast<TResult>(IEnumerable)	Приведение элементов IEnumerable к указанному типу.
OfType<TResult>(IEnumerable)	Фильтрует элементы IEnumerable на основе указанного типа.

Потокобезопасность

Этот тип является безопасным для многопоточных операций чтения. Необходимо синхронизировать все операции записи.

См. также раздел

• DataColumn
• DataRow
• DataTable
• DataSet