Vytvoření datové tabulky

A DataTable, který představuje jednu tabulku relačních dat v paměti, lze vytvořit a používat nezávisle, nebo může být používán jinými objekty rozhraní .NET Framework, nejčastěji jako člen určitý DataSet.

Objekt DataTable můžete vytvořit pomocí příslušného konstruktoru DataTable. Můžete ho přidat do DataSet pomocí Add metoda přidat ji do kolekce Tabulky objektu DataSet.

Objekty DataTable můžete také vytvořit v rámci DataSet pomocí Fill nebo FillSchema metody DataAdapter objektu, nebo z předdefinovaného nebo odvozeného schématu XML pomocí ReadXml, ReadXmlSchema nebo InferXmlSchema metody DataSet. Všimněte si, že po přidání tabulky jako člena kolekce Tabulky jedné datové sady ji nemůžete přidat do kolekce tabulek žádné jiné datové sady.

Při prvním vytvoření tabulky DataTable nemá schéma (to znamená strukturu). Chcete-li definovat schéma tabulky, musíte vytvořit a přidat DataColumn objekty do kolekce Columns v tabulce. Můžete také definovat sloupec primárního klíče pro tabulku a vytvořit a přidat objekty Constraint do kolekce Omezení tabulky. Po definování schématu tabulky DataTable můžete do tabulky přidat řádky dat přidáním objektů DataRow do kolekce Řádky tabulky.

Při vytváření tabulky DataTable nemusíte zadávat hodnotu TableName vlastnosti. Vlastnost můžete zadat na jiný čas nebo ji můžete nechat prázdnou. Když ale do datové sady přidáte tabulku bez hodnoty TableName, tabulka bude mít přírůstkový výchozí název tabulkyN počínaje tabulkou Table0.

Poznámka:

Doporučujeme, abyste se při zadávání hodnoty TableName vyhnuli konvenci pojmenování "TabulkaN", protože zadaný název může být v konfliktu s existujícím výchozím názvem tabulky v datové sadě. Pokud zadaný název již existuje, vyvolá se výjimka.

Následující příklad vytvoří instanci objektu DataTable a přiřadí ji název "Customers".

Dim workTable as DataTable = New DataTable("Customers")  
DataTable workTable = new DataTable("Customers");  

Následující příklad vytvoří instanci DataTable tak, že ji přidá do kolekce Tables objektu DataSet.

Dim customers As DataSet = New DataSet  
Dim customersTable As DataTable = _  
   customers.Tables.Add("CustomersTable")  
DataSet customers = new DataSet();  
DataTable customersTable = customers.Tables.Add("CustomersTable");  

Viz také