{"title":"Bailíochtóirí","version":"6.0","locale":"ga","docname":"ref/validators","url":"/ga/6.0/ref/validators/","canonical":"https://djangodocs.dev/ga/6.0/ref/validators/","summary":"Is bailíochtaire é bailíochtaire a ghlacann luach agus a ardaíonn a:exc: ~django.core.exceptions.validationError mura gcomhlíonann sé roinnt critéir.","html":"

BailíochtóiríLink to this heading#

\n
\n

Bailíthe scríbhneoireachtaLink to this heading#

\n

Is bailíochtaire é bailíochtaire a ghlacann luach agus a ardaíonn a:exc: ~django.core.exceptions.validationError mura gcomhlíonann sé roinnt critéir. Is féidir le bailíochtóirí a bheith úsáideach chun loighic bailíochtaithe a athúsáid idir cineálacha éagsúla réimsí

\n

Mar shampla, seo bailíochtóir nach gceadaíonn ach fionuimhreacha:

\n
Code
from django.core.exceptions import ValidationError\nfrom django.utils.translation import gettext_lazy as _\n\n\ndef validate_even(value):\n    if value % 2 != 0:\n        raise ValidationError(\n            _("%(value)s is not an even number"),\n            params={"value": value},\n        )\n
\n

Is féidir leat é seo a chur le réimse samhail tríd an argóint réimse d's:attr: ~Django.db.Models.Field.Validators:

\n
Code
from django.db import models\n\n\nclass MyModel(models.Model):\n    even_field = models.IntegerField(validators=[validate_even])\n
\n

Toisc go ndéantar luachanna a thiontú go Python sula ndéantar bailíochtóirí a reáchtáil, is féidir leat an bailíochtóir céanna a úsáid fiú le foirmeacha:

\n
Code
from django import forms\n\n\nclass MyForm(forms.Form):\n    even_field = forms.IntegerField(validators=[validate_even])\n
\n

Is féidir leat rang a úsáid freisin le modh ``__call__ () ``le haghaidh bailíochtóirí níos casta nó níos cumraithe. :class: RegExvalidator, úsáideann an teicníc seo mar shampla. <migration-serializing><custom-deconstruct-method>Má úsáidtear bailíochtóir rang-bhunaithe sa rogha réimse samhail: attr: ~django.db.Models.Field.Validators, ba cheart duit a chinntiú go bhfuil sé: ref: inseriálaithe ag an gcreat imirce `trí:ref: `deconstruct () agus ``__eq__ () `modhanna a chur leis.

\n
\n
\n

Conas a reáchtáiltear bailíochtóiríLink to this heading#

\n

</ref/forms/validation> <validating-objects>Féach an:doc: bailíochtú foirme le haghaidh tuilleadh eolais faoin gcaoi a reáchtáiltear bailíochtóirí i bhfoirmeacha, agus:ref: Rudaí bailíochtaithe `maidir le conas a reáchtáiltear iad i samhlacha. Tabhair faoi deara nach reáchtálfar bailíochtóirí go huathoibríoch nuair a shábhálann tú samhail, ach má tá a: class: `~django.forms.modelForm á úsáid agat, reáchtálfaidh sé do bhailíochtóirí ar aon réimsí atá san áireamh i d'fhoirm. Féach na:doc: Doiciméadú Modelfhoirme le haghaidh faisnéise maidir le conas a idirghníom</topics/forms/modelforms> haíonn bailíochtú samhail le foirmeacha.

\n
\n
\n

Bailíochtóirí tógthaLink to this heading#

\n

Tá bailiúchán bailíochtóirí inghlaonta sa mhodúl:MOD: `django.core.validators `le húsáid le réimsí samhail agus foirm. Úsáidtear iad go hinmheánach ach tá siad ar fáil le húsáid le do réimsí féin freisin. Is féidir iad a úsáid i dteannta modhanna saincheaptha ``field.clean () `nó in ionad modhanna saincheaptha.

\n
\n

RegExvalidatorLink to this heading#

\n
\n
\nclass RegexValidator(regex=None, message=None, code=None, inverse_match=None, flags=0)Link to this definition#
\n
\n
Paraiméadair:
\n
    \n

  • regex -- Mura bhfuil None, cuirfidh sé airí:attr: regex. Is féidir a bheith ina shreang abairt rialta nó ina léiriú rialta réamhthiomsaithe.

    • \n

  • message -- Mura bhfuil None, cuireann sé airí:attr: .message.

    • \n

  • code -- Mura bhfuil None, cuireann sé airí:attr: cód.

    • \n

  • inverse_match -- Mura bhfuil None, fhilleadh:attr: inverse_match.

    • \n

  • flags -- Mura bhfuil None, cuireann sé airí:attr: bratacha `. Sa chás sin, caithfidh :attr: `regex a bheith ina teaghrán abairt rialta, nó:exc: TypeError a ardaítear.

    • \n
\n
\n
\n

A: Aicme: Cuardach RegExvalidator ar an luach` a chuirtear ar fáil le haghaidh abairt rialta ar le:func: re.search. De réir réamhshocraithe, ardaíonn a:exc: ~django.core.exceptions.validationError le:attr: teachtaire agus:attr: code mura bhfaightear meaitseach****. Is féidir a iompar a inbhéartú trí shocrú: attr: inverse_match go True, sa chás sin ardaítear an:exc: ~django.core.exceptions.validationError nuair a aimsítear cluiche ****.

\n
\n
\nregexLink to this definition#
\n

An patrún abairt rialta le cuardach a dhéanamh laistigh den luach` a chuirtear ar fáil, ag baint úsáid:func: re.search. D'fhéadfadh sé seo a bheith ina shreang nó ina abairt rialta réamhthiomsaithe a cruthaíodh le:func: re.compile. Réamhshocraithe don teaghrán folamh, a bheidh le fáil i ngach luach féideartha.

\n
\n\n
\n
\nmessageLink to this definition#
\n

An teachtaireacht earráide a úsáideann ar:exc: ~django.core.exceptions.validationError má theipeann ar bhailíochtú. Réamhshocraithe go "Cuir isteach luach bailí".

\n
\n\n
\n
\ncodeLink to this definition#
\n

An cód earráide a úsáideann ar:exc: ~django.core.exceptions.validationError má theipeann ar bhailíochtú. Réamhshocraithe go "neamhbhailí".

\n
\n\n
\n
\ninverse_matchLink to this definition#
\n

An modh meaitseála le haghaidh: attr: regex. Réamhshocraithe go False.

\n
\n\n
\n
\nflagsLink to this definition#
\n

An bhrataí: ref: regex `a úsáidtear agus an teaghrán abairt ri <python:contents-of-module-re>alta á thiomsú: attr: `regex. Má tá: attr: abairt rialta réamh-thiomsaithe é regex, agus:attr: flags a shárú, :exc: TypeError ardaítear. Réamhshocraithe go 0.

\n
\n\n
\n\n
\n
\n

Bailíochtaitheoir ríomhphostLink to this heading#

\n
\n
\nclass EmailValidator(message=None, code=None, allowlist=None)Link to this definition#
\n
\n
Paraiméadair:
\n
    \n

  • message -- Mura bhfuil None, cuireann sé airí:attr: .message.

    • \n

  • code -- Mura bhfuil None, cuireann sé airí:attr: cód.

    • \n

  • allowlist -- Mura bhfuil None, cuirfidh sé airí:attr: liosta.

    • \n
\n
\n
\n

An EmailValidator ensures that a value looks like an email\naddress, and raises a ValidationError with\nmessage and code if it doesn't. Values longer than 320\ncharacters are always considered invalid.

\n
\n
\nmessageLink to this definition#
\n

An teachtaireacht earráide a úsáideann ar:exc: ~django.core.exceptions.validationError má theipeann ar bhailíochtú. Réamhshocraithe go "Cuir isteach seoladh ríomhphoist bailí".

\n
\n\n
\n
\ncodeLink to this definition#
\n

An cód earráide a úsáideann ar:exc: ~django.core.exceptions.validationError má theipeann ar bhailíochtú. Réamhshocraithe go "neamhbhailí".

\n
\n\n
\n
\nallowlistLink to this definition#
\n

Liosta de na bhfearann ríomhphoist. De réir réamhshocraithe, úsáidtear abairt rialta (an tréith domain_regex) chun gach rud atá le feiceáil tar éis an chomhartha @ a bhailíochtú. Mar sin féin, má tá an sreang sin le feiceáil sa liosta ceada, seachtar an bailíochtú seo. Mura gcuirtear ar fáil, is é “['localhost'] an réamhshocraithe ``liosta. Ní rachaidh fearainn eile nach bhfuil ponc iontu bailíochtú, mar sin bheadh ort iad a chur leis an liosta ceada` de réir mar is gá.

\n
\n\n
\n\n
\n
\n

DomainmValidatorLink to this heading#

\n
\n
\nclass DomainNameValidator(accept_idna=True, message=None, code=None)Link to this definition#
\n

A: aicme: fo-aicme RegexValidator a chinntíonn go bhfuil cuma luach cosúil le ainm fearainn. Meastar go bhfuil luachanna níos faide ná 255 carachtar neamhbhailí i gcó Ní ghlactar le seoltaí IP mar ainmneacha fearainn bailí.

\n

Chomh maith le hargóintí roghnacha a thuismitheoir:class: rang RegExvalidator, glacann DomainNameValidator le tréith roghnach breise:

\n
\n
\naccept_idnaLink to this definition#
\n

Cinneann sé an nglactar le hainmneacha fearainn idirnáisiúnta, is é sin, ainmneacha fearainn ina bhfuil carachtair neamh-ASCII. Réamhshocraithe go True.

\n
\n\n
\n\n
\n
\n

UrlValidatorLink to this heading#

\n
\n
\nclass URLValidator(schemes=None, regex=None, message=None, code=None)Link to this definition#
\n

A: aicme: fo-aicme RegexValidator a chinntíonn go bhfuil cuma URL ar luach, agus a ardaíonn cód earráide 'invalid' mura ndéanann sé. Meastar go bhfuil luachanna níos faide ná: attr: `max_length `carachtair neamhbhailí i gcónaí.

\n

Meastar go bhfuil seoltaí loopback agus spásanna IP curtha in áirithe bailí. Tacaítear le seoltaí litriúla IPv6 (:rfc: 3986 #section -3.2.2) agus fearainn Unicode araon.

\n

Chomh maith le hargóintí roghnacha a thuismitheoir:class: rang RegExvalidator, glacann URLValidator le tréith roghnach breise:

\n
\n
\nschemesLink to this definition#
\n

Liosta scéime URL/URI le bailíochtú ina choinne. Mura gcuirtear ar fáil, is é an liosta réamhshocraithe ['http', 'https', 'ftp', 'ftps']. Mar thagairt, soláthraíonn láithreán gréasáin IANA liosta iomlán de `scéimeanna bailí URI `_.

\n\n
\n\n
\n
\nmax_lengthLink to this definition#
\n

An fad uasta na luachanna a d'fhéadfaí a mheas bailí. Réamhshocraithe go 2048 carachtar.

\n
\n\n
\n\n
\n
\n

ríomhphost_bailíochtaLink to this heading#

\n
\n
\nvalidate_emailLink to this definition#
\n

An:class: EmailValidator sampla gan aon saincheaptha.

\n
\n\n
\n
\n

ainm_fearainn bailaiteLink to this heading#

\n
\n
\nvalidate_domain_nameLink to this definition#
\n

A: Class: DomainNameValidator sampla gan aon saincheaptha.

\n
\n\n
\n
\n

bailate_slugLink to this heading#

\n
\n
\nvalidate_slugLink to this definition#
\n

A: Aicme: Sampla RegExValidator a chinntíonn go bhfuil luach nach bhfuil ach litreacha, uimhreacha, béim nó braithíní.

\n
\n\n
\n
\n

bailate_unicode_slugLink to this heading#

\n
\n
\nvalidate_unicode_slugLink to this definition#
\n

A: Aicme: Sampla RegExvalidator a chinntíonn go bhfuil luach nach bhfuil ach litreacha, uimhreacha, béim nó braithíní Unicode.

\n
\n\n
\n
\n

``bailate_ipv4_address ``Link to this heading#

\n
\n
\nvalidate_ipv4_addressLink to this definition#
\n

A: aicme: Sampla RegExValidator a chinntíonn go bhfuil cuma luach cosúil le seoladh IPv4.

\n
\n\n
\n
\n

``bailate_ipv6_address ``Link to this heading#

\n
\n
\nvalidate_ipv6_addressLink to this definition#
\n

Úsáideann sé django.utils.ipv6 chun bailíocht seoladh IPv6 a sheiceáil.

\n
\n\n
\n
\n

``bailate_ipv46_address ``Link to this heading#

\n
\n
\nvalidate_ipv46_addressLink to this definition#
\n

Úsáideann sé validate_ipv4_address ``agus ``validate_ipv6_address araon chun a chinntiú gur seoladh bailí IPv4 nó IPv6 é luach.

\n
\n\n
\n
\n

liosta_coma_iomlán bailíochtaí_scarthaLink to this heading#

\n
\n
\nvalidate_comma_separated_integer_listLink to this definition#
\n

A: aicme: “RegExValidator” a chinntíonn go bhfuil luach ná liosta de shláimhreacha scartha le camóg.

\n
\n\n
\n
\n

int_liost_bailíochtarLink to this heading#

\n
\n
\nint_list_validator(sep=',', message=None, code='invalid', allow_negative=False)Link to this definition#
\n

Tuairisceáin a:class: RegExValidator sampla a chinntíonn go bhfuil sreang comhdhéanta de shlánuimhreacha atá scartha le sep. Ceadaíonn sé sláimhreacha diúltacha nuair a bhíonn allow_negative` True.

\n
\n\n
\n
\n

MaxValueValidatorLink to this heading#

\n
\n
\nclass MaxValueValidator(limit_value, message=None)Link to this definition#
\n

Ardaíonn a:exc: ~django.core.exceptions.validationError le cód `'max_value'` má tá ``lua níos mó ná limit_value, a d'fhéadfadh a bheith inghlaonta.

\n
\n\n
\n
\n

MinvaluevalidatorLink to this heading#

\n
\n
\nclass MinValueValidator(limit_value, message=None)Link to this definition#
\n

Ardaíonn a:exc: ~django.core.exceptions.validationError le cód `min_value'` má tá ``lua níos lú ná limit_value, a d'fhéadfadh a bheith inghlaonta.

\n
\n\n
\n
\n

MaxLengthValidatorLink to this heading#

\n
\n
\nclass MaxLengthValidator(limit_value, message=None)Link to this definition#
\n

Ardaíonn a:exc: ~django.core.exceptions.validationError le cód `'max_long' má tá fad value níos mó ná limit_value, a d'fhéadfadh a bheith inghlaonta.

\n
\n\n
\n
\n

MinLengthValidatorLink to this heading#

\n
\n
\nclass MinLengthValidator(limit_value, message=None)Link to this definition#
\n

Ardaíonn a:exc: ~django.core.exceptions.validationError le cód `min_long má tá fad value níos lú ná limit_value, a d'fhéadfadh a bheith inghlaonta.

\n
\n\n
\n
\n

DeimalValidatorLink to this heading#

\n
\n
\nclass DecimalValidator(max_digits, decimal_places)Link to this definition#
\n

Ardaithe:exc: ~django.core.exceptions.validationError leis na cóid seo a leanas:

\n
    \n

  • `'max_digits' má tá líon na ndigit níos mó ná max_digits.

    • \n

  • ``max_decimal_places' má tá líon na ndeachmhálacha níos mó ná deach_places.

    • \n

  • `'max_whole_digits' má tá líon na ndigit iomlána níos mó ná an difríocht idir max_digits agus deach_places.

    • \n
\n
\n\n
\n
\n

FileExtensionValidatorLink to this heading#

\n
\n
\nclass FileExtensionValidator(allowed_extensions, message, code)Link to this definition#
\n

Ardaíonn a:exc: ~django.core.exceptions.validationError le cód `invalid_extension' mura bhfaightear síneadh value.name (value a:class: ~django.core.files.file) i allowed_extensions`. Déantar an síneadh a chur i gcomparáid go cás-neamhíogair le allowed_extensions.

\n\n
\n\n
\n
\n

validate_image_file_extensionLink to this heading#

\n
\n
\nvalidate_image_file_extensionLink to this definition#
\n

Uses Pillow to ensure that value.name (value is a\nFile) has a valid image extension.

\n
\n\n
\n
\n

ProhibitNullCharactersValidatorLink to this heading#

\n
\n
\nclass ProhibitNullCharactersValidator(message=None, code=None)Link to this definition#
\n

Ardaíonn a:exc: ~django.core.exceptions.validationError má tá carachtar null amháin nó níos mó sa str (value) ``(`'\\ x00').

\n
\n
Paraiméadair:
\n
    \n

  • message -- Mura bhfuil None, cuireann sé airí:attr: .message.

    • \n

  • code -- Mura bhfuil None, cuireann sé airí:attr: cód.

    • \n
\n
\n
\n
\n
\nmessageLink to this definition#
\n

An teachtaireacht earráide a úsáideann ar:exc: ~django.core.exceptions.validationError má theipeann ar bhailíochtú. Ní cheadaítear réamhshocraithe go ``"carachtair neall.” ``.

\n
\n\n
\n
\ncodeLink to this definition#
\n

An cód earráide a úsáideann ar:exc: ~django.core.exceptions.validationError má theipeann ar bhailíochtú. Réamhshocraithe go "null_caràcters_not_allowed".

\n
\n\n
\n\n
\n
\n

StepValueValidatorLink to this heading#

\n
\n
\nclass StepValueValidator(limit_value, message=None, offset=None)Link to this definition#
\n

Ardaíonn a:exc: ~django.core.exceptions.validationError le cód `step_size'` mura bhfuil `value iolrach dhílis de limit_value`, is féidir a bheith ina luach snámhphointe, sláimhir nó deachúil nó inghlaoch. Nuair a shocraítear offset, tarlaíonn an bailíochtú i gcoinne limit_value móide offset. Mar shampla, i gcás StepValueValidator (3, offset = 1.4) ``tá luachanna bailí ```1.4, 4.4`, 7.4`, 10.4`, agus mar sin de.

\n
\n\n
\n
","rootId":"module-django.core.validators","toc":[{"title":"Bailíthe scríbhneoireachta","anchor":"writing-validators","children":[]},{"title":"Conas a reáchtáiltear bailíochtóirí","anchor":"how-validators-are-run","children":[]},{"title":"Bailíochtóirí tógtha","anchor":"built-in-validators","children":[{"title":"RegExvalidator","anchor":"regexvalidator","children":[]},{"title":"Bailíochtaitheoir ríomhphost","anchor":"emailvalidator","children":[]},{"title":"DomainmValidator","anchor":"domainnamevalidator","children":[]},{"title":"UrlValidator","anchor":"urlvalidator","children":[]},{"title":"ríomhphost_bailíochta","anchor":"validate-email","children":[]},{"title":"ainm_fearainn bailaite","anchor":"validate-domain-name","children":[]},{"title":"bailate_slug","anchor":"validate-slug","children":[]},{"title":"bailate_unicode_slug","anchor":"validate-unicode-slug","children":[]},{"title":"``bailate_ipv4_address ``","anchor":"validate-ipv4-address","children":[]},{"title":"``bailate_ipv6_address ``","anchor":"validate-ipv6-address","children":[]},{"title":"``bailate_ipv46_address ``","anchor":"validate-ipv46-address","children":[]},{"title":"liosta_coma_iomlán bailíochtaí_scartha","anchor":"validate-comma-separated-integer-list","children":[]},{"title":"int_liost_bailíochtar","anchor":"int-list-validator","children":[]},{"title":"MaxValueValidator","anchor":"maxvaluevalidator","children":[]},{"title":"Minvaluevalidator","anchor":"minvaluevalidator","children":[]},{"title":"MaxLengthValidator","anchor":"maxlengthvalidator","children":[]},{"title":"MinLengthValidator","anchor":"minlengthvalidator","children":[]},{"title":"DeimalValidator","anchor":"decimalvalidator","children":[]},{"title":"FileExtensionValidator","anchor":"fileextensionvalidator","children":[]},{"title":"validate_image_file_extension","anchor":"validate-image-file-extension","children":[]},{"title":"ProhibitNullCharactersValidator","anchor":"prohibitnullcharactersvalidator","children":[]},{"title":"StepValueValidator","anchor":"stepvaluevalidator","children":[]}]}],"breadcrumbs":[{"docname":"ref/index","title":"Tagairt API","url":"/ga/6.0/ref/"}],"prev":{"docname":"ref/utils","title":"Úsáideacha Django","url":"/ga/6.0/ref/utils/"},"next":{"docname":"ref/views","title":"Radhairc Tógtha","url":"/ga/6.0/ref/views/"},"formats":{"html":"/ga/6.0/ref/validators/","markdown":"/ga/6.0/ref/validators.md","json":"/ga/6.0/ref/validators.json"},"source":"https://github.com/django/django/blob/stable/6.0.x/docs/ref/validators.txt","official":"https://docs.djangoproject.com/ga/6.0/ref/validators/","inVersions":["6.1","6.0","5.2"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}