Перейти к основному содержимому

FormData

FormData используется для создания данных формы, которые отправляются через APIRequestContext.


Методы

Append

Добавлено в: v1.44 formData.Append

Добавляет новое значение к существующему ключу в объекте FormData или добавляет ключ, если он еще не существует. Значения файлов могут быть переданы либо как Path, либо как FilePayload. Можно добавить несколько полей с одинаковым именем.

Разница между FormData.Set() и FormData.Append() заключается в том, что если указанный ключ уже существует, FormData.Set() перезапишет все существующие значения новым, тогда как FormData.Append() добавит новое значение в конец существующего набора значений.

var multipart = Context.APIRequest.CreateFormData();
// Установлены только имя и значение.
multipart.Append("firstName", "John");
// Установлены имя, значение, имя файла и тип содержимого.
multipart.Append("attachment", new FilePayload()
{
Name = "pic.jpg",
MimeType = "image/jpeg",
Buffer = File.ReadAllBytes("john.jpg")
});
// Установлены имя, значение, имя файла и тип содержимого.
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();
// Установлены только имя и значение.
multipart.Set("firstName", "John");
// Установлены имя, значение, имя файла и тип содержимого.
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[]

      Содержимое файла

    Значение поля.

Возвращает