Zum Hauptinhalt springen

4.2. Content-Disposition-Header-Feld für jeden Teil

4.2. Content-Disposition-Header-Feld für jeden Teil​

Jeder Teil muss ein Content-Disposition-Header-Feld [RFC2183] enthalten, bei dem der Dispositionstyp "form-data" ist (MUST). Das Content-Disposition-Header-Feld muss außerdem einen zusätzlichen Parameter "name" enthalten (MUST); der Wert des "name"-Parameters ist der ursprüngliche Feldname aus dem Formular (möglicherweise codiert; siehe Abschnitt 5.1). Beispielsweise kann ein Teil ein Header-Feld wie das folgende enthalten, wobei der Body des Teils die Formulardaten des Feldes "user" enthält:

Content-Disposition: form-data; name="user"

Für Formulardaten, die den Inhalt einer Datei darstellen, sollte zusätzlich ein Name für die Datei angegeben werden, und zwar unter Verwendung eines "filename"-Parameters des Content-Disposition-Header-Felds (SHOULD). Der Dateiname ist in Fällen nicht zwingend, in denen der Dateiname nicht verfügbar oder bedeutungslos oder privat ist; dies kann beispielsweise auftreten, wenn eine Auswahl oder Drag-and-Drop verwendet wird oder wenn der Inhalt der Formulardaten direkt von einem Gerät gestreamt wird.

Wenn ein "filename"-Parameter angegeben wird, gelten die Anforderungen von Abschnitt 2.3 von [RFC2183] an den "receiving MUA" (d. h. den empfangenden Mail User Agent) auch für Empfänger von multipart/form-data: Verwenden Sie den Dateinamen nicht blind, prüfen Sie ihn und ändern Sie ihn gegebenenfalls so, dass er den lokalen Dateisystemkonventionen entspricht, und verwenden Sie keine Verzeichnispfadinformationen, die vorhanden sein können.

In den meisten Multipart-Typen sind die MIME-Header-Felder in jedem Teil auf US-ASCII beschränkt; zur Kompatibilität mit diesen Systemen dürfen für Benutzer normalerweise sichtbare Dateinamen mit der Prozent-Codierungsmethode aus Abschnitt 2 codiert werden (MAY), entsprechend der Art und Weise, wie ein "file:"-URI [URI-SCHEME] codiert werden könnte.

HINWEIS: Die in [RFC5987] beschriebene Codierungsmethode, die einen "filename*"-Parameter zum Content-Disposition-Header-Feld hinzufügen würde, darf nicht verwendet werden (MUST NOT).

Einige häufig eingesetzte Systeme verwenden multipart/form-data mit direkt codierten Dateinamen, einschließlich Oktetten außerhalb des US-ASCII-Bereichs. Die für die Dateinamen verwendete Codierung ist typischerweise UTF-8, obwohl HTML-Formulare den dem Formular zugeordneten Zeichensatz verwenden.