ValidationRule Kelas

Definisi

Ruang nama:

System.Windows.Controls

Rakitan:

PresentationFramework.dll

Menyediakan cara untuk membuat aturan kustom untuk memeriksa validitas input pengguna.

public ref class ValidationRule abstract

public abstract class ValidationRule

type ValidationRule = class

Public MustInherit Class ValidationRule

Warisan

Object

ValidationRule

Turunan

System.Windows.Controls.DataErrorValidationRule

System.Windows.Controls.ExceptionValidationRule

System.Windows.Controls.NotifyDataErrorValidationRule

Contoh

Contoh berikut menunjukkan cara menerapkan aturan validasi. Nilai input tidak valid jika berisi karakter non-numerik atau jika berada di luar batas bawah dan atas. Jika nilai yang dikembalikan ValidationResult tidak valid, ErrorContent properti diatur ke pesan kesalahan yang sesuai dan IsValid properti diatur ke false.

Untuk contoh lengkapnya, lihat Cara: Menerapkan Validasi Pengikatan.

public class AgeRangeRule : ValidationRule
{
    public int Min { get; set; }
    public int Max { get; set; }
    
    public AgeRangeRule()
    {
    }

    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}.");
        }
        return ValidationResult.ValidResult;
    }
}

Keterangan

Saat Anda menggunakan model pengikatan data WPF, Anda dapat mengaitkan ValidationRules dengan objek pengikatan Anda. Untuk membuat aturan kustom, buat subkelas kelas ini dan terapkan metode .Validate Secara opsional, gunakan bawaan ExceptionValidationRule, yang menangkap pengecualian yang dilemparkan selama pembaruan sumber, atau DataErrorValidationRule, yang memeriksa kesalahan yang dimunculkan oleh IDataErrorInfo implementasi objek sumber.

Mesin pengikatan memeriksa masing-masing ValidationRule yang terkait dengan pengikatan setiap kali mentransfer nilai input, yang merupakan nilai properti target pengikatan, ke properti sumber pengikatan.

Untuk informasi terperinci tentang validasi data, lihat Gambaran Umum Pengikatan Data.

Untuk informasi tentang cara memvalidasi data yang disediakan pengguna dalam kotak dialog, lihat Gambaran Umum Kotak Dialog.

Konstruktor

Nama	Deskripsi
ValidationRule()	Menginisialisasi instans baru dari kelas ValidationRule.
ValidationRule(ValidationStep, Boolean)	Menginisialisasi instans ValidationRule baru kelas dengan langkah validasi yang ditentukan dan nilai yang menunjukkan apakah aturan validasi berjalan saat target diperbarui.

Properti

Nama	Deskripsi
ValidatesOnTargetUpdated	Mendapatkan atau menetapkan nilai yang menunjukkan apakah aturan validasi berjalan saat target diperbarui Binding .
ValidationStep	Mendapatkan atau mengatur saat aturan validasi berjalan.

Metode

Nama	Deskripsi
Validate(Object, CultureInfo, BindingExpressionBase)	Melakukan pemeriksaan validasi pada nilai.
Validate(Object, CultureInfo, BindingGroup)	Melakukan pemeriksaan validasi pada nilai.
Validate(Object, CultureInfo)	Saat ditimpa dalam kelas turunan, lakukan pemeriksaan validasi pada nilai.

Lihat juga

• DataErrorValidationRule
• ExceptionValidationRule