CheckBox.AutoPostBack-Eigenschaft
Ruft einen Wert ab, der angibt, ob der CheckBox-Zustand automatisch an den Server zurückgesendet wird, wenn darauf geklickt wird, oder legt diesen fest.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
<ThemeableAttribute(False)> _
Public Overridable Property AutoPostBack As Boolean
'Usage
Dim instance As CheckBox
Dim value As Boolean
value = instance.AutoPostBack
instance.AutoPostBack = value
[ThemeableAttribute(false)]
public virtual bool AutoPostBack { get; set; }
[ThemeableAttribute(false)]
public:
virtual property bool AutoPostBack {
bool get ();
void set (bool value);
}
/** @property */
public boolean get_AutoPostBack ()
/** @property */
public void set_AutoPostBack (boolean value)
public function get AutoPostBack () : boolean
public function set AutoPostBack (value : boolean)
Eigenschaftenwert
true, um den Zustand des CheckBox-Steuerelements automatisch an den Server zu übermitteln, wenn auf das Steuerelement geklickt wird, andernfalls false. Der Standardwert ist false.
Hinweise
Legen Sie mit dieser Eigenschaft fest, ob der Zustand des CheckBox-Steuerelements an den Server zurückgesendet wird, wenn darauf geklickt wird.
Hinweis
Das Festlegen dieser Eigenschaft auf true bewirkt, dass bei jedem Klicken auf das Steuerelement eine Schleife zum Server ausgeführt wird.
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 |
|---|---|
| Exemplarische Vorgehensweise: Validieren der Benutzereingabe in einer Web Forms-Seite | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Exemplarische Vorgehensweise: Validieren der Benutzereingabe in einer Web Forms-Seite | Erstellen von Anwendungen mit Visual Web Developer |
| Gewusst wie: Festlegen des Sendeverhaltens von ASP.NET-Webserversteuerelementen zum Server | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Festlegen des Sendeverhaltens von ASP.NET-Webserversteuerelementen zum Server | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Festlegen des Sendeverhaltens von ASP.NET-Webserversteuerelementen zum Server | Erstellen von ASP.NET-Webanwendungen |
Beispiel
Im folgenden Beispiel wird veranschaulicht, wie mit der AutoPostBack-Eigenschaft der Zustand des CheckBox-Steuerelements automatisch an den Server gesendet wird, wenn auf das Steuerelement geklickt wird.
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