{"title":"Comhaid Uaslódála agus Láimhseálaithe","version":"6.0","locale":"ga","docname":"ref/files/uploads","url":"/ga/6.0/ref/files/uploads/","canonical":"https://djangodocs.dev/ga/6.0/ref/files/uploads/","summary":"Le linn uaslódála comhaid, stóráiltear na sonraí comhaid iarbhír in:attr: request.files `.","html":"

Comhaid Uaslódála agus LáimhseálaitheLink to this heading#

\n
\n

comhaid uaslódáilLink to this heading#

\n
\n
\nclass UploadedFileLink to this definition#
\n
\n\n

<django.http.HttpRequest.FILES>Le linn uaslódála comhaid, stóráiltear na sonraí comhaid iarbhír in:attr: request.files `. Is réad ``Uploadedfile` (nó fo-aicme) é gach iontráil sa fhoclóir seo - fillteán timpeall comhad uaslódáilte. De ghnáth úsáidfidh tú ceann de na modhanna seo chun rochtain a fháil ar an ábhar uaslódáil

\n
\n
\nUploadedFile.read()Link to this definition#
\n

Léigh na sonraí uaslódáilte iomlána ón gcomhad. Bí cúramach leis an modh seo: má tá an comhad uaslódáilte ollmhór féadfaidh sé do chóras a shárú má dhéanann tú iarracht é a léamh isteach i gcuimhne. Is dócha go mbeidh tú ag iarraidh ``chunks () ``a úsáid ina ionad; féach thíos.

\n
\n\n
\n
\nUploadedFile.multiple_chunks(chunk_size=None)Link to this definition#
\n

Tugann sé ar ais True má tá an comhad uaslódáilte mór go leor chun go mbeidh léamh ag teastáil i gcodanna iolracha. De réir réamhshocraithe beidh sé seo aon chomhad níos mó ná 2.5 meigabyte, ach tá sé sin inchumraithe; féach thíos.

\n
\n\n
\n
\nUploadedFile.chunks(chunk_size=None)Link to this definition#
\n

Gineadóir ag filleadh codanna den chomhad. Más é `multiple_chunks () ```True, ba chóir duit an modh seo a úsáid i lúb in ionad read ().

\n

Go praiticiúil, is minic a bhíonn sé níos éasca `chunks () ``a úsáid an t-am ar fad. Cinntíonn lupáil thar ``chunks () ``in ionad ``read () a úsáid nach gcuireann comhaid mhóra cuimhne do chórais a shárú.

\n
\n\n

Seo roinnt tréithe úsáideacha de uploadedfile:

\n
\n
\nUploadedFile.nameLink to this definition#
\n

Ainm an chomhaid uaslódáilte (m.sh. my_file.txt).

\n
\n\n
\n
\nUploadedFile.sizeLink to this definition#
\n

Méid, i mbeátaí, an chomhaid uaslódáilte.

\n
\n\n
\n
\nUploadedFile.content_typeLink to this definition#
\n

An ceannteideal cineál ábhair a uaslódáil leis an gcomhad (m.sh.: mimetype: text/plain nó: mimetype: application/pdf). Cosúil le haon sonraí a sholáthraíonn an t-úsáideoir, níor chóir duit muinín a bheith agat gurb é an comhad uaslódáilte an cineál seo Beidh ort fós a bhailíochtú go bhfuil an t-ábhar a éilíonn an ceannteideal de chineál ábhair sa chomhad - “muinín a bheith agat ach fíoraigh.”

\n
\n\n
\n
\nUploadedFile.content_type_extraLink to this definition#
\n

Foclóir ina bhfuil paraiméadair bhreise curtha ar aghaidh chuig an gceannteideal ``cineál-ábhair ``. Is gnách go soláthraíonn seirbhísí seo, mar shampla Google App Engine, a chuireann uaslódálacha comhad a thar do cheann a idirghabháil agus a láimhseáil. <2388 #section -5.3>Mar thoradh air sin b'fhéidir nach bhfaighidh do láimhseálaí an t-ábhar comhad uaslódáilte, ach ina ionad sin URL nó pointeoir eile chuig an gcomhad (féach: rfc: RFC 2388).

\n
\n\n
\n
\nUploadedFile.charsetLink to this definition#
\n

Maidir le: mimetype: téacs/* cineálacha ábhair, an tacar carachtair (ie utf8) a sholáthraíonn an brabhsálaí. Arís, is é “muinín ach fíorú” an beartas is fearr anseo.

\n
\n\n\n

I measc na bhfo-aicmí de Uploadedfile` tá:

\n
\n
\nclass TemporaryUploadedFileLink to this definition#
\n

Comhad a uaslódáil chuig suíomh sealadach (ie sruth-go-diosca). Úsáideann an rang seo ag an: class: ~django.core.files.uploadHandler.TemporaryFileUploadHandler. Chomh maith leis na modhanna ó:class: uploadedFile, tá modh breise amháin aige:

\n
\n\n
\n
\nTemporaryUploadedFile.temporary_file_path()Link to this definition#
\n

Tugann sé an cosán iomlán ar ais chuig an gcomhad uaslódáilte

\n
\n\n
\n
\nclass InMemoryUploadedFileLink to this definition#
\n

Comhad a uaslódáiltear i gcuimhne (ie sruth-chuimhne). Úsáideann an rang seo ag an: class: ~django.core.files.uploadHandler.MemoryFileUploadHandler.

\n
\n\n
\n
\n

Láimhseálaithe uaslódálaLink to this heading#

\n

Le chéile soláthraíonn an:class: MemoryFileUploadHandler agus:class: TemporaryFileUploadHandler iompar uaslódála comhaid réamhshocraithe Django maidir le comhaid bheaga a léamh isteach i gcuimhne agus cinn mhóra ar an diosca. Tá siad suite i django.core.files.uploadhandler.

\n
\n
\nclass MemoryFileUploadHandlerLink to this definition#
\n
\n\n

Láimhseálaí uaslódála comhad chun uaslódálacha a shruthú isteach i gcuimhne (úsáidtear le haghaidh comh

\n
\n
\nclass TemporaryFileUploadHandlerLink to this definition#
\n
\n\n

Uaslódáil láimhseálaí a sruthaíonn sonraí isteach i gcomhad sealadach ag baint úsáid:class: ~django.core.files.uploadedfile.temporaryUploadedFile.

\n
\n
\n

Láimhseálaithe uaslódáil saincheapthaLink to this heading#

\n
\n
\nclass FileUploadHandlerLink to this definition#
\n
\n\n

Ba chóir go mbeadh fo-aicmí de Django.Core.Files.uploadHandler.FileUploadHandler i ngach láimhseálaí uaslódála comhad. Féadfaidh tú láimhseálaithe uaslódála a shainiú cibé áit

\n
\n

Modhanna riachtanachaLink to this heading#

\n

Ní mór do láimhseálaithe uaslódála comhad saincheaptaí** na modhanna seo a leanas a

\n
\n
\nFileUploadHandler.receive_data_chunk(raw_data, start)Link to this definition#
\n

Faigheann sé “píosa” sonraí ón uaslódáil comhad.

\n

Is bytestring é raw_data ina bhfuil na sonraí uaslódáilte.

\n

Is é start an suíomh sa chomhad ina dtosaíonn an chuid raw_data seo.

\n

Cuirfear na sonraí a chuireann tú ar ais isteach sna modhanna ``receive_data_chunk ``láimhseálaithe uaslódála ina dhiaidh sin. Ar an mbealach seo, is féidir le láimhseálaí amháin a bheith ina “scagaire” do láimhseálaithe eile.

\n

Fill None ó receive_data_chunk` chuig láimhseálaithe uaslódála gearrchiorcad atá fágtha ó an píosa seo a fháil. Tá sé seo úsáideach má tá na sonraí uaslódáilte á stóráil agat féin agus mura dteastaíonn uait go ndéanfaidh láimhseálaithe sa todhchaí cóip de na sonraí a

\n

Má ardaíonn tú eisceacht StopUpload nó Skipfile`, cuirfear deireadh leis an uaslódáil nó scipeánfar an comhad go hiomlán.

\n
\n\n
\n
\nFileUploadHandler.file_complete(file_size)Link to this definition#
\n

Glaoigh nuair a bheidh comhad críochnaithe ag uaslódáil.

\n

Ba chóir don láimhseálaí réad uploadedFile a chur ar ais a stóráilfear in Request.Files. Féadfaidh láimhseálaithe None ``a thabhairt ar ais freisin chun a léiriú gur chóir go dtiocfadh an réad ``Uploadedfile ó láimhseálaithe uaslódála ina dhiaidh sin.

\n
\n\n
\n
\n

Modhanna roghnachaLink to this heading#

\n

Féadfaidh láimhseálaithe uaslódála saincheaptha aon cheann de na modhanna nó tréithe roghnacha seo a leanas

\n
\n
\nFileUploadHandler.chunk_sizeLink to this definition#
\n

Méid, i mbeátaí, de na “píosaí” ba chóir do Django a stóráil i gcuimhne agus a bheathú isteach sa láimhseálaí. Is é sin, rialaíonn an tréith seo méid na gcodanna a chuirtear isteach i FileUploadHandler.Receive_Data_Chunk.

\n

Le haghaidh an fheidhmíochta is mó ba chóir go mbeadh méideanna na píosa inroinnte le 4 agus níor cheart go mbeadh méid níos mó ná 2 GB (2:sup: 31 bytes). Nuair a bhíonn ilmhéideanna píosa ar fáil ag láimhseálaithe iolracha, úsáidfidh Django an méid píosa is lú a shainmhíníonn aon láimhseálaí.

\n

Is é an réamhshocrú 64* 2:sup: 10 bytes, nó 64 KB.

\n
\n\n
\n
\nFileUploadHandler.new_file(field_name, file_name, content_type, content_length, charset, content_type_extra)Link to this definition#
\n

Aisghlaonna ag comharthaíocht go bhfuil uaslódáil comhaid nua ag tosú. Tugtar air seo sula gcuirtear aon sonraí a bheathú d'aon láimhseálaithe uaslódála.

\n

<input>Is ainm teaghrán é field_name réimse an chomhaid ```.

\n

Is é file_name an t-ainm comhaid a sholáthraíonn an brabhsálaí.

\n

Is é content_type an cineál MIME a sholáthraíonn an brabhsálaí -- m.sh. ``íomha/jpeg'.

\n

Is é `content_length ``fad na híomhá a thugann an brabhsálaí. Uaireanta ní chuirfear é seo ar fáil agus beidh sé “None”.

\n

Is é charset an tacar carachtair (ie utf8) a thugann an brabhsálaí. Cosúil le content_length `, ní chuirfear é seo ar fáil uaireanta.

\n

Is faisnéis bhreise é content_type_extra faoin gcomhad ón gceannteideal content-type. <django.core.files.uploadedfile.UploadedFile.content_type_extra>Féach: attr: `Uploadedfile.content_type_extra `.

\n

Féadfaidh an modh seo eisceacht ``StopFutureHandlers `a ardú chun cosc a chur ar láimhseálaithe sa todhchaí an comhad seo a láimhseáil.

\n
\n\n
\n
\nFileUploadHandler.upload_complete()Link to this definition#
\n

Comharthaíonn glaoch ar ais go bhfuil an t-uaslódáil iomlán (gach comhad) críochnaithe.

\n
\n\n
\n
\nFileUploadHandler.upload_interrupted()Link to this definition#
\n

Aisghlaonna a chomharthaíonn gur cuireadh isteach ar an uaslódáil, m.sh. nuair a dhún an t-úsáideoir a bhrabhsálaí

\n
\n\n
\n
\nFileUploadHandler.handle_raw_input(input_data, META, content_length, boundary, encoding)Link to this definition#
\n

Ligeann sé don láimhseálaí parsáil an ionchuir amh HTTP a shárú go hiomlán.

\n

Is réad cosúil le comhad é input_data a thacaíonn le read () ``-ing.

\n

Is é META an réad céanna le request.meta.

\n

Is é content_length ``fad na sonraí in ``input_data. Ná léigh níos mó ná baite content_length ``ó ``input_data.

\n

Is é teorainne an teorainn MIME don iarratas seo.

\n

Is é “ionchódú” ionchódú an iarratais.

\n

Tabhair ar ais None más mian leat leanúint ar aghaidh le láimhseáil uaslódála, nó tuple (POST, FILES) más mian leat na struchtúir sonraí nua atá oiriúnach don iarraidh a thabhairt ar ais go díreach.

\n
\n\n
\n
","rootId":"module-django.core.files.uploadedfile","toc":[{"title":"comhaid uaslódáil","anchor":"uploaded-files","children":[]},{"title":"Láimhseálaithe uaslódála","anchor":"module-django.core.files.uploadhandler","children":[]},{"title":"Láimhseálaithe uaslódáil saincheaptha","anchor":"writing-custom-upload-handlers","children":[{"title":"Modhanna riachtanacha","anchor":"required-methods","children":[]},{"title":"Modhanna roghnacha","anchor":"optional-methods","children":[]}]}],"breadcrumbs":[{"docname":"ref/index","title":"Tagairt API","url":"/ga/6.0/ref/"},{"docname":"ref/files/index","title":"Láimhseáil comhad","url":"/ga/6.0/ref/files/"}],"prev":{"docname":"ref/files/storage","title":"API stórála comhad","url":"/ga/6.0/ref/files/storage/"},"next":{"docname":"ref/forms/index","title":"Foirmeacha","url":"/ga/6.0/ref/forms/"},"formats":{"html":"/ga/6.0/ref/files/uploads/","markdown":"/ga/6.0/ref/files/uploads.md","json":"/ga/6.0/ref/files/uploads.json"},"source":"https://github.com/django/django/blob/stable/6.0.x/docs/ref/files/uploads.txt","official":"https://docs.djangoproject.com/ga/6.0/ref/files/uploads/","inVersions":["6.1","6.0","5.2"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}