Akademi C# · Pelajaran

Pengesahan Anotasi Data

Sahkan model dengan atribut.

Pelajaran 1 daripada 413 langkah

Pengesahan Anotasi Data ialah pelajaran Akademi C# percuma di CoddyKit. Ini ialah pelajaran 1 daripada 4. Anda boleh membaca keseluruhan pelajaran di bawah secara percuma — kemudian berlatih secara praktikal dalam pelayar menggunakan penyunting kod terbina dalam dan tutor kecerdasan buatan 24/7. Pelajaran ini merupakan sebahagian daripada laluan pembelajaran Akademi C#, dan kemajuan anda disegerakkan merentas web serta aplikasi CoddyKit. Kursus Akademi C# merangkumi sejumlah 4 pelajaran.

Apakah Pengesahan Anotasi Data

Anotasi Data ialah atribut yang diletakkan pada sifat model untuk mengisytiharkan peraturan pengesahan secara terus dalam kelas C# anda. ASP.NET Core membaca atribut ini semasa pengikatan model dan mengesahkan permintaan masuk secara automatik.

Anotasi ini berada dalam ruang nama System.ComponentModel.DataAnnotations.

using System.ComponentModel.DataAnnotations;

public class RegisterRequest
{
    [Required]
    public string Username { get; set; }
}

Atribut [Required]

[Required] memastikan sesuatu sifat bukan null dan bukan rentetan kosong secara lalai. Jika pelanggan tidak menyertakan medan tersebut, pengesahan model gagal sebelum tindakan anda dijalankan.

Anda boleh menyesuaikan mesej dengan ErrorMessage.

public class RegisterRequest
{
    [Required(ErrorMessage = "Username is required.")]
    public string Username { get; set; }

    [Required]
    public string Password { get; set; }
}

Mengesahkan Nombor Dengan [Range]

[Range] mengehadkan nilai angka kepada minimum dan maksimum yang inklusif. Ia berfungsi dengan int, double, decimal dan banyak lagi jenis.

Gunakannya untuk umur, kuantiti, penilaian dan sebarang nombor yang mempunyai had.

public class ProductRequest
{
    [Range(1, 1000, ErrorMessage = "Quantity must be between 1 and 1000.")]
    public int Quantity { get; set; }

    [Range(0.01, 9999.99)]
    public decimal Price { get; set; }
}

Mengesahkan E-mel Dengan [EmailAddress]

[EmailAddress] menyemak sama ada rentetan kelihatan seperti alamat e-mel yang sah. Gabungkannya dengan [Required] supaya medan tersebut wujud dan mempunyai format yang betul.

public class ContactRequest
{
    [Required]
    [EmailAddress(ErrorMessage = "Please enter a valid email.")]
    public string Email { get; set; }
}

Had Panjang Rentetan

[StringLength] menetapkan panjang maksimum dan, secara pilihan, panjang minimum untuk teks. [MinLength] dan [MaxLength] ialah pilihan yang lebih ringkas.

public class RegisterRequest
{
    [Required]
    [StringLength(20, MinimumLength = 3)]
    public string Username { get; set; }

    [MaxLength(500)]
    public string Bio { get; set; }
}

Pemadanan Corak Dengan [RegularExpression]

[RegularExpression] mengesahkan rentetan berdasarkan corak regex. Ia sesuai untuk format seperti nombor telefon, kod pos atau slug.

public class ProfileRequest
{
    [RegularExpression(@"^[a-z0-9-]+$",
        ErrorMessage = "Slug may only contain lowercase letters, digits and dashes.")]
    public string Slug { get; set; }
}

Membandingkan Dua Medan Dengan [Compare]

[Compare] memastikan satu sifat sepadan dengan sifat yang lain. Contoh klasiknya ialah mengesahkan kata laluan.

public class RegisterRequest
{
    [Required]
    public string Password { get; set; }

    [Compare(nameof(Password), ErrorMessage = "Passwords do not match.")]
    public string ConfirmPassword { get; set; }
}

Cara ModelState Melaporkan Ralat

Apabila pengesahan gagal, ASP.NET Core mengisi ModelState dengan ralat tersebut. Dalam pengawal API yang dihiasi dengan [ApiController], permintaan tidak sah akan mengembalikan respons 400 secara automatik, jadi anda jarang perlu menyemaknya secara manual.

[ApiController]
[Route("api/[controller]")]
public class AccountController : ControllerBase
{
    [HttpPost("register")]
    public IActionResult Register(RegisterRequest request)
    {
        // [ApiController] already returned 400 if invalid
        return Ok("Registered " + request.Username);
    }
}

