---
title: "An réad ``Comhad ``"
version: 5.2
locale: ga
source: https://docs.djangoproject.com/ga/5.2/ref/files/file/
canonical: https://djangodocs.dev/ga/5.2/ref/files/file/
---
# An réad Comhad \`\`

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 `` ```

#### `class File(file_object, name=None)`

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`](#django.core.files.File) objects have the following attributes and methods:

#### `name`

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

#### `size`

Méid an chomhaid i mbetaí.

#### `file`

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

> **Bí cúramach leis an tréith seo i bhfo-aicmí.**
>
> Féadfaidh roinnt fo-aicmí de:class: File, lena n-áir:class: ~django.core.files.base.contentfile agus:class: ~django.db.models.fields.files.fieldfile, réad seachas réad Python:py:term: file 'in ionad an tréith seo. Sna cásanna seo, féadfaidh an tréith seo a: fo-aicme: “Comhad” a bheith ina bhfo-aicme (agus ní gá gurb é an fo-aicme céanna). Nuair is féidir, bain úsáid as tréithe agus modhanna an fho-aicme féin seachas tréithe tréithe “comhad” an fho-aicme.

#### `mode`

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

#### `open(mode=None, *args, **kwargs)`

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__()`

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

#### `chunks(chunk_size=None)`

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)`

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()`

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 `Contentfile`

#### `class ContentFile(content, name=None)`

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:

```
from django.core.files.base import ContentFile

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

## An rang `Imagefile`

#### `class ImageFile(file_object, name=None)`

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:

#### `width`

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

#### `height`

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

## Modhanna breise ar chomhaid atá ceangailte le rudaí

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)`

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:

```pycon
>>> car.photo.save("myphoto.jpg", content, save=False)
>>> car.save()
```

atá coibhéiseach le:

```pycon
>>> 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)`

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.