Convalidare i dati nei set di dati nelle applicazioni .NET Framework

La convalida dei dati è il processo di confermare che i valori immessi negli oggetti dati siano conformi ai vincoli all'interno dello schema di un set di dati. Il processo di convalida conferma anche che questi valori seguono le regole stabilite per l'applicazione. È consigliabile convalidare i dati prima di inviare aggiornamenti al database sottostante. In questo modo si riducono gli errori e il numero potenziale di round trip tra un'applicazione e il database.

È possibile verificare che i dati scritti in un set di dati siano validi compilando controlli di convalida nel set di dati stesso. Il set di dati può controllare i dati indipendentemente dal modo in cui viene eseguito l'aggiornamento, indipendentemente dal fatto che vengano eseguiti direttamente dai controlli in una maschera, all'interno di un componente o in altro modo. Poiché il set di dati fa parte dell'applicazione (a differenza del back-end del database), è una posizione logica per compilare la convalida specifica dell'applicazione.

La posizione migliore per aggiungere la convalida all'applicazione è nel file di classe parziale del set di dati. In Visual Basic o Visual C# aprire Progettazione set di dati e fare doppio clic sulla colonna o sulla tabella per cui si vuole creare la convalida. Questa azione apre il file di codice, in cui è possibile creare un ColumnChanging gestore eventi o RowChanging .

private static void OnColumnChanging(object sender, DataColumnChangeEventArgs e)
{

}

Private Shared Sub OnColumnChanging(sender As Object, e As DataColumnChangeEventArgs)

End Sub

Convalida i dati

La convalida all'interno di un set di dati viene eseguita nei modi seguenti:

• Creando una convalida specifica dell'applicazione in grado di controllare i valori in una singola colonna di dati durante le modifiche. Per altre informazioni, vedere Procedura: Convalidare i dati durante le modifiche alle colonne.

• Creando una convalida specifica dell'applicazione in grado di controllare i dati ai valori durante la modifica di un'intera riga di dati. Per altre informazioni, vedere Procedura: Convalidare i dati durante le modifiche alle righe.

• Creando chiavi, vincoli univoci e così via come parte della definizione effettiva dello schema del set di dati.

• Impostando le proprietà dell'oggetto DataColumn , ad esempio MaxLength, AllowDBNulle Unique.

Diversi eventi vengono generati dall'oggetto DataTable quando si verifica una modifica in un record:

• Gli ColumnChanging eventi e ColumnChanged vengono generati durante e dopo ogni modifica a una singola colonna. L'evento ColumnChanging è utile quando si desidera convalidare le modifiche in colonne specifiche. Le informazioni sulla modifica proposta vengono passate come argomento con l'evento .
• Gli RowChanging eventi e RowChanged vengono generati durante e dopo qualsiasi modifica in una riga. L'evento RowChanging è più generale. Indica che si sta verificando una modifica in un punto qualsiasi della riga, ma non si sa quale colonna è stata modificata.

Per impostazione predefinita, ogni modifica a una colonna genera quindi quattro eventi. Il primo è l'evento ColumnChanging e ColumnChanged per la colonna specifica da modificare. Di seguito sono riportati gli RowChanging eventi e RowChanged . Se vengono apportate più modifiche alla riga, gli eventi verranno generati per ogni modifica.

L'evento scelto dipende dalla granularità della convalida. Se è importante rilevare un errore immediatamente quando viene modificata una colonna, eseguire la convalida della compilazione usando l'evento ColumnChanging . In caso contrario, usare l'evento , che potrebbe causare l'acquisizione RowChanging di diversi errori contemporaneamente. Inoltre, se i dati sono strutturati in modo che il valore di una colonna venga convalidato in base al contenuto di un'altra colonna, eseguire la convalida durante l'evento RowChanging .

Quando i record vengono aggiornati, l'oggetto DataTable genera eventi a cui è possibile rispondere man mano che si verificano modifiche e dopo che vengono apportate modifiche.

Se l'applicazione usa un set di dati tipizzato, è possibile creare gestori eventi fortemente tipizzato. In questo modo vengono aggiunti quattro eventi tipizzato aggiuntivi per i quali è possibile creare gestori: dataTableNameRowChanging, dataTableNameRowChanged, dataTableNameRowDeletinge dataTableNameRowDeleted. Questi gestori eventi tipizzato passano un argomento che include i nomi di colonna della tabella che semplificano la scrittura e la lettura del codice.

