跳到主要內容

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);

引數

傳回