Pero hay varios casos en los que podrías beneficiarte de usar `UploadFile`.

## Parámetros de Archivo con `UploadFile` { #file-parameters-with-uploadfile }

Define un parámetro de archivo con un tipo de `UploadFile`:

{* ../../docs_src/request_files/tutorial001_an_py310.py hl[14] *}

Usar `UploadFile` tiene varias ventajas sobre `bytes`:

如果把*路径操作函数*参数的类型声明为 `bytes`，**FastAPI** 会为你读取文件，并以 `bytes` 的形式接收其内容。

请注意，这意味着整个内容会存储在内存中，适用于小型文件。

不过，在很多情况下，使用 `UploadFile` 会更有优势。

## 含 `UploadFile` 的文件参数 { #file-parameters-with-uploadfile }

将文件参数的类型声明为 `UploadFile`：

{* ../../docs_src/request_files/tutorial001_an_py310.py hl[14] *}

与 `bytes` 相比，使用 `UploadFile` 有多项优势：

* 无需在参数的默认值中使用 `File()`。
* 它使用“spooled”文件：
    * 文件会先存储在内存中，直到达到最大上限，超过该上限后会写入磁盘。

Mas há muitos casos em que você pode se beneficiar do uso de `UploadFile`.

## Parâmetros de Arquivo com `UploadFile` { #file-parameters-with-uploadfile }

Defina um parâmetro de arquivo com um tipo de `UploadFile`:

{* ../../docs_src/request_files/tutorial001_an_py310.py hl[14] *}

Utilizar `UploadFile` tem várias vantagens sobre `bytes`:

如果你將路徑操作函式（path operation function）的參數型別宣告為 `bytes`，**FastAPI** 會替你讀取檔案，你會以 `bytes` 取得內容。

請注意，這表示整個內容會存放在記憶體中，適合小檔案。

但在許多情況下，使用 `UploadFile` 會更好。

## 使用 `UploadFile` 的檔案參數 { #file-parameters-with-uploadfile }

將檔案參數型別設為 `UploadFile`：

{* ../../docs_src/request_files/tutorial001_an_py310.py hl[14] *}

使用 `UploadFile` 相較於 `bytes` 有數個優點：

* 你不必在參數的預設值使用 `File()`。
* 它使用「spooled」檔案：
    * 檔案在記憶體中保存到某個大小上限，超過上限後會存到磁碟。

Ancak bazı durumlarda `UploadFile` kullanmak size fayda sağlayabilir.

## `UploadFile` ile Dosya Parametreleri { #file-parameters-with-uploadfile }

Tipi `UploadFile` olan bir dosya parametresi tanımlayın:

{* ../../docs_src/request_files/tutorial001_an_py310.py hl[14] *}

`UploadFile` kullanmanın `bytes`’a göre birkaç avantajı vardır:

Однако возможны случаи, когда использование `UploadFile` может оказаться полезным.

## Параметры файла с `UploadFile` { #file-parameters-with-uploadfile }

Определите параметр файла с типом `UploadFile`:

{* ../../docs_src/request_files/tutorial001_an_py310.py hl[14] *}

Использование `UploadFile` имеет ряд преимуществ перед `bytes`:

이것은 전체 내용이 메모리에 저장된다는 것을 의미한다는 걸 염두하기 바랍니다. 이는 작은 크기의 파일들에 적합합니다.

어떤 경우에는 `UploadFile` 을 사용하는 것이 더 유리합니다.

## `UploadFile`을 사용하는 `File` 매개변수 { #file-parameters-with-uploadfile }

`File` 매개변수를 `UploadFile` 타입으로 정의합니다:

{* ../../docs_src/request_files/tutorial001_an_py310.py hl[14] *}

`UploadFile` 을 사용하는 것은 `bytes` 과 비교해 다음과 같은 장점이 있습니다:

* 매개변수의 기본값에서 `File()`을 사용할 필요가 없습니다.
* "스풀 파일"을 사용합니다.

これは内容全体がメモリに保持されることを意味します。小さなファイルには有効です。

しかし、多くの場合は `UploadFile` を使う方が有利です。

## `UploadFile` によるファイルパラメータ { #file-parameters-with-uploadfile }

型を `UploadFile` にしてファイルパラメータを定義します:

{* ../../docs_src/request_files/tutorial001_an_py310.py hl[14] *}

`UploadFile` を使うことには `bytes` に対する次の利点があります:

- パラメータのデフォルト値に `File()` を使う必要がありません。
- 「spooled」ファイルを使います:

Dosyalar ve form alanları form data olarak upload edilir ve siz de dosyaları ve form alanlarını alırsınız.

Ayrıca bazı dosyaları `bytes` olarak, bazılarını da `UploadFile` olarak tanımlayabilirsiniz.

/// warning | Uyarı

Los archivos y campos de formulario se subirán como form data y recibirás los archivos y campos de formulario.

Y puedes declarar algunos de los archivos como `bytes` y algunos como `UploadFile`.

/// warning | Advertencia