Sdílet prostřednictvím


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 DataSet.

Objekt můžete vytvořit DataTable pomocí příslušného DataTable konstruktoru. Můžete jej přidat do DataSet pomocí metody Add, která ho přidá do kolekce objektu DataSetTables.

Objekty v rámci objektu DataTable můžete také vytvářet DataSet pomocí Fill nebo FillSchema metod objektu DataAdapter nebo z předdefinovaného nebo odvozeného schématu XML pomocí ReadXml, ReadXmlSchema nebo InferXmlSchema metod DataSet. Všimněte si, že po přidání DataTable jako člena Tables kolekce 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 Columns kolekce tabulky. Můžete také definovat sloupec primárního klíče pro tabulku a vytvořit a přidat Constraint objekty do Constraints kolekce tabulky. Po definování schématu pro tabulku DataTable můžete do tabulky přidat řádky dat přidáním DataRow objektů do Rows kolekce tabulky.

Při vytváření TableName nemusíte zadávat hodnotu vlastnosti. Vlastnost můžete zadat na jiný čas nebo ji můžete nechat prázdnou. Když ale do DataSetu přidáte tabulku bez hodnoty TableName, tabulka obdrží přírůstkový výchozí název, začínající od "Table0", ve formátu TableN.

Poznámka:

Doporučujeme, abyste se při zadávání hodnoty vyhnuli konvenci vytváření názvů "TabulkaTableName", 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 objektu DataTable přidáním do Tables kolekce 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é