Eventi di aggiornamento dei dati

Gli ColumnChangingeventi , RowChanginge RowDeleting vengono generati durante il processo di aggiornamento. È possibile usare questi eventi per convalidare i dati o eseguire altri tipi di elaborazione. Poiché l'aggiornamento è in corso durante questi eventi, è possibile annullarlo generando un'eccezione che impedisce il completamento dell'aggiornamento.

Gli ColumnChangedeventi , RowChanged e RowDeleted sono eventi di notifica generati al termine dell'aggiornamento. Questi eventi sono utili quando si vuole eseguire ulteriori azioni in base a un aggiornamento riuscito.

Convalidare i dati durante le modifiche alle colonne

È possibile convalidare i dati quando il valore in una colonna di dati cambia rispondendo all'evento ColumnChanging . Quando viene generato, questo evento passa un argomento evento (ProposedValue) che contiene il valore proposto per la colonna corrente. In base al contenuto di e.ProposedValue, è possibile:

• Accettare il valore proposto facendo nulla.

• Rifiutare il valore proposto impostando l'errore di colonna (SetColumnError) all'interno del gestore eventi di modifica della colonna.

• Facoltativamente, usare un ErrorProvider controllo per visualizzare un messaggio di errore all'utente. Per altre informazioni, vedere Componente ErrorProvider.

La convalida può essere eseguita anche durante l'evento RowChanging .

Convalidare i dati durante le modifiche alle righe

È possibile scrivere codice per verificare che ogni colonna da convalidare contenga dati che soddisfino i requisiti dell'applicazione. A tale scopo, impostare la colonna per indicare che contiene un errore se un valore proposto non è accettabile. Negli esempi seguenti viene impostato un errore di colonna quando la Quantity colonna è uguale o inferiore a 0. I gestori eventi di modifica delle righe devono essere simili agli esempi seguenti.

Per convalidare i dati quando viene modificata una riga (Visual Basic)

1. Aprire il set di dati in Progettazione DataSet. Per altre informazioni, vedere Procedura dettagliata: Creazione di un set di dati in Progettazione set di dati.

2. Fare doppio clic sulla barra del titolo della tabella da convalidare. Questa azione crea automaticamente il RowChanging gestore eventi di DataTable nel file di classe parziale del set di dati.

   Suggerimento

   Fare doppio clic a sinistra del nome della tabella per creare il gestore eventi di modifica delle righe. Se si fa doppio clic sul nome della tabella, è possibile modificarlo.

   Private Sub Order_DetailsDataTable_Order_DetailsRowChanging(
       ByVal sender As System.Object, 
       ByVal e As Order_DetailsRowChangeEvent
     ) Handles Me.Order_DetailsRowChanging
   
       If CType(e.Row.Quantity, Short) <= 0 Then
           e.Row.SetColumnError("Quantity", "Quantity must be greater than 0")
       Else
           e.Row.SetColumnError("Quantity", "")
       End If
   End Sub
   

