HtmlInputRadioButton 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
允許以程式設計方式存取伺服器上的 HTML <input type= radio>
項目。
public ref class HtmlInputRadioButton : System::Web::UI::HtmlControls::HtmlInputControl, System::Web::UI::IPostBackDataHandler
public class HtmlInputRadioButton : System.Web.UI.HtmlControls.HtmlInputControl, System.Web.UI.IPostBackDataHandler
type HtmlInputRadioButton = class
inherit HtmlInputControl
interface IPostBackDataHandler
Public 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 == true)
Span1.InnerHtml = "Option 1 is selected";
else if (Radio2.Checked == true)
Span1.InnerHtml = "Option 2 is selected";
else if (Radio3.Checked == true)
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 ,就會引發此事件。 這可讓您建立自訂事件處理常式,以在引發事件時執行一組特定的指令,例如資料驗證。
如需 實例 HtmlInputRadioButton 的初始屬性值清單,請參閱 建 HtmlInputRadioButton 構函式。
建構函式
HtmlInputRadioButton() |
初始化 HtmlInputRadioButton 類別的新執行個體。 |
屬性
Adapter |
針對控制項取得瀏覽器的特定配置器。 (繼承來源 Control) |
AppRelativeTemplateSourceDirectory |
取得或設定包含了此控制項之 Page 或 UserControl 物件的相對應用程式虛擬目錄。 (繼承來源 Control) |
Attributes |
取得 ASP.NET 網頁內伺服器控制項標記上所表示,所有成對屬性名稱和值的集合。 (繼承來源 HtmlControl) |
BindingContainer |
取得包含了此控制項之資料繫結的控制項。 (繼承來源 Control) |
Checked |
取得或設定值,指出是否已選取 HtmlInputRadioButton 控制項。 |
ChildControlsCreated |
取得值,指出是否已經建立伺服器控制項的子控制項。 (繼承來源 Control) |
ClientID |
取得 ASP.NET 所產生之 HTML 標記的控制項識別碼。 (繼承來源 Control) |
ClientIDMode |
取得或設定用來產生 ClientID 屬性值的演算法。 (繼承來源 Control) |
ClientIDSeparator |
取得字元值,表示在 ClientID 屬性中所使用的分隔字元。 (繼承來源 Control) |
Context |
取得與目前 Web 要求的伺服器控制項關聯的 HttpContext 物件。 (繼承來源 Control) |
Controls |
取得 ControlCollection 物件,表示 UI 階層架構中指定之伺服器控制項的子控制項。 (繼承來源 Control) |
DataItemContainer |
如果命名容器實作 IDataItemContainer,則取得命名容器的參考。 (繼承來源 Control) |
DataKeysContainer |
如果命名容器實作 IDataKeysControl,則取得命名容器的參考。 (繼承來源 Control) |
DesignMode |
取得值,指出控制項是否正用於設計介面上。 (繼承來源 Control) |
Disabled |
取得或設定值,指出是否停用 HTML 伺服器控制項。 (繼承來源 HtmlControl) |
EnableTheming |
取得或設定值,指出佈景主題是否套用至此控制項。 (繼承來源 Control) |
EnableViewState |
取得或設定值,該值表示伺服器控制項是否對要求的用戶端而言保持其檢視狀態,以及它包含的任何子控制項狀態。 (繼承來源 Control) |
Events |
取得控制項事件處理常式委派 (Delegate) 的清單。 這個屬性是唯讀的。 (繼承來源 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 |
取得在 ASP.NET 檔案中套用到指定 HTML 伺服器控制項的所有階層式樣式表 (CSS) 屬性集合。 (繼承來源 HtmlControl) |
TagName |
取得標記項目名稱,其包含 |
TemplateControl |
取得或設定包含了此控制項之樣板的參考。 (繼承來源 Control) |
TemplateSourceDirectory |
取得包含目前伺服器控制項的 Page 或 UserControl 的虛擬目錄。 (繼承來源 Control) |
Type |
取得 HtmlInputControl 的型別。 (繼承來源 HtmlInputControl) |
UniqueID |
取得伺服器控制項唯一的、符合階層架構的識別項。 (繼承來源 Control) |
ValidateRequestMode |
取得或設定值,指出控制項是否對來自瀏覽器的用戶端輸入檢查潛在的危險值。 (繼承來源 Control) |
Value |
取得或設定與 HtmlInputRadioButton 控制項關聯的值。 |
ViewState |
取得狀態資訊的字典,允許您在相同網頁的多個要求之間,儲存和還原伺服器控制項的檢視狀態。 (繼承來源 Control) |
ViewStateIgnoresCase |
取得值,指出 HtmlControl 檢視狀態是否區分大小寫。 (繼承來源 HtmlControl) |
ViewStateMode |
取得或設定這個控制項的檢視狀態模式。 (繼承來源 Control) |
Visible |
取得或設定值,指出伺服器控制項是否會轉譯為頁面上的 UI。 (繼承來源 Control) |
方法
事件
DataBinding |
發生於伺服器控制項繫結至資料來源時。 (繼承來源 Control) |
Disposed |
發生於伺服器控制項從記憶體釋放時,這是在要求 ASP.NET 網頁時,伺服器控制項生命週期的最後階段。 (繼承來源 Control) |
Init |
發生於初始化伺服器控制項時,是其生命週期中的第一個步驟。 (繼承來源 Control) |
Load |
發生於載入伺服器控制項至 Page 物件時。 (繼承來源 Control) |
PreRender |
在 Control 物件載入之後但在呈現之前發生。 (繼承來源 Control) |
ServerChange |
在 Checked 控制項的 HtmlInputRadioButton 屬性的值在傳送至伺服器期間變更時發生。 |
Unload |
發生於伺服器控制項從記憶體卸載時。 (繼承來源 Control) |
明確介面實作
擴充方法
FindDataSourceControl(Control) |
傳回與指定之控制項的資料控制項相關聯的資料來源。 |
FindFieldTemplate(Control, String) |
傳回在指定之控制項的命名容器中所指定資料行的欄位樣板。 |
FindMetaTable(Control) |
傳回包含資料控制項的中繼資料表物件。 |