---
title: "An réad ``Comhad ``"
version: 6.1
locale: ga
source: https://docs.djangoproject.com/ga/6.1/ref/files/file/
canonical: https://djangodocs.dev/ga/6.1/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)`

The [`File`](#django.core.files.File) class is a thin wrapper around a Python
[file object](https://docs.python.org/3/glossary.html#term-file-object) with some Django-specific additions.
Internally, Django uses this class when it needs to represent a file.

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

The underlying [file object](https://docs.python.org/3/glossary.html#term-file-object) that this class wraps.

> **Bí cúramach leis an tréith seo i bhfo-aicmí.**
>
> Some subclasses of [`File`](#django.core.files.File), including
> [`ContentFile`](#django.core.files.base.ContentFile) and
> [`FieldFile`](/ga/6.1/ref/models/fields/#django.db.models.fields.files.FieldFile), may replace this
> attribute with an object other than a Python [file
> object](https://docs.python.org/3/glossary.html#term-file-object). In these cases, this attribute may itself be a
> [`File`](#django.core.files.File) subclass (and not necessarily the same subclass).
> Whenever possible, use the attributes and methods of the subclass
> itself rather than those of the subclass's `file` attribute.

#### `mode`

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

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

Open or reopen the file (which also does `File.seek(0)`).
The `mode` argument allows the same values
as Python's built-in [`open()`](https://docs.python.org/3/library/functions.html#open). `*args` and `**kwargs`
are passed after `mode` to Python's built-in [`open()`](https://docs.python.org/3/library/functions.html#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.