Semakan ModelState Secara Manual

Tanpa [ApiController], contohnya dalam pengawal MVC, anda perlu menyemak ModelState.IsValid sendiri dan menentukan cara untuk memberikan respons.

public IActionResult Register(RegisterRequest request)
{
    if (!ModelState.IsValid)
    {
        return BadRequest(ModelState);
    }
    return Ok();
}

Menggabungkan Berbilang Anotasi

Anotasi boleh disusun bersama. Satu sifat boleh mempunyai beberapa atribut, dan kesemuanya mesti lulus. Susunan tidak mempengaruhi penilaian, tetapi pastikan susunannya mudah dibaca.

public class SignupRequest
{
    [Required]
    [EmailAddress]
    [StringLength(254)]
    public string Email { get; set; }

    [Required]
    [Range(18, 120, ErrorMessage = "Must be 18 or older.")]
    public int Age { get; set; }
}

Apabila Anotasi Data Tidak Mencukupi

Anotasi Data sangat sesuai untuk peraturan mudah dan deklaratif. Namun, logik merentas sifat, carian pangkalan data atau peraturan bersyarat ("diperlukan hanya apabila X") dengan cepat menjadi sukar diurus. Di sinilah FluentValidation amat berguna, dan perkara ini akan dibincangkan seterusnya.

Semakan Pantas

Uji pemahaman anda tentang anotasi data.

Jawab dalam pelajaran interaktif

Ringkasan

Anda telah mempelajari bahawa Anotasi Data mengisytiharkan peraturan pengesahan sebagai atribut: [Required] untuk memastikan kewujudan, [Range] untuk had angka, [EmailAddress] untuk format e-mel, serta [StringLength], [RegularExpression] dan [Compare]. Dengan [ApiController], kegagalan akan mengembalikan 400 secara automatik melalui ModelState. Untuk peraturan yang kompleks, gunakan FluentValidation seterusnya.

Percuma untuk bermula

Pelajari C# dengan tutor kecerdasan buatan — percuma

Tulis dan jalankan kod sebenar dalam pelayar anda, dapatkan bantuan segera daripada tutor kecerdasan buatan yang tersedia 24/7, dan sambung semula dari tempat anda berhenti di web atau dalam aplikasi.

Kursus: 93
Pelajaran: 346

Mula belajar secara percuma Lihat kursus penuh

Soalan Lazim

Adakah pelajaran “Pengesahan Anotasi Data” percuma?

Ya — teks penuh “Pengesahan Anotasi Data” boleh dibaca secara percuma di web ini. Untuk berlatih secara interaktif menggunakan penyunting kod terbina dalam dan tutor kecerdasan buatan 24/7, serta membuka kunci baki kursus Akademi C#, tingkat taraf kepada CoddyKit PRO. Kursus Akademi C# merangkumi sejumlah 4 pelajaran.

Apakah yang akan saya pelajari dalam “Pengesahan Anotasi Data”?

Sahkan model dengan atribut. Anda berlatih Akademi C# menggunakan kod praktikal yang dijalankan terus dalam pelayar, manakala tutor kecerdasan buatan 24/7 menjawab soalan anda semasa anda mengikuti pelajaran.

Adakah saya memerlukan pengalaman untuk memulakan Akademi C#?

Tiada pengalaman terdahulu diperlukan. Pembelajaran Akademi C# di CoddyKit disusun untuk pelajar daripada peringkat pemula hingga lanjutan, jadi anda boleh bermula di sini atau dari awal dan belajar mengikut kadar anda sendiri. Ini ialah pelajaran 1 daripada 4.

Berapa lamakah pelajaran “Pengesahan Anotasi Data” diambil?

Kebanyakan pelajaran CoddyKit mengambil masa kira-kira 5–10 minit. Setiap pelajaran ringkas dan interaktif, jadi anda boleh membuat kemajuan secara berterusan dan menyambung tepat dari tempat anda berhenti di web atau aplikasi.

Bolehkah saya menulis dan menjalankan kod dalam pelajaran Akademi C# ini?

Ya. Setiap pelajaran Akademi C# menyertakan penyunting kod terbina dalam, jadi anda boleh menulis dan menjalankan kod sebenar terus dalam pelayar serta menerima maklum balas kecerdasan buatan serta-merta — tanpa memerlukan persediaan setempat.

Semua pelajaran dalam kursus ini

← Kembali ke Akademi C#