DataTableCollection 类

定义

命名空间:

System.Data

程序集:

System.Data.Common.dll

Source:

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

示例

此示例中的第一个过程检索 DataTableCollection 的 DataSet ，并打印每一行中每一个表的每一列的值。 第二个过程创建包含两列的新 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

注解

包含DataTableCollectionDataTable特定 DataSet的所有 对象。 若要访问 DataTableCollection 的 DataSet，请使用 Tables 属性。

DataTableCollection使用 、 Clear和 Remove 等Add方法来管理集合中的项。

Contains使用 方法确定由索引或名称) 指定的特定表 (是否位于集合中。

若要从一个表导航到另一个表，请使用 ChildRelations 的 DataTable 或 ParentRelations 属性来访问其 对象的集合DataRelation。 还可以使用 Relations 属性在特定集合中DataSet浏览 的DataTables父/子关系。

属性

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)	使用指定名称创建一个 DataTable 对象，并将其添加到集合中。
Add(String, String)	使用指定名称创建一个 DataTable 对象，并将其添加到集合中。
AddRange(DataTable[])	将指定的 DataTable 数组的元素复制到集合末尾。
CanRemove(DataTable)	验证是否可以将指定的 DataTable 对象从集合中移除。
Clear()	清除所有 DataTable 对象的集合。
Contains(String)	获取一个值，该值指示集合中是否存在具有指定名称的 DataTable 对象。
Contains(String, 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)	获取具有指定名称的 DataTable 对象的集合中的索引。
IndexOf(String, String)	获取指定 DataTable 对象的集合中的索引。
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
Remove(DataTable)	从集合中移除指定的 DataTable 对象。
Remove(String)	从集合中删除具有指定名称的 DataTable 对象。
Remove(String, String)	从集合中删除具有指定名称的 DataTable 对象。
RemoveAt(Int32)	从集合中的指定索引处删除 DataTable 对象。
ToString()	返回表示当前对象的字符串。 (继承自 Object)

事件

CollectionChanged	由于添加或移除 DataTableCollection 对象而更改 DataTable 之后发生。
CollectionChanging	由于添加或移除 DataTableCollection 对象而更改 DataTable 时发生。

扩展方法

Cast<TResult>(IEnumerable)	将 IEnumerable 的元素强制转换为指定的类型。
OfType<TResult>(IEnumerable)	根据指定类型筛选 IEnumerable 的元素。
AsParallel(IEnumerable)	启用查询的并行化。
AsQueryable(IEnumerable)	将 IEnumerable 转换为 IQueryable。

线程安全性

此类型对于多线程读取操作是安全的。 必须同步任何写入操作。

另请参阅

• DataColumn
• DataRow
• DataTable
• DataSet