sun
在 C# 中，Web Forms 是建立動態網站的強大框架之一。其中，CheckBoxList 類是一種 Web Control（網頁控制項），它提供了一個可交互式的列表框，用戶可以通過選中或取消選中來選擇多個選項。本文將深入探討 CheckBoxList 的使用方法以及其與數據感應（資料感應）的關係。
首先，讓我們看看如何在網頁中添加一個 CheckBoxList。你可以通過 Visual Studio 等開發環境中的設計器界面來拖放一個 CheckBoxList 到頁面中，或者直接在你的 ASP.NET 頁面的標記文件中手動添加如下代碼：
<asp:CheckBoxList ID="myCheckboxList" runat="server">
<!-- You can add items here as follows: -->
<asp:ListItem Text="Item1" Value="Value1"></asp:ListItem>
<asp:ListItem Text="Item2" Value="Value2" Selected="True"></asp:ListItem>
</asp:CheckBoxList>
在上面的示例中，我們定義了一個名爲 `myCheckboxList` 的 CheckBoxList，並且爲其添加了兩個預定義的項目。每個項目有一個文本值（Text）和一個用於標識項目的值（Value）。如果需要，您還可以指定某個項目是否默認被選中，這可以通過設置 `Selected` 屬性來實現。
接下來，我們將討論如何使用 CheckBoxList 與資料感應來收集用戶輸入並處理資料。當使用者與 CheckBoxList 進行互動時，ASP.NET 會自動將選中的項目資訊傳送到伺服端程式碼。你可以通過訪問 CheckBoxList 的 `Items` 集合來獲取這些信息。例如，如果你想要知道哪些項目被選中了，你可以這樣做：
protected void Page_Load(object sender, EventArgs e)
{
if (!Page.IsPostBack) // Only execute on the first load
{
// Initialize your CheckBoxList here
}
foreach (ListItem item in myCheckboxList.Items)
{
if (item.Selected) // If the item is checked
Console.WriteLine($"The selected value for this item is {item.Value}");
}
}
在上述代碼中，我們在頁面加載時初始化 CheckBoxList，然後在每次 postback（遞送）後遍歷所有項，以確定哪些項被選擇了。當某一項被選中時，我們可以獲取它的值並通過 `Console.WriteLine()` 將其打印出來。
此外，你可以在伺服端程式碼中更新 CheckBoxList 的內容，這通常用於響應來自客戶端的請求，比如點擊了一個按鈕後觸發的事件。以下是如何根據用戶選擇來更新 CheckBoxList 的範例：
protected void ButtonClickHandler(object sender, EventArgs e)
{
string[] selectedValues = Request.Form["myCheckboxList$<selected>"].Split('|');
for (int i = 0; i < selectedValues.Length; i++)
{
ListItem newItem = new ListItem();
newItem.Text = "New Item " + i;
newItem.Value = Guid.NewGuid().ToString();
myCheckboxList.Items.Add(newItem);
}
}
在這個例子中，我們假設有一個按鈕被按下後會觸發一個事件處理程序。在這個事件處理程序中，我們從請求參數中提取出已選中的 CheckBoxList 項目的值，然後為每一個選中的項目創建一個新的項目，並且賦予一個唯一的標識符（Guid）作為它的值。最後，我們將這些新的項目添加到 CheckBoxList 中。
總結來說，CheckBoxList 是一個功能強大的 Web Control，可以幫助你在 C# Web Forms 中輕鬆實現多選功能。結合資料感應的概念，你可以有效地收集用戶的輸入，並在服務器端處理這些數據。通過這篇文章，希望你能更好地理解和使用 CheckBoxList 來提升你的 web 應用程序的用戶體驗。
