Een gegevenstabel maken
Een DataTable, dat één tabel met relationele gegevens in het geheugen vertegenwoordigt, onafhankelijk kan worden gemaakt en gebruikt, of kan worden gebruikt door andere .NET Framework-objecten, meestal als lid van een DataSet.
U kunt een DataTable-object maken met behulp van de juiste DataTable-constructor . U kunt deze toevoegen aan de DataSet met behulp van de methode Toevoegen om deze toe te voegen aan de verzameling Tabellen van het DataSet-object.
U kunt ook DataTable-objecten in een DataSet maken met behulp van de methoden Fill of FillSchema van het DataAdapter-object, of vanuit een vooraf gedefinieerd of afgeleid XML-schema met behulp van de methoden ReadXml, ReadXmlSchema of InferXmlSchema van de DataSet. Nadat u een gegevenstabel hebt toegevoegd als lid van de verzameling Tabellen van één DataSet, kunt u deze niet toevoegen aan de verzameling tabellen van een andere DataSet.
Wanneer u voor het eerst een gegevenstabel maakt, heeft deze geen schema (dat wil gezegd een structuur). Als u het schema van de tabel wilt definiëren, moet u objecten maken en toevoegen DataColumn aan de verzameling Kolommen van de tabel. U kunt ook een primaire-sleutelkolom voor de tabel definiëren en beperkingenobjecten maken en toevoegen aan de verzameling Beperkingen van de tabel. Nadat u het schema voor een gegevenstabel hebt gedefinieerd, kunt u rijen met gegevens toevoegen aan de tabel door DataRow-objecten toe te voegen aan de verzameling Rijen van de tabel.
U hoeft geen waarde op te geven voor de TableName eigenschap wanneer u een gegevenstabel maakt. U kunt de eigenschap op een ander moment opgeven of u kunt deze leeg laten. Wanneer u echter een tabel zonder TableName-waarde toevoegt aan een DataSet, krijgt de tabel een incrementele standaardnaam van TabelN, te beginnen met 'Tabel' voor Table0.
Notitie
U wordt aangeraden de naamconventie 'TabelN' te vermijden wanneer u een TableName-waarde opgeeft, omdat de naam die u opgeeft mogelijk conflicteert met een bestaande standaardtabelnaam in de DataSet. Als de opgegeven naam al bestaat, wordt er een uitzondering gegenereerd.
In het volgende voorbeeld wordt een exemplaar van een DataTable-object gemaakt en de naam 'Klanten' toegewezen.
Dim workTable as DataTable = New DataTable("Customers")
DataTable workTable = new DataTable("Customers");
In het volgende voorbeeld wordt een exemplaar van een gegevenstabel gemaakt door deze toe te voegen aan de verzameling Tabellen van een 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");