DataTableCollection Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Představuje kolekci tabulek pro objekt DataSet.
public ref class DataTableCollection sealed : System::Data::InternalDataCollectionBase
public ref class DataTableCollection : System::Data::InternalDataCollectionBase
[System.ComponentModel.ListBindable(false)]
public sealed class DataTableCollection : System.Data.InternalDataCollectionBase
[System.ComponentModel.ListBindable(false)]
[System.Serializable]
public class DataTableCollection : System.Data.InternalDataCollectionBase
[<System.ComponentModel.ListBindable(false)>]
type DataTableCollection = class
inherit InternalDataCollectionBase
[<System.ComponentModel.ListBindable(false)>]
[<System.Serializable>]
type DataTableCollection = class
inherit InternalDataCollectionBase
Public NotInheritable Class DataTableCollection
Inherits InternalDataCollectionBase
Public Class DataTableCollection
Inherits InternalDataCollectionBase
- Dědičnost
- Atributy
Příklady
První postup v tomto příkladu DataTableCollectionDataSet načte hodnotu každého sloupce v každém řádku každé tabulky a vytiskne ji. Druhý postup vytvoří nový DataTable se dvěma sloupci a přidá ho DataTableCollectiondo .
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
Poznámky
Obsahuje DataTableCollection všechny DataTable objekty pro určitý DataSet. Pro přístup k objektu DataTableCollectionDataSet, použijte Tables vlastnost.
Používá DataTableCollection metody, jako Addje , Cleara Remove ke správě položek v kolekci.
Contains Pomocí metody určete, zda je v kolekci konkrétní tabulka (určená indexem nebo názvem).
Chcete-li přejít z jedné tabulky do druhé, použijte ChildRelations nebo ParentRelations vlastnost objektu DataTable pro přístup ke své kolekci DataRelation objektů. Vlastnost můžete také použít Relations k procházení vztahů nadřazenosti a podřízenosti DataTables v konkrétní DataSet kolekci.
Vlastnosti
| Name | Description |
|---|---|
| Count |
Získá celkový počet prvků v kolekci. (Zděděno od InternalDataCollectionBase) |
| IsReadOnly |
Získá hodnotu, která označuje, zda InternalDataCollectionBase je jen pro čtení. (Zděděno od InternalDataCollectionBase) |
| IsSynchronized |
Získá hodnotu, která označuje, zda InternalDataCollectionBase je synchronizován. (Zděděno od InternalDataCollectionBase) |
| Item[Int32] |
DataTable Získá objekt v zadaném indexu. |
| Item[String, String] |
DataTable Získá objekt se zadaným názvem v zadaném oboru názvů. |
| Item[String] |
DataTable Získá objekt se zadaným názvem. |
| List |
Získá položky kolekce jako seznam. |
| List |
Získá položky kolekce jako seznam. (Zděděno od InternalDataCollectionBase) |
| SyncRoot |
Získá objekt, který lze použít k synchronizaci kolekce. (Zděděno od InternalDataCollectionBase) |
Metody
| Name | Description |
|---|---|
| Add() |
Vytvoří nový DataTable objekt pomocí výchozího názvu a přidá ho do kolekce. |
| Add(DataTable) |
Přidá zadaný |
| Add(String, String) |
DataTable Vytvoří objekt pomocí zadaného názvu a přidá ho do kolekce. |
| Add(String) |
DataTable Vytvoří objekt pomocí zadaného názvu a přidá ho do kolekce. |
| AddRange(DataTable[]) |
Zkopíruje prvky zadaného DataTable pole na konec kolekce. |
| CanRemove(DataTable) |
Ověřuje, zda je možné zadaný DataTable objekt z kolekce odebrat. |
| Clear() |
Vymaže kolekci všech DataTable objektů. |
| Contains(String, String) |
Získá hodnotu, která určuje, zda DataTable objekt se zadaným názvem a oborem názvů tabulky existuje v kolekci. |
| Contains(String) |
Získá hodnotu, která určuje, zda DataTable objekt se zadaným názvem existuje v kolekci. |
| CopyTo(Array, Int32) |
Zkopíruje všechny prvky aktuálního do InternalDataCollectionBase jednorozměrného Array, počínaje zadaným InternalDataCollectionBase indexem. (Zděděno od InternalDataCollectionBase) |
| CopyTo(DataTable[], Int32) |
Zkopíruje všechny prvky aktuálního do DataTableCollection jednorozměrného Arrayindexu , počínaje zadaným cílovým indexem pole. |
| Equals(Object) |
Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object) |
| GetEnumerator() |
IEnumerator Získá pro kolekci. (Zděděno od InternalDataCollectionBase) |
| GetHashCode() |
Slouží jako výchozí funkce hash. (Zděděno od Object) |
| GetType() |
Získá Type aktuální instance. (Zděděno od Object) |
| IndexOf(DataTable) |
Získá index zadaného DataTable objektu. |
| IndexOf(String, String) |
Získá index v kolekci zadaného DataTable objektu. |
| IndexOf(String) |
Získá index v kolekci objektu DataTable se zadaným názvem. |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object) |
| OnCollectionChanged(CollectionChangeEventArgs) |
OnCollectionChanged(CollectionChangeEventArgs) Vyvolá událost. |
| OnCollectionChanging(CollectionChangeEventArgs) |
Představuje kolekci tabulek pro objekt DataSet. |
| Remove(DataTable) |
Odebere zadaný DataTable objekt z kolekce. |
| Remove(String, String) |
Odebere DataTable objekt se zadaným názvem z kolekce. |
| Remove(String) |
Odebere DataTable objekt se zadaným názvem z kolekce. |
| RemoveAt(Int32) |
Odebere DataTable objekt v zadaném indexu z kolekce. |
| ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
Událost
| Name | Description |
|---|---|
| CollectionChanged |
Nastane po DataTableCollection změně kvůli DataTable přidání nebo odebrání objektů. |
| CollectionChanging |
Nastane, když DataTableCollection se mění kvůli DataTable přidání nebo odebrání objektů. |
Metody rozšíření
| Name | Description |
|---|---|
| AsParallel(IEnumerable) |
Umožňuje paralelizaci dotazu. |
| AsQueryable(IEnumerable) |
Převede IEnumerable na IQueryable. |
| Cast<TResult>(IEnumerable) |
Přetypuje prvky IEnumerable na zadaný typ. |
| OfType<TResult>(IEnumerable) |
Filtruje prvky IEnumerable na základě zadaného typu. |
Platí pro
Bezpečný přístup z více vláken
Tento typ je bezpečný pro operace čtení s více vlákny. Je nutné synchronizovat všechny operace zápisu.