Delen via

DataRelations toevoegen

In een DataSet met meerdere DataTable objecten kunt u gebruik maken van DataRelation objecten om de ene tabel aan een andere te koppelen, langs de tabellen te navigeren en om onderliggende of bovenliggende rijen uit een gerelateerde tabel op te halen.

De argumenten die nodig zijn om een DataRelation te maken, zijn een naam voor de DataRelation die wordt gemaakt en een matrix van een of meer DataColumn verwijzingen naar de kolommen die fungeren als de bovenliggende en onderliggende kolommen in de relatie. Nadat u een DataRelation hebt gemaakt, kunt u deze gebruiken om tussen tabellen te navigeren en waarden op te halen.

Als u een DataRelation toevoegt aan een DataSet tabel, wordt standaard een UniqueConstraint aan de bovenliggende tabel en een ForeignKeyConstraint aan de onderliggende tabel toegevoegd. Zie DataTable-beperkingen voor meer informatie over deze standaardbeperkingen.

In het volgende codevoorbeeld wordt een DataRelation gemaakt met behulp van twee DataTable objecten in een DataSet. Elk DataTable bevat een kolom met de naam CustID, die fungeert als een koppeling tussen de twee DataTable objecten. In het voorbeeld wordt één DataRelation toegevoegd aan de verzameling Relaties van de DataSet. Het eerste argument in het voorbeeld geeft de naam op van de DataRelation die wordt gemaakt. Het tweede argument stelt de bovenliggende DataColumn in en het derde argument stelt de onderliggende DataColumn in.

customerOrders.Relations.Add("CustOrders", _  
  customerOrders.Tables("Customers").Columns("CustID"), _  
  customerOrders.Tables("Orders").Columns("CustID"))  

customerOrders.Relations.Add("CustOrders",  
  customerOrders.Tables["Customers"].Columns["CustID"],  
  customerOrders.Tables["Orders"].Columns["CustID"]);

Een DataRelation heeft ook een Nested-eigenschap die, wanneer ingesteld op true, ervoor zorgt dat de rijen uit de kindtabel worden genest binnen de bijbehorende rij uit de bovenliggende tabel wanneer deze als XML-elementen worden geschreven met behulp van WriteXml. Zie XML gebruiken in een dataset voor meer informatie.

Zie ook