メインコンテンツにスキップ

FormData

このFormDataは、APIRequestContextを介して送信されるフォームデータを作成するために使用されます。


メソッド

Append

追加バージョン: v1.44 formData.Append

FormDataオブジェクト内の既存のキーに新しい値を追加します。キーが存在しない場合は追加します。ファイル値はPathまたはFilePayloadとして渡すことができます。同じ名前の複数のフィールドを追加できます。

FormData.Set()FormData.Append()の違いは、指定されたキーが既に存在する場合、FormData.Set()は既存のすべての値を新しい値で上書きするのに対し、FormData.Append()は既存の値のセットの末尾に新しい値を追加することです。

var multipart = Context.APIRequest.CreateFormData();
// Only name and value are set.
multipart.Append("firstName", "John");
// Name, value, filename and Content-Type are set.
multipart.Append("attachment", new FilePayload()
{
Name = "pic.jpg",
MimeType = "image/jpeg",
Buffer = File.ReadAllBytes("john.jpg")
});
// Name, value, filename and Content-Type are set.
multipart.Append("attachment", new FilePayload()
{
Name = "table.csv",
MimeType = "text/csv",
Buffer = File.ReadAllBytes("my-tble.csv")
});
await Page.APIRequest.PostAsync("https:///submit", new() { Multipart = multipart });

使用法

FormData.Append(name, value);

引数

  • name string#

    フィールド名。

  • value string | bool | int | Value#

    • Name string

      ファイル名

    • MimeType string

      ファイルタイプ

    • Buffer byte[]

      ファイル内容

    フィールド値。

戻り値


Set

追加: v1.18 formData.Set

フォームにフィールドを設定します。ファイル値はPathまたはFilePayloadとして渡すことができます。

var multipart = Context.APIRequest.CreateFormData();
// Only name and value are set.
multipart.Set("firstName", "John");
// Name, value, filename and Content-Type are set.
multipart.Set("profilePicture", new FilePayload()
{
Name = "john.jpg",
MimeType = "image/jpeg",
Buffer = File.ReadAllBytes("john.jpg")
});
multipart.Set("age", 30);
await Page.APIRequest.PostAsync("https:///submit", new() { Multipart = multipart });

使用法

FormData.Set(name, value);

引数

  • name string#

    フィールド名。

  • value string | bool | int | Value#

    • Name string

      ファイル名

    • MimeType string

      ファイルタイプ

    • Buffer byte[]

      ファイル内容

    フィールド値。

戻り値