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

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

      ファイルコンテンツ

    フィールド値。

戻り値