Procedura: convalidare le impostazioni applicazione

In questo argomento viene illustrato come convalidare le impostazioni dell'applicazione prima dell'operazione che le rende persistenti.

Poiché le impostazioni dell'applicazione sono fortemente tipizzate, è necessario in qualche modo che gli utenti non possano assegnare dati di tipo non corretto a una determinata impostazione. Un utente potrebbe comunque provare ad assegnare un valore a un'impostazione che non rientra nei limiti accettabili, ad esempio, fornendo una data di nascita che ha luogo nel futuro. ApplicationSettingsBase, la classe padre di tutte le classi di impostazioni dell'applicazione espone quattro eventi per abilitare il controllo di tali limiti. La gestione di tali eventi inserisce tutto il codice di convalida in un'unica posizione, invece di distribuirlo in tutto il progetto.

L'evento da usare dipende da quando è necessario convalidare le impostazioni, come descritto nella tabella seguente.

In genere, non si usano tutti questi eventi all'interno della stessa applicazione ai fini della convalida. Ad esempio, spesso è possibile soddisfare tutti i requisiti di convalida gestendo solo l'evento SettingChanging .

Un gestore eventi esegue in genere una delle azioni seguenti quando rileva un valore non valido:

• Fornisce automaticamente un valore noto da correggere, ad esempio il valore predefinito.

• Richiede informazioni all'utente del codice del server.

• Per gli eventi generati prima delle azioni associate, ad esempio SettingChanging e SettingsSaving, usa l'argomento CancelEventArgs per annullare l'operazione.

Per altre informazioni sulla gestione degli eventi, vedere Informazioni generali sui gestori eventi.

Le procedure seguenti illustrano come verificare la data di nascita valida utilizzando o SettingChanging l'evento SettingsSaving . Le procedure sono state scritte in base al presupposto che le impostazioni dell'applicazione siano già state create. In questo esempio, si eseguirà il controllo di un'impostazione denominata DateOfBirth. Per altre informazioni sulle impostazioni dell'applicazione, vedere Procedura: Creare impostazioni applicazioni.

Per ottenere l'oggetto delle impostazioni dell'applicazione

• Ottenere un riferimento all'oggetto delle impostazioni applicazione (l'istanza wrapper), completando uno degli elementi puntati seguenti:

  • Se le impostazioni sono state create usando la finestra di dialogo Impostazione applicazione di Visual Studio in Editor proprietà, è possibile recuperare l'oggetto predefinito delle impostazioni generato per la propria lingua tramite l'espressione seguente.

    Properties.Settings.Default
    

    MySettings.Default
    

    -oppure-

  • Se si è uno sviluppatore di Visual Basic e si sono create le impostazioni dell'applicazione tramite Creazione progetti, è possibile recuperare le impostazioni usando My.Settings Object.

    -oppure-

  • Se le impostazioni sono state create derivando direttamente da ApplicationSettingsBase , è necessario creare un'istanza manuale della classe.

    MyCustomSettings settings = new MyCustomSettings();
    

    Dim Settings as New MyCustomSettings()
    

Sono state scritte le procedure seguenti presupponendo che l'oggetto impostazioni dell'applicazione sia stato ottenuto completando l'ultimo elemento puntato in questa procedura.

Per convalidare le impostazioni dell'applicazione durante la modifica di un'impostazione

1. Gli sviluppatori C# che si trovano nell'evento del modulo o del Load controllo aggiungono un gestore eventi per l'evento SettingChanging .

   -oppure-

   Se si è uno sviluppatore di Visual Basic, è necessario dichiarare la variabile Settings usando la parola chiave WithEvents.

   public void Form1_Load(Object sender, EventArgs e)
   {
       settings.SettingChanging += new SettingChangingEventHandler(MyCustomSettings_SettingChanging);
   }
   

   Public Sub Form1_Load(sender as Object, e as EventArgs)
       AddHandler settings.SettingChanging, AddressOf MyCustomSettings_SettingChanging
   End Sub
   

2. Definire il gestore eventi e scrivere il codice all'interno per eseguire il controllo associato alla data di nascita.

   private void MyCustomSettings_SettingChanging(Object sender, SettingChangingEventArgs e)
   {
       if (e.SettingName.Equals("DateOfBirth"))
       {
           var newDate = (DateTime)e.NewValue;
           if (newDate > DateTime.Now)
           {
               e.Cancel = true;
               // Inform the user.
           }
       }
   }
   

   Private Sub MyCustomSettings_SettingChanging(sender as Object, e as SettingChangingEventArgs) Handles Settings.SettingChanging
       If (e.SettingName.Equals("DateOfBirth")) Then
           Dim NewDate as Date = CType(e.NewValue, Date)
           If (NewDate > Date.Now) Then
               e.Cancel = True
               ' Inform the user.
           End If
       End If
   End Sub
   

Per convalidare le impostazioni applicazione durante un salvataggio

1. Nell'evento della maschera o del Load controllo aggiungere un gestore eventi per l'evento SettingsSaving .

   public void Form1_Load(Object sender, EventArgs e)
   {
       settings.SettingsSaving += new SettingsSavingEventHandler(MyCustomSettings_SettingsSaving);
   }
   

   Public Sub Form1_Load(Sender as Object, e as EventArgs)
       AddHandler settings.SettingsSaving, AddressOf MyCustomSettings_SettingsSaving
   End Sub
   

2. Definire il gestore eventi e scrivere il codice all'interno per eseguire il controllo associato alla data di nascita.

   private void MyCustomSettings_SettingsSaving(Object sender, SettingsSavingEventArgs e)
   {
       if (this["DateOfBirth"] > Date.Now) {
           e.Cancel = true;
       }
   }
   

   Private Sub MyCustomSettings_SettingsSaving(Sender as Object, e as SettingsSavingEventArgs)
       If (Me["DateOfBirth"] > Date.Now) Then
           e.Cancel = True
       End If
   End Sub
   

Vedi anche

• Creazione di gestori eventi in Windows Form
• Procedura: creare le impostazioni applicazione