DataTableCollection Класс

Определение

Представляет коллекцию таблиц для 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
Наследование
DataTableCollection
Атрибуты

Примеры

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

Комментарии

Объект DataTableCollection содержит DataSetвсе объекты для конкретного объекта. DataTableThe DataTableCollection contains all the DataTable objects for a particular DataSet. Чтобы получить доступ DataTableCollection DataSetк, используйте Tables свойство.To access the DataTableCollection of a DataSet, use the Tables property.

Компонент использует такие методы, Addкак Clear, и Remove , для управления элементами в коллекции. DataTableCollectionThe DataTableCollection uses methods such as Add, Clear, and Remove to manage the items in the collection.

Contains Используйте метод, чтобы определить, находится ли определенная таблица (указанная с помощью индекса или имени) в коллекции.Use the Contains method to determine whether a particular table (specified by either index or name) is in the collection.

Для перехода от одной таблицы ChildRelations к другой используйте свойство или ParentRelations объекта DataTable для доступа к коллекции DataRelation объектов.To navigate from one table to another, use the ChildRelations or ParentRelations property of the DataTable to access its collection of DataRelation objects. Кроме того, можно использовать Relations свойство для навигации по связям типа «родители-потомки DataTables » в определенной DataSet коллекции.You can also use the Relations property to navigate through the parent/child relationships of the DataTables in a particular DataSet collection.

Свойства

Count

Возвращает общее число элементов в коллекции.Gets the total number of elements in a collection.

(Унаследовано от InternalDataCollectionBase)
IsReadOnly

Возвращает значение, которое определяет, является ли коллекция InternalDataCollectionBase доступной только для чтения.Gets a value that indicates whether the InternalDataCollectionBase is read-only.

(Унаследовано от InternalDataCollectionBase)
IsSynchronized

Возвращает значение, которое определяет, является ли коллекция InternalDataCollectionBase синхронизированной.Gets a value that indicates whether the InternalDataCollectionBase is synchronized.

(Унаследовано от InternalDataCollectionBase)
Item[Int32]

Возвращает объект DataTable по указанному индексу.Gets the DataTable object at the specified index.

Item[String, String]

Получает объект DataTable с указанным именем в указанном пространстве имен.Gets the DataTable object with the specified name in the specified namespace.

Item[String]

Получает объект DataTable с указанным именем.Gets the DataTable object with the specified name.

List

Возвращает элементы коллекции в виде списка.Gets the items of the collection as a list.

(Унаследовано от InternalDataCollectionBase)
SyncRoot

Возвращает объект, который можно использовать для синхронизации коллекции.Gets an object that can be used to synchronize the collection.

(Унаследовано от InternalDataCollectionBase)

Методы

Add()

Создает новый объект DataTable, используя имя по умолчанию, и добавляет его в коллекцию.Creates a new DataTable object by using a default name and adds it to the collection.

Add(DataTable)

Добавляет указанный параметр DataTable в коллекцию.Adds the specified DataTable to the collection.

Add(String)

Создает объект DataTable, используя заданное имя, и добавляет его в коллекцию.Creates a DataTable object by using the specified name and adds it to the collection.

Add(String, String)

Создает объект DataTable, используя заданное имя, и добавляет его в коллекцию.Creates a DataTable object by using the specified name and adds it to the collection.

AddRange(DataTable[])

Копирует элементы указанного массива DataTable в конец коллекции.Copies the elements of the specified DataTable array to the end of the collection.

CanRemove(DataTable)

Проверяет возможность удаления указанного объекта DataTable из коллекции.Verifies whether the specified DataTable object can be removed from the collection.

Clear()

Очищает коллекцию от всех объектов DataTable.Clears the collection of all DataTable objects.

Contains(String)

Получает значение, показывающее, существует ли объект DataTable с указанным именем в коллекции.Gets a value that indicates whether a DataTable object with the specified name exists in the collection.

Contains(String, String)

Получает значение, показывающее, существует ли объект DataTable с указанным именем и пространство имен для таблицы в коллекции.Gets a value that indicates whether a DataTable object with the specified name and table namespace exists in the collection.

CopyTo(Array, Int32)

Копирует все элементы текущего объекта InternalDataCollectionBase в одномерный массив Array, начиная с указанного индекса InternalDataCollectionBase.Copies all the elements of the current InternalDataCollectionBase to a one-dimensional Array, starting at the specified InternalDataCollectionBase index.

(Унаследовано от InternalDataCollectionBase)
CopyTo(DataTable[], Int32)

Копирует все элементы текущей коллекции DataTableCollection в одномерный массив Array, начиная с указанного индекса целевого массива.Copies all the elements of the current DataTableCollection to a one-dimensional Array, starting at the specified destination array index.

Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetEnumerator()

Возвращает объект IEnumerator для коллекции.Gets an IEnumerator for the collection.

(Унаследовано от InternalDataCollectionBase)
GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
IndexOf(DataTable)

Получает индекс указанного объекта DataTable.Gets the index of the specified DataTable object.

IndexOf(String)

Получает индекс объекта DataTable с указанным именем в коллекции.Gets the index in the collection of the DataTable object with the specified name.

IndexOf(String, String)

Получает индекс указанного объекта DataTable в коллекции.Gets the index in the collection of the specified DataTable object.

MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
Remove(DataTable)

Удаляет указанный объект DataTable из коллекции.Removes the specified DataTable object from the collection.

Remove(String)

Удаляет объект DataTable с указанным именем из коллекции.Removes the DataTable object with the specified name from the collection.

Remove(String, String)

Удаляет объект DataTable с указанным именем из коллекции.Removes the DataTable object with the specified name from the collection.

RemoveAt(Int32)

Удаляет объект DataTable по указанному индексу из коллекции.Removes the DataTable object at the specified index from the collection.

ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

События

CollectionChanged

Происходит после изменения коллекции DataTableCollection в результате добавления или удаления объектов DataTable.Occurs after the DataTableCollection is changed because of DataTable objects being added or removed.

CollectionChanging

Происходит при изменении коллекции DataTableCollection в результате добавления или удаления объектов DataTable.Occurs while the DataTableCollection is changing because of DataTable objects being added or removed.

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

Cast<TResult>(IEnumerable)

Приводит элементы объекта IEnumerable к заданному типу.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Выполняет фильтрацию элементов объекта IEnumerable по заданному типу.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Позволяет осуществлять параллельный запрос.Enables parallelization of a query.

AsQueryable(IEnumerable)

Преобразовывает коллекцию IEnumerable в объект IQueryable.Converts an IEnumerable to an IQueryable.

Применяется к

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

Этот тип является надежным для многопоточных операций чтения.This type is safe for multithreaded read operations. Необходимо синхронизировать любые операции записи.You must synchronize any write operations.

Дополнительно