Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Classe ValidationRule

 

Data di pubblicazione: ottobre 2016

Consente di creare una regola personalizzata per controllare la validità dell'input utente.

Spazio dei nomi:   System.Windows.Controls
Assembly:  PresentationFramework (in PresentationFramework.dll)


public abstract class ValidationRule

NomeDescrizione
System_CAPS_protmethodValidationRule()

Inizializza una nuova istanza della classe ValidationRule.

System_CAPS_protmethodValidationRule(ValidationStep, Boolean)

Inizializza una nuova istanza di ValidationRule classe con il passaggio di convalida specificato e un valore che indica se la regola di convalida viene eseguita quando la destinazione viene aggiornata.

NomeDescrizione
System_CAPS_pubpropertyValidatesOnTargetUpdated

Ottiene o imposta un valore che indica se la regola di convalida viene eseguita quando la destinazione di Binding viene aggiornato.

System_CAPS_pubpropertyValidationStep

Ottiene o imposta quando viene eseguita la regola di convalida.

NomeDescrizione
System_CAPS_pubmethodEquals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object.)

System_CAPS_protmethodFinalize()

Consente a un oggetto di provare a liberare risorse ed eseguire altre operazioni di pulizia prima che l'oggetto stesso venga reclamato dalla procedura di Garbage Collection. (Ereditato da Object.)

System_CAPS_pubmethodGetHashCode()

Funge da funzione hash predefinita.(Ereditato da Object.)

System_CAPS_pubmethodGetType()

Ottiene l'oggetto Type dell'istanza corrente.(Ereditato da Object.)

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.(Ereditato da Object.)

System_CAPS_pubmethodToString()

Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object.)

System_CAPS_pubmethodValidate(Object, CultureInfo)

In caso di override in una classe derivata, esegue i controlli di convalida su un valore.

System_CAPS_pubmethodValidate(Object, CultureInfo, BindingExpressionBase)

Esegue controlli di convalida su un valore.

System_CAPS_pubmethodValidate(Object, CultureInfo, BindingGroup)

Esegue controlli di convalida su un valore.

Quando si utilizza il WPF modello di associazione dati, è possibile associare ValidationRules con l'oggetto di associazione. Per creare regole personalizzate, creare una sottoclasse di questa classe e implementare il Validate metodo. Facoltativamente, utilizzare l'oggetto incorporato ExceptionValidationRule, che intercetta le eccezioni generate durante gli aggiornamenti dell'origine o DataErrorValidationRule, che consente di controllare gli errori generati dal IDataErrorInfo implementazione dell'oggetto di origine.

Il motore di associazione controlla ogni ValidationRule che è associata a un'associazione ogni volta che viene trasferita l'esecuzione di un valore di input, ovvero il valore della proprietà destinazione di associazione, alla proprietà di origine dell'associazione.

Per informazioni dettagliate sulla convalida dei dati, vedere Data Binding Overview.

Per informazioni su come convalidare i dati forniti dall'utente in una finestra di dialogo, vedere Cenni preliminari sulle finestre di dialogo.

Nell'esempio seguente viene illustrato come implementare una regola di convalida. Il valore di input è valido se contiene caratteri non numerici o se è compreso i limiti inferiore e superiore. Se il valore dell'oggetto restituito ValidationResult non è valido, il ErrorContent è impostata su messaggio di errore appropriato e IsValid è impostata su false.

Per un esempio completo, vedere How to: Implement Binding Validation.

public class AgeRangeRule : ValidationRule
{
    private int _min;
    private int _max;

    public AgeRangeRule()
    {
    }

    public int Min
    {
        get { return _min; }
        set { _min = value; }
    }

    public int Max
    {
        get { return _max; }
        set { _max = value; }
    }

    public override ValidationResult Validate(object value, CultureInfo cultureInfo)
    {
        int age = 0;

        try
        {
            if (((string)value).Length > 0)
                age = Int32.Parse((String)value);
        }
        catch (Exception e)
        {
            return new ValidationResult(false, "Illegal characters or " + e.Message);
        }

        if ((age < Min) || (age > Max))
        {
            return new ValidationResult(false,
              "Please enter an age in the range: " + Min + " - " + Max + ".");
        }
        else
        {
            return new ValidationResult(true, null);
        }
    }
}

.NET Framework
Disponibile da 3.0

I membri statici pubblici ( Condiviso in Visual Basic) di questo tipo è thread safe. Non tutti i membri di istanza sono garantiti come thread safe.

Torna all'inizio
Mostra: