跳至主要内容

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

用法

FormData.Append(name, value);

参数

返回值

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

用法

FormData.Set(name, value);

参数

返回值