Schema validatie
Linq to SQL gaat tal van database-instellingen overnemen wanneer data ingevoerd wordt:
- Compile-time fouten wanneer je bv. een string in een Boolean veld wil opslaan
- Kolommen die nullwaarden accepteren of niet
- Indentity (autonummering) wordt gerespecteerd
- ...
Property validatie:
Meestal is de automatische validatie die gebeurt door het databaseschema te interpreteren niet voldoende.
Sommige controles, zoals constraints op tabellen worden niet automatisch gedaan: op de tabel Products vinden we op databaseniveau een constraint voor de kolom ReorderLevel:
- Voer je volgende code uit (in de veronderstelling dat je drankjes hebt met ReorderLevel = 23), dan krijg je een foutmelding doordat de databaseactie deze constraint overtreedt:
NorthwindDataContext db = new NorthwindDataContext();
var products = from p in db.Products
where p.Category.CategoryName == "Beverages"
where p.ReorderLevel == 23
select p;
foreach (Product p in products)
{
p.ReorderLevel = -2;
}
db.SubmitChanges();
BindProductsGrid();
- Levert:
Het is mogelijk op Linq to SQL niveau aangepaste validatie te voorzien.
- Vraag via Class View de definition op voor de property ReorderLevel van de klasse Product:
[Column(Storage="_ReorderLevel", DbType="SmallInt")]
public System.Nullable ReorderLevel
{
get
{
return this._ReorderLevel;
}
set
{
if ((this._ReorderLevel != value))
{
this.OnReorderLevelChanging(value);
this.SendPropertyChanging();
this._ReorderLevel = value;
this.SendPropertyChanged("ReorderLevel");
this.OnReorderLevelChanged();
}
}
}
Hier leren we dat een methode OnReorderLevelChanging wordt aangeroepen vóór de data wordt aangepast.
De methode OnReoderLevelChanging is eigenlijk een partial method zonder inhoud, het is de bedoeling dat wij hier een uitbreidingspunt vinden voor onze eigen validatie.
- Maak zelf een partial class Product met een methode OnReorderLevelChanging in de class Library NorthwindDAL
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
namespace NorthwindDAL
{
public partial class Product
{
partial void OnReorderLevelChanging(short? value)
{
if (value < 0)
throw new Exception("ReorderLevel mag niet negatief zijn");
}
}
}
Je kan hierbij handig gebruik maken van Intellisense:
- Probeer je nu nogmaals de update uit te voeren, dan is de melding al wat duidelijker:
- Het is nu natuurlijk niet gebruiksvriendelijk de toepasing te laten "crashen" :)
Voeg een Label lblError toe en pas de code voor de update aan:
try
{
NorthwindDataContext db = new NorthwindDataContext();
var products = from p in db.Products
where p.Category.CategoryName == "Beverages"
where p.ReorderLevel == 23
select p;
foreach (Product p in products)
{
p.ReorderLevel = -2;
}
db.SubmitChanges();
BindProductsGrid();
}
catch (Exception ex)
{
lblError.Text = ex.Message;
}
- De gebruiker ziet nu deze melding wanneer op de knop "Update" wordt geklikt.
Entity validatie
Wanneer bijvooebeeld de waarde van twee eigenschappen moet vergelijken kan je dat niet meer doen door de partial method OnPropertyChanging te implementeren.
- Voeg een partial method OnValidate toe aan de partial class Product in NorthwindDAL:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
namespace NorthwindDAL
{
public partial class Product
{
partial void OnReorderLevelChanging(short? value)
{
if (value < 0)
throw new Exception("ReorderLevel mag niet negatief zijn");
}
partial void OnValidate(System.Data.Linq.ChangeAction action)
{
if (UnitPrice > ReorderLevel)
throw new Exception("Unitprice > Reorderlevel, dat mag niet!");
}
}
}
- Probeer nu een update te doen waarbij ReorderLever groter is dan 0 maar kleiner dan UnitPrice.
- Commentariëer deze implementatie van OnValidate uit, want het slaat eigenlijk nergens op :).
Aangepaste update/insert/delete voor een Entity
Soms wil je bepaalde code laten uitvoeren wanneeer de gebruiker een element update, insert of delete.
Je wil bijvoorbeeld een controle doen los van het element dat je update, je wil data loggen, backuppen, ...
Linq to SQL biedt je de mogelijkheid om de methoden UpdateEntity, InsertEntity en DeleteEntity (waarbij je Entity vervangt door je eigen klassenaam) in de DataContext-klasse te voorzien.
- Voorzie een partial class NorthwindDataContext:
using System.Text;
using System.Diagnostics;
namespace NorthwindDAL
{
public partial class NorthwindDataContext
{
partial void UpdateProduct(Product instance)
{
Debug.Print("Update voor product: " +instance.ProductName + ": RL = " + instance.ReorderLevel.ToString());
Debug.Print("Voor update product - controles");
//Doe de eigenlijke update
this.ExecuteDynamicUpdate(instance);
Debug.Print("Na update product - logging");
}
}
}
- In de DataContext-klasse kan je op deze manier de update, insert en delete-acties op de Linq to SQL gegenereerde klassen onderscheppen.
- Vergeet de ExecuteDynamic... - methode niet uit te voeren, anders wordt de actie nooit uitgevoerd!
- Zorg voor een update in de Web Form:
try
{
NorthwindDataContext db = new NorthwindDataContext();
var products = from p in db.Products
where p.Category.CategoryName == "Beverages"
where p.ReorderLevel == 23
select p;
foreach (Product p in products)
{
p.ReorderLevel = 24;
}
db.SubmitChanges();
BindProductsGrid();
}
catch (Exception ex)
{
lblError.Text = ex.Message;
}
- In het Ouptut venster voor Debug-info zien we:
Update voor product: Chang: RL = 24
Voor update product - controles
Na update product - logging
Update voor product: Ipoh Coffee: RL = 24
Voor update product - controles
Na update product - logging
Update voor product: Rhönbräu Klosterbier: RL = 24
Voor update product - controles
Na update product - logging
