CheckBox.Checked-Eigenschaft
Ruft einen Wert ab, der angibt, ob das CheckBox-Steuerelement aktiviert ist, oder legt diesen fest.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
<BindableAttribute(True, BindingDirection.TwoWay)> _
<ThemeableAttribute(False)> _
Public Overridable Property Checked As Boolean
'Usage
Dim instance As CheckBox
Dim value As Boolean
value = instance.Checked
instance.Checked = value
[BindableAttribute(true, BindingDirection.TwoWay)]
[ThemeableAttribute(false)]
public virtual bool Checked { get; set; }
[BindableAttribute(true, BindingDirection::TwoWay)]
[ThemeableAttribute(false)]
public:
virtual property bool Checked {
bool get ();
void set (bool value);
}
/** @property */
public boolean get_Checked ()
/** @property */
public void set_Checked (boolean value)
public function get Checked () : boolean
public function set Checked (value : boolean)
Eigenschaftenwert
true, um einen aktivierten Zustand anzugeben, andernfalls false. Der Standardwert ist false.
Hinweise
Mit dieser Eigenschaft können Sie bestimmen, ob das CheckBox-Steuerelement aktiviert ist. Diese Eigenschaft kann auch zum programmgesteuerten Festlegen des Zustands für das CheckBox-Steuerelement verwendet werden.
Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden. Weitere Informationen finden Sie unter ThemeableAttribute und Übersicht über ASP.NET-Designs und ASP.NET-Skins.
| Thema | Position |
|---|---|
| Gewusst wie: Festlegen und Abrufen der Auswahl in einem RadioButton-Webserversteuerelement | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Programmgesteuertes Abrufen und Festlegen eines CheckBox-Webserversteuerelements | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Festlegen und Abrufen der Auswahl in einem RadioButton-Webserversteuerelement | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Programmgesteuertes Abrufen und Festlegen eines CheckBox-Webserversteuerelements | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Festlegen und Abrufen der Auswahl in einem RadioButton-Webserversteuerelement | Erstellen von ASP.NET-Webanwendungen |
| Gewusst wie: Programmgesteuertes Abrufen und Festlegen eines CheckBox-Webserversteuerelements | Erstellen von ASP.NET-Webanwendungen |
Beispiel
Das folgende Beispiel veranschaulicht, wie mit der Checked-Eigenschaft der Zustand des CheckBox-Steuerelements ermittelt werden kann.
Hinweis
Im folgenden Codebeispiel wird das Einzeldatei-Codemodell verwendet. Das Beispiel funktioniert möglicherweise nicht, wenn es direkt in eine CodeBehind-Datei kopiert wird. Dieses Codebeispiel muss in eine leere Textdatei mit einer ASPX-Erweiterung kopiert werden. Weitere Informationen zum Web Forms-Codemodell finden Sie unter Codemodell für ASP.NET-Webseiten.
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>
<script runat="server">
Sub Check_Clicked(sender As Object, e As EventArgs)
' Calculate the subtotal and display the result in currency format.
' Include tax if the check box is selected.
Message.Text = CalculateTotal(checkbox1.Checked).ToString("c")
End Sub
Sub Page_Load(sender As Object, e As EventArgs)
' Display the subtotal without tax when the page is first loaded.
If Not IsPostBack Then
' Calculate the subtotal and display the result in currency format.
Message.Text = CalculateTotal(false).ToString("c")
End If
End Sub
Function CalculateTotal(Taxable As Boolean) As Double
' Calculate the subtotal for the example.
Dim Result As Double = 1.99 + 2.99 + 3.99
' Add tax, if applicable.
If(Taxable)
Result += Result * 0.086
End If
Return Result
End Function
</script>
</head>
<body>
<form runat="server">
<h3>CheckBox CheckedChanged Example</h3>
Select whether to include tax in the subtotal.
<br><br>
<table border="1" cellpadding="5">
<tr>
<th colspan="2">
Shopping cart
</th>
</tr>
<tr>
<td>
Item 1
</td>
<td>
$1.99
</td>
</tr>
<tr>
<td>
Item 2
</td>
<td>
$2.99
</td>
</tr>
<tr>
<td>
Item 3
</td>
<td>
$3.99
</td>
</tr>
<tr>
<td>
<b>Subtotal</b>
</td>
<td>
<asp:Label id="Message" runat="server"/>
</td>
</tr>
<tr>
<td colspan="2">
<asp:CheckBox id="checkbox1" runat="server"
AutoPostBack="True"
Text="Include 8.6% sales tax"
TextAlign="Right"
OnCheckedChanged="Check_Clicked"/>
</td>
</tr>
</table>
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>
<script runat="server">
void Check_Clicked(Object sender, EventArgs e)
{
// Calculate the subtotal and display the result in currency format.
// Include tax if the check box is selected.
Message.Text = CalculateTotal(checkbox1.Checked).ToString("c");
}
void Page_Load(Object sender, EventArgs e)
{
// Display the subtotal without tax when the page is first loaded.
if(!IsPostBack)
{
// Calculate the subtotal and display the result in currency format.
Message.Text = CalculateTotal(false).ToString("c");
}
}
double CalculateTotal(bool Taxable)
{
// Calculate the subtotal for the example.
double Result = 1.99 + 2.99 + 3.99;
// Add tax, if applicable.
if(Taxable)
{
Result += Result * 0.086;
}
return Result;
}
</script>
</head>
<body>
<form runat="server">
<h3>CheckBox CheckedChanged Example</h3>
Select whether to include tax in the subtotal.
<br><br>
<table border="1" cellpadding="5">
<tr>
<th colspan="2">
Shopping cart
</th>
</tr>
<tr>
<td>
Item 1
</td>
<td>
$1.99
</td>
</tr>
<tr>
<td>
Item 2
</td>
<td>
$2.99
</td>
</tr>
<tr>
<td>
Item 3
</td>
<td>
$3.99
</td>
</tr>
<tr>
<td>
<b>Subtotal</b>
</td>
<td>
<asp:Label id="Message" runat="server"/>
</td>
</tr>
<tr>
<td colspan="2">
<asp:CheckBox id="checkbox1" runat="server"
AutoPostBack="True"
Text="Include 8.6% sales tax"
TextAlign="Right"
OnCheckedChanged="Check_Clicked"/>
</td>
</tr>
</table>
</form>
</body>
</html>
Plattformen
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
CheckBox-Klasse
CheckBox-Member
System.Web.UI.WebControls-Namespace