An réad ``Comhad ``Link to this heading

Tá ranganna ionsuite sa mhodúl:MOD: django.core.files agus a fho-mhodúil le haghaidh láimhseáil comhaid bunúsach i Django.

An rang Comhad ``Link to this heading

class File(file_object, name=None)Link to this definition

Is fillteán tanaí é an rang:class: File timpeall Python: Py:term: réad comhad le roinnt breiseanna sonracha Django. Go hinmheánach, úsáideann Django an rang seo nuair is gá dó comhad a léiriú.

File objects have the following attributes and methods:

nameLink to this definition

Ainm an chomhaid lena n-áirítear an cosán coibhneasta ó:setting: MEDIA_ROOT.

sizeLink to this definition

Méid an chomhaid i mbetaí.

fileLink to this definition

An bunús:py:term: réad comhad a fhilleann an rang seo.

modeLink to this definition

An modh léithe/scríbhneoireachta don chomhad.

open(mode=None, *args, **kwargs)Link to this definition

Oscail nó athoscail an comhad (a dhéanann freisin File.seek (0) ``). Ceadaíonn an argóint ``mod na luachanna céanna le Python ion:func: python:open () `. Cuirtear ``*args` agus **kwargs tar éis mode chuig Python ionsuite: func: python:open.

Agus comhad á athoscailt, déanfaidh mod` athoscailt cibé modh a osclaíodh an comhad leis ar dtús; ciallaíonn ``None ``athoscailt leis an modh bunaidh.

Is féidir é a úsáid mar bhainisteoir comhthéacs, m.sh. with file.open () mar f: `.

__iter__()Link to this definition

Athraigh thar an gcomhad ag tabhairt líne amháin ag an am.

chunks(chunk_size=None)Link to this definition

Athraigh thar an gcomhad ag tabhairt “píosaí” de mhéid ar leith. Tá chunk_size réamhshocraithe go 64 KB.

Tá sé seo úsáideach go háirithe le comhaid an-mhóra ós rud é go gceadaíonn sé iad a shruthú as diosca agus seachnaíonn sé an comhad iomlán a stóráil i gcuimhne.

multiple_chunks(chunk_size=None)Link to this definition

Tugann tuairisceáin True má tá an comhad mór go leor chun go dteastaíonn go leor píosaí chun rochtain a fháil ar a ábhar go léir, tugann roinnt chunk_size.

close()Link to this definition

Dún an comhad.

Chomh maith leis na modhanna liostaithe, nochtann :class: ~django.core.files.file na tréithe agus na modhanna seo a leanas dá réad comhad ``: `encoding, fileno`, flush, isatty`, newlines`, readin`, read `line` , `línte léite`, cuarda`, insint`, truncate`, scríbhneoireach`, scríbhneoireannaithe`, inléite () `, inscríofa ()`, agus ``cuardaitheach () ``.

An rang ContentfileLink to this heading

class ContentFile(content, name=None)Link to this definition

Tá an rang ContentFile oidhreacht ó:class: ~django.core.files.file, ach ní cosúil:class: ~django.core.files.file oibríonn sé ar ábhar teaghrán (tacaíonn béite freisin), seachas comhad iarbhír. Mar shampla:

Code
from django.core.files.base import ContentFile

f1 = ContentFile("esta frase está en español")
f2 = ContentFile(b"these are bytes")

An rang ImagefileLink to this heading

class ImageFile(file_object, name=None)Link to this definition

Soláthraíonn Django rang ionsuite go sonrach le haghaidh íomhánna. :class: Django.Core.Files.Images.ImageFile oidhreacht na tréithe agus na modhanna uile de:class: ~django.core.files.file, agus soláthraíonn sé an méid seo a leanas freisin:

widthLink to this definition

Leithead na híomhá i bpicteilíní.

heightLink to this definition

Airde na híomhá i bpicteilíní.

Modhanna breise ar chomhaid atá ceangailte le rudaíLink to this heading

Aon: Class: Beidh cúpla modh breise ag Comhad a bhaineann le réad (mar atá le Car.photo, thíos) freisin:

File.save(name, content, save=True)Link to this definition

Sábhálann comhad nua leis an ainm comhaid agus an t-ábhar a chuirtear ar fáil. Ní chuirfidh sé seo in ionad an comhad atá ann cheana, ach cruthóidh sé comhad nua agus nuashonróidh sé an réad chun cur in iúl dó. Más é `Save True`, glaofar modh save () `` an tsamhail nuair a shábháiltear an comhad. Is é sin, an dá líne seo:

Python console
>>> car.photo.save("myphoto.jpg", content, save=False)
>>> car.save()

atá coibhéiseach le:

Python console
>>> car.photo.save("myphoto.jpg", content, save=True)

Tabhair faoi deara go gcaithfidh an argóint content a bheith ina shampla de: :class: File nó de fho-aicme de:class: File, mar shampla:class: ~django.core.files.base.contentfile.

File.delete(save=True)Link to this definition

Baineann sé an comhad ón samhail samhail agus scriosann sé an comhad bunúsach. Más é `Save True`, glaofar modh save () `` an tsamhail nuair a scriosfar an comhad.