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

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://localhost/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://localhost/submit", new() { Multipart = multipart });

使用例

FormData.Set(name, value);

引数

  • name string#

    フィールド名。

  • value string | bool | int | Value#

    • Name string

      ファイル名

    • MimeType string

      ファイルタイプ

    • Buffer byte[]

      ファイルコンテンツ

    フィールド値。

戻り値