Freigeben über

ListControl.AutoPostBack-Eigenschaft

  • Artikel

Ruft einen Wert ab, der angibt, ob ein automatisches Postback an den Server erfolgt, wenn der Benutzer die Listenauswahl ändert, 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 ListControl
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, wenn beim Ändern der Listenauswahl durch den Benutzer ein automatisches Postback an den Server erfolgt, andernfalls false. Der Standardwert ist false.

Hinweise

Legen Sie diese Eigenschaft auf true fest, wenn der Server die Auswahl sofort aufzeichnen soll, sobald diese vorgenommen wurde. Beispielsweise können andere Steuerelemente auf der Webseite je nach der vom Benutzer in einem Listensteuerelement vorgenommenen Auswahl automatisch gefüllt werden.

Mithilfe dieser Eigenschaft können andere Steuerelemente auf der Webseite abhängig von der durch den Benutzer in einer Liste getroffenen Auswahl automatisch gefüllt werden.

Der Wert dieser Eigenschaft wird im Ansichtszustand gespeichert.

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.

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie AutoPostBack für das ListBox-Steuerelement aktiviert wird.

<%@ Page Language="VB" AutoEventWireup="True" %>

<html>
<head>

   <script runat="server">

      Sub Page_Load(sender As Object, e As EventArgs)
      
         If Not IsNothing(ListBox1.SelectedItem)
            Label1.Text = "You selected: " & ListBox1.SelectedItem.Value
         Else
            Label1.Text = ""
         End If

      End Sub

   </script>

</head>

<body>

   <form runat="server">

      <h3>ListBox AutoPostBack Example</h3>

      Select an item from the list box: <br><br>

      <asp:ListBox id="ListBox1" 
           Rows="4"
           AutoPostBack="True" 
           SelectionMode="Single"  
           runat="server">
 
         <asp:ListItem>Item 1</asp:ListItem>
         <asp:ListItem>Item 2</asp:ListItem>
         <asp:ListItem>Item 3</asp:ListItem>
         <asp:ListItem>Item 4</asp:ListItem>
         <asp:ListItem>Item 5</asp:ListItem>
         <asp:ListItem>Item 6</asp:ListItem>
  
      </asp:ListBox>

      <br><br>

      <asp:Label id="Label1"
           runat="server"/>

   </form>

</body>
</html>
 

<%@ Page Language="C#" AutoEventWireup="True" %>

<html>
<head>

   <script runat="server">

      void Page_Load(Object sender, EventArgs e)
      {
         if (ListBox1.SelectedItem != null)
            Label1.Text = "You selected: " + ListBox1.SelectedItem.Value;
         else
            Label1.Text = "";
      }

   </script>

</head>

<body>

   <form runat="server">

      <h3>ListBox AutoPostBack Example</h3>

      Select an item from the list box: <br><br>

      <asp:ListBox id="ListBox1" 
           Rows="4"
           AutoPostBack="True" 
           SelectionMode="Single"  
           runat="server">
 
         <asp:ListItem>Item 1</asp:ListItem>
         <asp:ListItem>Item 2</asp:ListItem>
         <asp:ListItem>Item 3</asp:ListItem>
         <asp:ListItem>Item 4</asp:ListItem>
         <asp:ListItem>Item 5</asp:ListItem>
         <asp:ListItem>Item 6</asp:ListItem>
  
      </asp:ListBox>

      <br><br>

      <asp:Label id="Label1"
           runat="server"/>

   </form>

</body>
</html>
 

<%@ Page Language="JScript" AutoEventWireup="True" %>

<html>
<head>

   <script runat="server">

      function Page_Load(sender : Object, e : EventArgs){
         if(ListBox1.SelectedItem != null)
            Label1.Text = "You selected: " + ListBox1.SelectedItem.Value
         else
            Label1.Text = ""
      }

   </script>

</head>

<body>

   <form runat="server">

      <h3>ListBox AutoPostBack Example</h3>

      Select an item from the list box: <br><br>

      <asp:ListBox id="ListBox1" 
           Rows="4"
           AutoPostBack="True" 
           SelectionMode="Single"  
           runat="server">
 
         <asp:ListItem>Item 1</asp:ListItem>
         <asp:ListItem>Item 2</asp:ListItem>
         <asp:ListItem>Item 3</asp:ListItem>
         <asp:ListItem>Item 4</asp:ListItem>
         <asp:ListItem>Item 5</asp:ListItem>
         <asp:ListItem>Item 6</asp:ListItem>
  
      </asp:ListBox>

      <br><br>

      <asp:Label id="Label1"
           runat="server"/>

   </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

ListControl-Klasse
ListControl-Member
System.Web.UI.WebControls-Namespace