HtmlInputRadioButton 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
允許程式化存取伺服器上的 HTML <input type= radio> 元素。
public ref class HtmlInputRadioButton : System::Web::UI::HtmlControls::HtmlInputControl, System::Web::UI::IPostBackDataHandlerpublic class HtmlInputRadioButton : System.Web.UI.HtmlControls.HtmlInputControl, System.Web.UI.IPostBackDataHandlertype HtmlInputRadioButton = class
inherit HtmlInputControl
interface IPostBackDataHandlerPublic Class HtmlInputRadioButton
Inherits HtmlInputControl
Implements IPostBackDataHandler- 繼承
- 實作
範例
以下程式碼範例示範如何利用控制 HtmlInputRadioButton 項建立一組單選按鈕。
<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>HtmlInputRadioButton Sample</title>
<script language="C#" runat="server">
void Button1_Click(object sender, EventArgs e)
{
if (Radio1.Checked)
Span1.InnerHtml = "Option 1 is selected";
else if (Radio2.Checked)
Span1.InnerHtml = "Option 2 is selected";
else if (Radio3.Checked)
Span1.InnerHtml = "Option 3 is selected";
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>HtmlInputRadioButton Sample</h3>
<input type="radio"
id="Radio1"
name="Mode"
runat="server"/>
Option 1<br />
<input type="radio"
id="Radio2"
name="Mode"
runat="server"/>
Option 2<br />
<input type="radio"
id="Radio3"
name="Mode"
runat="server"/>
Option 3
<br />
<span id="Span1" runat="server" />
<br />
<input type="button"
id="Button1"
value="Enter"
onserverclick="Button1_Click"
runat="server" />
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>HtmlInputRadioButton Sample</title>
<script language="VB" runat="server">
Sub Button1_Click(sender As Object, e As EventArgs)
If Radio1.Checked = True Then
Span1.InnerHtml = "Option 1 is selected"
Else
If Radio2.Checked = True Then
Span1.InnerHtml = "Option 2 is selected"
Else
If Radio3.Checked = True Then
Span1.InnerHtml = "Option 3 is selected"
End If
End If
End If
End Sub 'Button1_Click
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>HtmlInputRadioButton Sample</h3>
<input type="radio"
id="Radio1"
name="Mode"
runat="server"/>
Option 1<br />
<input type="radio"
id="Radio2"
name="Mode"
runat="server"/>
Option 2<br />
<input type="radio"
id="Radio3"
name="Mode"
runat="server"/>
Option 3
<br />
<span id="Span1" runat="server" />
<br />
<input type="button"
id="Button1"
value="Enter"
onserverclick="Button1_Click"
runat="server" />
</form>
</body>
</html>
備註
使用 HtmlInputRadioButton 控制鍵在網頁上建立一個單選按鈕。 控制 HtmlInputRadioButton 鍵內建顯示單選按鈕標題的功能。 要製作說明文字，請在網頁中指定位置使用直文字。 這讓你能判斷標題相對於單選按鈕的顯示位置。 例如，如果你想在單選按鈕右側顯示標題，請先宣告一個 HtmlInputRadioButton 控制項，接著是標題文字，如下程式碼所示。
<input type="radio"
id="Radio1"
name="Mode"
runat="server"/>
Caption Text<br>
你也可以選擇透過設定Value屬性來將數量與HtmlInputRadioButton控制項關聯起來。 當你有多個選擇鍵需要根據選擇進行計算時，這很有用。
HtmlInputRadioButton 控制項可以透過指定每個你想加入群組的單選按鈕屬性的共同值 Name 來分組。
備註
當你將控制點群組 HtmlInputRadioButton 在一起時，一次只能選擇一個單選按鈕。
要判斷是否選擇了控制， HtmlInputRadioButton 請測試該 Checked 性質。 如果你有一組 HtmlInputRadioButton 控制，必須逐一遍歷控制，並分別測試 Checked 每個控制項的性質。
HtmlInputRadioButton控制項提供ServerChange一個事件，當Checked屬性在伺服器間的 post 值變更時會被觸發。 這讓你能建立自訂的事件處理程序，當事件被提出時執行特定指令，例如資料驗證。
如需 實例 HtmlInputRadioButton的初始屬性值清單，請參閱 建構函式 HtmlInputRadioButton 。
建構函式
| 名稱 | Description |
|---|---|
| HtmlInputRadioButton() |
初始化 HtmlInputRadioButton 類別的新執行個體。 |
屬性
| 名稱 | Description |
|---|---|
| Adapter |
拿到瀏覽器專用的控制器轉接器。 (繼承來源 Control) |
| AppRelativeTemplateSourceDirectory |
取得或設定包含此控制項的 or UserControl 物件的Page應用程式相對虛擬目錄。 (繼承來源 Control) |
| Attributes |
取得 ASP.NET 頁面中伺服器控制標籤中所有屬性名稱與值對的集合。 (繼承來源 HtmlControl) |
| BindingContainer |
取得包含該控制項資料綁定的控制項。 (繼承來源 Control) |
| Checked |
會獲得或設定一個值，表示是否選擇了控制項 HtmlInputRadioButton 。 |
| ChildControlsCreated |
會取得一個值，表示伺服器控制項的子控制項是否已被建立。 (繼承來源 Control) |
| ClientID |
取得由 ASP.NET 產生的 HTML 標記的控制 ID。 (繼承來源 Control) |
| ClientIDMode |
取得或設定用於產生屬性值 ClientID 的演算法。 (繼承來源 Control) |
| ClientIDSeparator |
會得到一個字元值，代表該屬性中使用 ClientID 的分隔符字元。 (繼承來源 Control) |
| Context |
取得 HttpContext 與伺服器控制項相關聯的物件，用於目前的網頁請求。 (繼承來源 Control) |
| Controls |
取得 ControlCollection 一個物件，代表 UI 階層中指定伺服器控制項的子控制項。 (繼承來源 Control) |
| DataItemContainer |
如果命名容器實 IDataItemContainer作 。 (繼承來源 Control) |
| DataKeysContainer |
如果命名容器實 IDataKeysControl作 。 (繼承來源 Control) |
| DesignMode |
會獲得一個值，表示是否在設計表面上使用控制項。 (繼承來源 Control) |
| Disabled |
取得或設定一個值，指示 HTML 伺服器控制項是否被停用。 (繼承來源 HtmlControl) |
| EnableTheming |
取得或設定一個值，指示主題是否適用於此控制。 (繼承來源 Control) |
| EnableViewState |
取得或設定一個值，指示伺服器控制項是否能持久化其視圖狀態，以及其包含的任何子控制項的視圖狀態，給請求端客戶端。 (繼承來源 Control) |
| Events |
會取得一個事件處理代理清單來管理控制。 這個屬性是唯讀的。 (繼承來源 Control) |
| HasChildViewState |
會取得一個值，表示目前伺服器控制項的子控制項是否儲存了任何檢視狀態設定。 (繼承來源 Control) |
| ID |
取得或設定分配給伺服器控制的程式識別碼。 (繼承來源 Control) |
| IdSeparator |
取得用來分離控制識別碼的字元。 (繼承來源 Control) |
| IsChildControlStateCleared |
會取得一個值，表示該控制中所包含的控制是否具有控制狀態。 (繼承來源 Control) |
| IsTrackingViewState |
會得到一個值，表示伺服器控制是否正在儲存對其檢視狀態的變更。 (繼承來源 Control) |
| IsViewStateEnabled |
會取得一個值，表示此控制是否啟用了檢視狀態。 (繼承來源 Control) |
| LoadViewStateByID |
會得到一個值，表示控制項是否參與載入其視圖狀態 ID ，而非索引。 (繼承來源 Control) |
| Name |
取得或設定該類別實例 HtmlInputRadioButton 所關聯的群組名稱。 |
| NamingContainer |
會取得伺服器控制項命名容器的參考，該容器會建立一個獨特的命名空間，用來區分具有相同 ID 屬性值的伺服器控制項。 (繼承來源 Control) |
| Page |
會取得包含 Page 伺服器控制的實例參考。 (繼承來源 Control) |
| Parent |
在頁面控制階層中，會取得伺服器控制項的父控制權的參考。 (繼承來源 Control) |
| RenderingCompatibility |
會得到一個值，指定渲染後的 HTML 會相容的 ASP.NET 版本。 (繼承來源 Control) |
| Site |
當在設計表面渲染時，會取得承載當前控制項的容器資訊。 (繼承來源 Control) |
| SkinID |
取得或設定皮膚貼合控制劑。 (繼承來源 Control) |
| Style |
會取得一套套用所有層疊樣式表（CSS）屬性的集合，套用到 ASP.NET 檔案中指定的 HTML 伺服器控制項。 (繼承來源 HtmlControl) |
| TagName |
取得包含 |
| TemplateControl |
取得或設定包含此控制項的範本參考。 (繼承來源 Control) |
| TemplateSourceDirectory |
取得包含當前伺服器控制權的 or UserControl 虛擬目錄Page。 (繼承來源 Control) |
| Type |
得到一種類型的 HtmlInputControl。 (繼承來源 HtmlInputControl) |
| UniqueID |
取得伺服器控制的唯一、階層限定的識別碼。 (繼承來源 Control) |
| ValidateRequestMode |
取得或設定一個值，指示控制器是否檢查瀏覽器的客戶端輸入是否有潛在危險的值。 (繼承來源 Control) |
| Value |
取得或設定與 HtmlInputRadioButton 控制項相關的值。 |
| ViewState |
取得狀態資訊字典，讓你能儲存並還原伺服器控制的多個請求，針對同一頁面。 (繼承來源 Control) |
| ViewStateIgnoresCase |
會得到一個表示視圖狀態是否 HtmlControl 區分大小寫的值。 (繼承來源 HtmlControl) |
| ViewStateMode |
取得或設定此控制的視圖狀態模式。 (繼承來源 Control) |
| Visible |
取得或設定一個值，指示伺服器控制項是否以 UI 形式呈現在頁面上。 (繼承來源 Control) |
方法
事件
| 名稱 | Description |
|---|---|
| DataBinding |
當伺服器控制項綁定到資料來源時會發生。 (繼承來源 Control) |
| Disposed |
當伺服器控制從記憶體中釋放時發生，這是伺服器控制生命週期中請求 ASP.NET 頁面的最後階段。 (繼承來源 Control) |
| Init |
發生在伺服器控制初始化時，這是其生命週期的第一步。 (繼承來源 Control) |
| Load |
當伺服器控制項載入 Page 物件時會發生。 (繼承來源 Control) |
| PreRender |
發生在物件載入後 Control 但渲染之前。 (繼承來源 Control) |
| ServerChange |
當控制項屬性的值CheckedHtmlInputRadioButton在伺服器的貼文間改變時發生。 |
| Unload |
當伺服器控制項從記憶體卸載時發生。 (繼承來源 Control) |
明確介面實作
擴充方法
| 名稱 | Description |
|---|---|
| FindDataSourceControl(Control) |
回傳與指定控制項相關聯的資料來源。 |
| FindFieldTemplate(Control, String) |
回傳指定控制項命名容器中指定欄位的欄位範本。 |
| FindMetaTable(Control) |
回傳包含資料控制項的元值物件。 |