Per convalidare i dati quando una riga cambia (C#)

1. Aprire il set di dati in Progettazione DataSet. Per altre informazioni, vedere Procedura dettagliata: Creazione di un set di dati in Progettazione set di dati.

2. Fare doppio clic sulla barra del titolo della tabella da convalidare. Questa azione crea un file di classe parziale per l'oggetto DataTable.

   Nota

   Progettazione set di dati non crea automaticamente un gestore eventi per l'evento RowChanging . È necessario creare un metodo per gestire l'evento RowChanging ed eseguire il codice per associare l'evento nel metodo di inizializzazione della tabella.

3. Copiare il codice seguente nella classe parziale:

   public override void EndInit()
   {
       base.EndInit();
       Order_DetailsRowChanging += TestRowChangeEvent;
   }
   
   public void TestRowChangeEvent(object sender, Order_DetailsRowChangeEvent e)
   {
       if ((short)e.Row.Quantity <= 0)
       {
           e.Row.SetColumnError("Quantity", "Quantity must be greater than 0");
       }
       else
       {
           e.Row.SetColumnError("Quantity", "");
       }
   }
   

Per recuperare le righe modificate

Ogni riga di una tabella dati ha una RowState proprietà che tiene traccia dello stato corrente della riga utilizzando i valori nell'enumerazione DataRowState . È possibile restituire righe modificate da un set di dati o da una tabella di dati chiamando il GetChanges metodo di un DataSet oggetto o DataTable. È possibile verificare che le modifiche esistano prima di chiamare GetChanges chiamando il HasChanges metodo di un set di dati.

La chiamata al GetChanges metodo di un set di dati o di una tabella di dati restituisce un nuovo set di dati o una tabella di dati contenente solo i record modificati. Se si desidera ottenere record specifici, ad esempio solo nuovi record o solo record modificati, è possibile passare un valore dall'enumerazione DataRowState come parametro al GetChanges metodo .

Usare l'enumerazione DataRowVersion per accedere alle diverse versioni di una riga, ad esempio i valori originali presenti in una riga prima dell'elaborazione.

Per ottenere tutti i record modificati da un set di dati

• Chiamare il GetChanges metodo di un set di dati.

  L'esempio seguente crea un nuovo set di dati denominato changedRecords e lo popola con tutti i record modificati da un altro set di dati denominato dataSet1.

  • C#
  • VB

  DataSet changedRecords = dataSet1.GetChanges();
  

Per ottenere tutti i record modificati da una tabella dati

• Chiamare il GetChanges metodo di un oggetto DataTable.

  Nell'esempio seguente viene creata una nuova tabella dati denominata changedRecordsTable e popolata con tutti i record modificati da un'altra tabella di dati denominata dataTable1.

  • C#
  • VB

  DataTable changedRecordsTable = dataTable1.GetChanges();
  

Per ottenere tutti i record con uno stato di riga specifico

• Chiamare il GetChanges metodo di un set di dati o di una tabella di dati e passare un DataRowState valore di enumerazione come argomento.

  Nell'esempio seguente viene illustrato come creare un nuovo set di dati denominato addedRecords e popolarlo solo con record aggiunti al dataSet1 set di dati.

  • C#
  • VB

  DataSet addedRecords = dataSet1.GetChanges(DataRowState.Added);
  

  Nell'esempio seguente viene illustrato come restituire tutti i record aggiunti di recente alla Customers tabella:

  • C#
  • VB

  private NorthwindDataSet.CustomersDataTable GetNewRecords()
  {
      return (NorthwindDataSet.CustomersDataTable)
          northwindDataSet1.Customers.GetChanges(DataRowState.Added);
  }
  

Accedere alla versione originale di un DataRow

Quando vengono apportate modifiche alle righe di dati, il set di dati mantiene le versioni originali (Original) e nuoveCurrent () della riga. Ad esempio, prima di chiamare il metodo, l'applicazione AcceptChanges può accedere alle diverse versioni di un record (come definito nell'enumerazione DataRowVersion ) ed elaborare le modifiche di conseguenza.

Il passaggio del DataRowVersion valore insieme all'indice di colonna (o al nome di colonna come stringa) restituisce il valore dalla versione di riga specifica della colonna. La colonna modificata viene identificata durante gli ColumnChanging eventi e ColumnChanged . Questo è un buon momento per esaminare le diverse versioni di riga a scopo di convalida. Tuttavia, se sono stati temporaneamente sospesi vincoli, tali eventi non verranno generati e sarà necessario identificare a livello di codice le colonne modificate. A tale scopo, è possibile scorrere la Columns raccolta e confrontare i diversi DataRowVersion valori.

Per ottenere la versione originale di un record

• Accedere al valore di una colonna passando l'oggetto DataRowVersion della riga che si desidera restituire.

  Nell'esempio seguente viene illustrato come usare un DataRowVersion valore per ottenere il valore originale di un CompanyName campo in un DataRowoggetto :

  • C#
  • VB

  string originalCompanyName;
  originalCompanyName = northwindDataSet1.Customers[0]
      ["CompanyName", DataRowVersion.Original].ToString();
  

Accedere alla versione corrente di un DataRow

Per ottenere la versione corrente di un record

• Accedere al valore di una colonna e quindi aggiungere un parametro all'indice che indica quale versione di una riga si desidera restituire.

  Nell'esempio seguente viene illustrato come usare un DataRowVersion valore per ottenere il valore corrente di un CompanyName campo in un DataRowoggetto :

  • C#
  • VB

  string currentCompanyName;
  currentCompanyName = northwindDataSet1.Customers[0]
      ["CompanyName", DataRowVersion.Current].ToString();
  

Contenuto correlato

• Strumenti di set di dati in Visual Studio
• Procedura: Convalidare dati nel controllo DataGridView di Windows Form
• Procedura: Visualizzare le icone di errori per la convalida dei moduli con il componente ErrorProvider di Windows Form