HtmlSelect Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ermöglicht den programmgesteuerten Zugriff auf das HTML-Element <select> auf dem Server.
public ref class HtmlSelect : System::Web::UI::HtmlControls::HtmlContainerControl, System::Web::UI::IPostBackDataHandler[System.Web.UI.ValidationProperty("Value")]
public class HtmlSelect : System.Web.UI.HtmlControls.HtmlContainerControl, System.Web.UI.IPostBackDataHandler[<System.Web.UI.ValidationProperty("Value")>]
type HtmlSelect = class
inherit HtmlContainerControl
interface IPostBackDataHandler
interface IParserAccessorPublic Class HtmlSelect
Inherits HtmlContainerControl
Implements IPostBackDataHandler- Vererbung
- Attribute
- Implementiert
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie Sie ein HtmlSelect Steuerelement erstellen, indem Die elemente, die im Steuerelement angezeigt werden, explizit deklariert werden.
<%@ 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">
<script runat="server">
void Button_Click (Object sender, EventArgs e)
{
Label1.Text = "You selected:";
for (int i = 0; i <= Select1.Items.Count - 1; i++)
{
if (Select1.Items[i].Selected)
Label1.Text += "<br /> -" + Select1.Items[i].Text;
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title> HtmlSelect Example </title>
</head>
<body>
<form id="form1" runat="server">
<h3> HtmlSelect Example </h3>
Select items from the list: <br /><br />
<select id="Select1"
multiple="true"
runat="server">
<option value="1" selected="selected"> Item 1 </option>
<option value="2"> Item 2 </option>
<option value="3"> Item 3 </option>
<option value="4"> Item 4 </option>
<option value="5"> Item 5 </option>
<option value="6"> Item 6 </option>
</select>
<br /><br />
<button id="Button1"
onserverclick="Button_Click"
runat="server">
Submit
</button>
<br /><br />
<asp:Label id="Label1"
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">
<script runat="server">
Sub Button_Click (sender As Object, e As EventArgs)
Dim i As Integer
Label1.Text = "You selected:"
For i = 0 to Select1.Items.Count - 1
If Select1.Items(i).Selected Then
Label1.Text = Label1.Text & "<br /> -" _
& Select1.Items(i).Text
End If
Next i
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title> HtmlSelect Example </title>
</head>
<body>
<form id="form1" runat="server">
<h3> HtmlSelect Example </h3>
Select items from the list: <br /><br />
<select id="Select1"
multiple="true"
runat="server">
<option value="1" selected="selected"> Item 1 </option>
<option value="2"> Item 2 </option>
<option value="3"> Item 3 </option>
<option value="4"> Item 4 </option>
<option value="5"> Item 5 </option>
<option value="6"> Item 6 </option>
</select>
<br /><br />
<button id="Button1"
onserverclick="Button_Click"
runat="server">
Submit
</button>
<br /><br />
<asp:Label id="Label1"
runat="server"/>
</form>
</body>
</html>
Im folgenden Codebeispiel wird veranschaulicht, wie Sie ein HtmlSelect Steuerelement erstellen, indem Sie das Steuerelement an eine Datenquelle binden.
<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<%@ Import Namespace="System.Data.SqlClient" %>
<!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> HtmlSelect Example </title>
<script runat="server">
void Page_Load (Object sender, EventArgs e)
{
// Bind the HtmlSelect control to a data source when the page is initially loaded.
if (!IsPostBack)
{
// Open a connection to the database and run the query.
// Note that the connection string may vary depending on your
// database server settings.
string ConnectString = "server=localhost;database=pubs;integrated security=SSPI";
string QueryString = "select * from authors";
SqlConnection myConnection = new SqlConnection(ConnectString);
SqlDataAdapter myCommand = new SqlDataAdapter(QueryString, myConnection);
// Create a dataset to store the query results.
DataSet ds = new DataSet();
myCommand.Fill(ds, "Authors");
// Bind the HtmlSelect control to the data source.
Select1.DataSource = ds;
Select1.DataTextField = "au_fname";
Select1.DataValueField = "au_fname";
Select1.DataBind();
}
}
void Button_Click (Object sender, EventArgs e)
{
// Display the selected items.
Label1.Text = "You selected:";
for (int i=0; i<=Select1.Items.Count - 1; i++)
{
if (Select1.Items[i].Selected)
Label1.Text += "<br /> - " + Select1.Items[i].Text;
}
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3> HtmlSelect Example </h3>
Select items from the list. <br />
Use the Control or Shift key to select multiple items. <br /><br />
<select id="Select1"
multiple="true"
runat="server"/>
<br /><br />
<button id="Button1"
onserverclick="Button_Click"
runat="server">
Submit
</button>
<br /><br />
<asp:Label id="Label1"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<%@ Import Namespace="System.Data.SqlClient" %>
<!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> HtmlSelect Example </title>
<script runat="server">
Sub Page_Load (sender As Object, e As EventArgs)
' Bind the HtmlSelect control to a data source when the page is initially loaded.
If Not IsPostBack Then
' Open a connection to the database and run the query.
' Note that the connection string may vary depending on your
' database server settings.
Dim ConnectString As String = "server=localhost;database=pubs;integrated security=SSPI"
Dim QueryString As String = "select * from authors"
Dim myConnection As SqlConnection = New SqlConnection(ConnectString)
Dim myCommand As SqlDataAdapter = New SqlDataAdapter(QueryString, myConnection)
' Create a dataset to store the query results.
Dim ds As DataSet = New DataSet()
myCommand.Fill(ds, "Authors")
' Bind the HtmlSelect control to the data source.
Select1.DataSource = ds
Select1.DataTextField = "au_fname"
Select1.DataValueField = "au_fname"
Select1.DataBind()
End If
End Sub
Sub Button_Click (sender As Object, e As EventArgs)
Dim i As Integer
Label1.Text = "You selected:"
For i = 0 To Select1.Items.Count - 1
If Select1.Items(i).Selected Then
Label1.Text = Label1.Text & "<br /> - " & Select1.Items(i).Text
End If
Next i
End Sub
</script>
</head>
<body>
<form id="form1" runat="server">
<h3> HtmlSelect Example </h3>
Select items from the list. <br />
Use the Control or Shift key to select multiple items. <br /><br />
<select id="Select1"
multiple="true"
runat="server"/>
<br /><br />
<button id="Button1"
onserverclick="Button_Click"
runat="server">
Submit
</button>
<br /><br />
<asp:Label id="Label1"
runat="server"/>
</form>
</body>
</html>
Im folgenden Codebeispiel wird veranschaulicht, wie die DataSourceID -Eigenschaft verwendet wird, um die Datenquelle für ein HtmlSelect Steuerelement anzugeben. Die DataSourceID -Eigenschaft wird auf die ID -Eigenschaft des Steuerelements festgelegt, das SqlDataSource zum Abrufen der Daten verwendet wird. Wenn die Seite geladen wird, wird das HtmlSelect Steuerelement automatisch an die vom SqlDataSource -Steuerelement angegebene Datenquelle gebunden, und die Daten werden dem Benutzer angezeigt.
<%@ page language="C#" %>
<!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 id="Head1" runat="server">
<title>HtmlSelect.DataSourceID</title>
</head>
<body>
<form id="Form1" runat="server">
<div>
<h3> HtmlSelect.DataSourceID Example </h3>
<p>Select an item from the list</p>
<select id="Select1"
name="Select1"
datasourceid="SqlDataSource1"
datatextfield="ProductName"
runat="server">
</select>
<asp:sqldatasource id="SqlDataSource1"
connectionstring="workstation id=localhost;integrated security=SSPI;initial catalog=Northwind"
selectcommand="SELECT * FROM [Products] Where ProductID <= 5"
runat="server">
</asp:sqldatasource>
</div>
</form>
</body>
</html>
<%@ page language="VB" %>
<!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 id="Head1" runat="server">
<title>HtmlSelect.DataSourceID</title>
</head>
<body>
<form id="Form1" runat="server">
<div>
<h3> HtmlSelect.DataSourceID Example </h3>
<p>Select an item from the list</p>
<select id="Select1"
name="Select1"
datasourceid="SqlDataSource1"
datatextfield="ProductName"
runat="server">
</select>
<asp:sqldatasource id="SqlDataSource1"
connectionstring="workstation id=localhost;integrated security=SSPI;initial catalog=Northwind"
selectcommand="SELECT * FROM [Products] Where ProductID <= 5"
runat="server">
</asp:sqldatasource>
</div>
</form>
</body>
</html>
Hinweise
Verwenden Sie das HtmlSelect -Steuerelement, um ein Auswahlfeld zu erstellen. Geben Sie Elementauflistungen im Steuerelement an, indem Sie HTML-Elemente <option> zwischen den öffnenden und schließenden <select> Tags platzieren. Jedes Element wird durch ein System.Web.UI.WebControls.ListItem -Objekt dargestellt. Um den Text anzugeben, der für jedes Element im Steuerelement angezeigt wird, können Sie die ListItem.Text -Eigenschaft des Elements festlegen oder einfach Text zwischen den öffnenden und schließenden <option> Tags platzieren. Durch Festlegen der ListItem.Value -Eigenschaft des Elements können Sie dem Element einen Wert zuordnen, der sich vom Text unterscheidet. Um ein Element standardmäßig aus der Liste auszuwählen, legen Sie die ListItem.Selected -Eigenschaft des Elements auf fest true.
Sie können die Darstellung und das Verhalten des HtmlSelect Steuerelements steuern, indem Sie die Size Eigenschaften und Multiple festlegen. Die Size -Eigenschaft gibt die Höhe (in Zeilen) des Steuerelements an. Die Multiple -Eigenschaft gibt an, ob mehrere Elemente gleichzeitig im HtmlSelect Steuerelement ausgewählt werden können.
Standardmäßig wird das HtmlSelect Steuerelement als Dropdown-Listenfeld angezeigt. Wenn Sie mehrere Auswahlen zulassen (indem Sie die Multiple -Eigenschaft auf truefestlegen) oder eine Höhe größer als eine Zeile angeben (indem Sie die Size Eigenschaft auf einen Wert größer als 1festlegen), wird das Steuerelement als Listenfeld angezeigt.
Um das ausgewählte Element in einem Single-Selection-Steuerelement HtmlSelect zu bestimmen, verwenden Sie die SelectedIndex -Eigenschaft, um den Index des ausgewählten Elements abzurufen. Anschließend können Sie diesen Wert verwenden, um das Element aus der Items Auflistung abzurufen.
Um die ausgewählten Elemente aus einem HtmlSelect Steuerelement zu bestimmen, das mehrere Auswahlmöglichkeiten zulässt, durchlaufen Sie die Items Auflistung, und testen Sie die ListItem.Selected -Eigenschaft jedes Elements.
Die HtmlSelect -Klasse stellt zwei Eigenschaften zur Unterstützung der Datenbindung bereit. Verwenden Sie die -Eigenschaft, um Daten an ein Beliebiges Objekt zu binden, das die System.Collections.IEnumerable -Schnittstelle (z System.Data.DataView. B. , System.Collections.ArrayListund System.Collections.Generic.List<T>) oder die IListSource -Schnittstelle implementiert, um die DataSource Datenquelle anzugeben, an die gebunden werden soll. Wenn Sie die DataSource -Eigenschaft festlegen, müssen Sie den Code manuell schreiben, um die Datenbindung auszuführen. Um ein HtmlSelect Steuerelement automatisch an eine Datenquelle zu binden, die durch ein Datenquellensteuerelement dargestellt wird, verwenden Sie die DataSourceID -Eigenschaft, und legen Sie ihren Wert auf die ID -Eigenschaft des zu verwendenden Datenquellensteuerelements fest. Wenn Sie die DataSourceID -Eigenschaft festlegen, wird das HtmlSelect Steuerelement automatisch an das angegebene Datenquellensteuerelement gebunden. Daher müssen Sie die DataBind -Methode nicht explizit aufrufen.
Sie können auch angeben, welche Felder in der Datenquelle zu binden der ListItem.Text und ListItem.Value Eigenschaften eines Elements im Steuerelement durch Festlegen der DataTextField und DataValueField Eigenschaften bzw. Wenn die Datenquelle mehrere Datenquellen enthält, verwenden Sie die DataMember -Eigenschaft, um die spezifische Quelle anzugeben, die an das Steuerelement gebunden werden soll. Wenn Sie beispielsweise über ein System.Data.DataSet Objekt mit mehreren Tabellen verfügen, müssen Sie angeben, welche Tabelle mit der -Eigenschaft an das DataMember Steuerelement gebunden werden soll.
Eine Liste der anfänglichen Eigenschaftswerte für eine instance von HtmlSelectfinden Sie im HtmlSelect Konstruktor.
Konstruktoren
| HtmlSelect() |
Initialisiert eine neue Instanz der HtmlSelect-Klasse. |
Eigenschaften
| Adapter |
Ruft den browserspezifischen Adapter für das Steuerelement ab. (Geerbt von Control) |
| AppRelativeTemplateSourceDirectory |
Ruft das anwendungsrelative virtuelle Verzeichnis des Page-Objekts oder des UserControl-Objekt ab, das dieses Steuerelement enthält, oder legt dieses Verzeichnis fest. (Geerbt von Control) |
| Attributes |
Ruft eine Auflistung aller Attributname-Wert-Paare ab, die innerhalb der ASP.NET-Seite in einem Serversteuerelementtag ausgedrückt werden. (Geerbt von HtmlControl) |
| BindingContainer |
Ruft das Steuerelement ab, das die Datenbindung dieses Steuerelements enthält. (Geerbt von Control) |
| ChildControlsCreated |
Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des Serversteuerelements erstellt wurden. (Geerbt von Control) |
| ClientID |
Ruft die Steuerelement-ID für HTML-Markup ab, das von ASP.NET generiert wird. (Geerbt von Control) |
| ClientIDMode |
Ruft den Algorithmus ab, mit dem der Wert der ClientID-Eigenschaft generiert wird, oder legt diesen fest. (Geerbt von Control) |
| ClientIDSeparator |
Ruft einen Zeichenwert ab, der das in der ClientID-Eigenschaft verwendete Trennzeichen darstellt. (Geerbt von Control) |
| Context |
Ruft das dem Serversteuerelement für die aktuelle Webanforderung zugeordnete HttpContext-Objekt ab. (Geerbt von Control) |
| Controls |
Ruft ein ControlCollection-Objekt ab, das die untergeordneten Steuerelemente für ein angegebenes Serversteuerelement in der Hierarchie der Benutzeroberfläche darstellt. (Geerbt von Control) |
| DataItemContainer |
Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataItemContainer implementiert wird. (Geerbt von Control) |
| DataKeysContainer |
Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataKeysControl implementiert wird. (Geerbt von Control) |
| DataMember |
Ruft die Datengruppe ab, die aus einer HtmlSelect-Eigenschaft mit mehreren Datengruppen an das DataSource-Steuerelement gebunden werden soll, oder legt diese fest. |
| DataSource |
Ruft die Datenquelle ab, die an das HtmlSelect-Steuerelement gebunden werden soll oder legt diese fest. |
| DataSourceID |
Ruft die ID-Eigenschaft des Datenquellensteuerelements ab, von dem das HtmlSelect-Steuerelement seine Datenquelle abrufen soll, oder legt diese fest. |
| DataTextField |
Ruft das Feld aus der Datenquelle ab, das an die Text-Eigenschaft der einzelnen Elemente im HtmlSelect-Steuerelement gebunden werden soll, oder legt dieses fest. |
| DataValueField |
Ruft das Feld aus der Datenquelle ab, das an die Value-Eigenschaft der einzelnen Elemente im HtmlSelect-Steuerelement gebunden werden soll, oder legt dieses fest. |
| DesignMode |
Ruft einen Wert ab, der angibt, ob ein Steuerelement auf einer Entwurfsoberfläche verwendet wird. (Geerbt von Control) |
| Disabled |
Ruft einen Wert ab, der angibt, ob das HTML-Serversteuerelement deaktiviert ist, oder legt diesen fest. (Geerbt von HtmlControl) |
| EnableTheming |
Ruft einen Wert ab, der angibt, ob für dieses Steuerelement Designs gelten, oder legt diesen fest. (Geerbt von Control) |
| EnableViewState |
Ruft einen Wert ab, der dem anfordernden Client angibt, ob das Serversteuerelement seinen Ansichtszustand sowie den Ansichtszustand von jedem enthaltenen untergeordneten Steuerelement beibehält, oder legt diesen fest. (Geerbt von Control) |
| Events |
Ruft eine Liste von Ereignishandlerdelegaten für das Steuerelement ab. Diese Eigenschaft ist schreibgeschützt. (Geerbt von Control) |
| HasChildViewState |
Ruft einen Wert ab, der angibt, ob in den untergeordneten Steuerelementen des aktuellen Serversteuerelements gespeicherte Einstellungen für den Ansichtszustand vorhanden sind. (Geerbt von Control) |
| ID |
Ruft den programmgesteuerten Bezeichner ab, der dem Serversteuerelement zugewiesen ist, oder legt diesen fest. (Geerbt von Control) |
| IdSeparator |
Ruft das als Trennzeichen für Steuerelementbezeichner verwendete Zeichen ab. (Geerbt von Control) |
| InnerHtml |
Ruft den Inhalt zwischen dem Start- und dem Endtag des Steuerelements ab oder legt diesen fest, ohne Sonderzeichen automatisch in die entsprechenden HTML-Entitäten zu konvertieren. Diese Eigenschaft wird für dieses Steuerelement nicht unterstützt. |
| InnerText |
Ruft den Inhalt zwischen dem Start- und dem Endtag des Steuerelements ab oder legt diesen fest, wobei Sonderzeichen automatisch in die entsprechenden HTML-Entitäten konvertiert werden. Diese Eigenschaft wird für dieses Steuerelement nicht unterstützt. |
| IsBoundUsingDataSourceID |
Ruft einen Wert ab, der angibt, ob eine DataSourceID-Eigenschaft für das HtmlSelect-Steuerelement definiert wurde. |
| IsChildControlStateCleared |
Ruft einen Wert ab, der angibt, ob in diesem Steuerelements enthaltene Steuerelemente über einen Steuerelementzustand verfügen. (Geerbt von Control) |
| IsTrackingViewState |
Ruft einen Wert ab, der angibt, ob das Serversteuerelement Änderungen des Ansichtszustands speichert. (Geerbt von Control) |
| IsViewStateEnabled |
Ruft einen Wert ab, der angibt, ob der Ansichtszustand für dieses Steuerelement aktiviert ist. (Geerbt von Control) |
| Items |
Ruft eine Auflistung ab, die die in einem HtmlSelect-Steuerelement aufgelisteten Elemente enthält. |
| LoadViewStateByID |
Ruft einen Wert ab, der angibt, ob das Steuerelement seinen Ansichtszustand über ID anstatt über den Index lädt. (Geerbt von Control) |
| Multiple |
Ruft einen Wert ab, der angibt, ob im HtmlSelect-Steuerelement mehrere Elemente gleichzeitig ausgewählt werden können, oder legt diesen fest. |
| Name |
Ruft den eindeutigen Bezeichnernamen ab, der dem HtmlSelect-Steuerelement zugeordnet ist, oder legt diesen fest. |
| NamingContainer |
Ruft einen Verweis auf den Benennungscontainer des Serversteuerelements ab, der einen eindeutigen Namespace erstellt, damit zwischen Serversteuerelementen mit demselben ID-Eigenschaftswert unterschieden werden kann. (Geerbt von Control) |
| Page |
Ruft einen Verweis auf die Page-Instanz ab, die das Serversteuerelement enthält. (Geerbt von Control) |
| Parent |
Ruft einen Verweis auf das übergeordnete Steuerelement des Serversteuerelements in der Steuerelementhierarchie der Seite ab. (Geerbt von Control) |
| RenderingCompatibility |
Ruft einen Wert ab, der die ASP.NET-Version angibt, mit der gerenderte HTML-Objekte kompatibel sind. (Geerbt von Control) |
| RequiresDataBinding |
Ruft einen Wert ab, der angibt, ob das HtmlSelect-Steuerelement an seine angegebene Datenquelle gebunden werden muss, oder legt diesen fest. |
| SelectedIndex |
Ruft den Ordinalindex des ausgewählten Elements in einem HtmlSelect-Steuerelement ab oder legt diesen fest. |
| SelectedIndices |
Ruft eine Auflistung ab, die die nullbasierten Indizes aller zurzeit ausgewählten Elemente im HtmlSelect-Steuerelement enthält. |
| Site |
Ruft Informationen zum Container ab, der das aktuelle Steuerelement hostet, wenn es auf einer Entwurfsoberfläche gerendert wird. (Geerbt von Control) |
| Size |
Ruft die Höhe des HtmlSelect-Steuerelements in Zeilen ab oder legt diese fest. |
| SkinID |
Ruft das Design ab, das auf das Steuerelement angewendet werden soll. (Geerbt von Control) |
| Style |
Ruft eine Auflistung aller CSS (Cascading Stylesheet)-Eigenschaften ab, die auf ein angegebenes HTML-Serversteuerelement in der ASP.NET-Datei angewendet werden. (Geerbt von HtmlControl) |
| TagName |
Ruft den Elementnamen eines Tags ab, das ein |
| TemplateControl |
Ruft einen Verweis auf die Vorlage ab, die dieses Steuerelement enthält, oder legt den Verweis fest. (Geerbt von Control) |
| TemplateSourceDirectory |
Ruft das virtuelle Verzeichnis der Page oder des UserControl ab, in dem das aktuelle Serversteuerelement enthalten ist. (Geerbt von Control) |
| UniqueID |
Ruft den eindeutigen, hierarchisierten Bezeichner für das Serversteuerelement ab. (Geerbt von Control) |
| ValidateRequestMode |
Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Steuerelement Clienteingaben des Browser auf gefährliche Werte überprüft. (Geerbt von Control) |
| Value |
Ruft den Wert des im HtmlSelect-Steuerelement ausgewählten Elements ab, oder legt die SelectedIndex-Eigenschaft des Steuerelements auf den Index des ersten Elements der Liste fest, das den angegebenen Wert aufweist. |
| ViewState |
Ruft ein Wörterbuch mit Zustandsinformationen ab, mit dem Sie den Ansichtszustand eines Serversteuerelements über mehrere Anforderungen für dieselbe Seite hinweg speichern und wiederherstellen können. (Geerbt von Control) |
| ViewStateIgnoresCase |
Ruft einen Wert ab, der angibt, ob bei dem Ansichtszustand von HtmlControl die Groß- und Kleinschreibung berücksichtigt wird. (Geerbt von HtmlControl) |
| ViewStateMode |
Ruft den Ansichtszustandsmodus des Steuerelements ab oder legt ihn fest. (Geerbt von Control) |
| Visible |
Ruft einen Wert ab, der angibt, ob ein Serversteuerelement auf der Seite als Benutzeroberfläche gerendert wird. (Geerbt von Control) |
Methoden
| AddedControl(Control, Int32) |
Wird aufgerufen, nachdem ein untergeordnetes Steuerelement zur Controls-Auflistung des Control-Objekts hinzugefügt wurde. (Geerbt von Control) |
| AddParsedSubObject(Object) |
Fügt dem HtmlSelect-Steuerelement ein analysiertes untergeordnetes Steuerelement hinzu. |
| ApplyStyleSheetSkin(Page) |
Übernimmt die im Stylesheet der Seite definierten Stileigenschaften für das Steuerelement. (Geerbt von Control) |
| BeginRenderTracing(TextWriter, Object) |
Startet die Entwurfszeitablaufverfolgung des Renderns von Daten. (Geerbt von Control) |
| BuildProfileTree(String, Boolean) |
Sammelt Informationen zum Serversteuerelement und übermittelt sie an die Trace-Eigenschaft, sodass diese angezeigt werden, wenn die Ablaufverfolgung für die Seite aktiviert ist. (Geerbt von Control) |
| ClearCachedClientID() |
Legt den zwischengespeicherten ClientID-Wert auf |
| ClearChildControlState() |
Löscht die Informationen zum Steuerelementzustand für die untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| ClearChildState() |
Löscht die Informationen zum Ansichtszustand sowie zum Steuerelementzustand für alle untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| ClearChildViewState() |
Löscht die Informationen über den Ansichtszustand für alle untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| ClearEffectiveClientIDMode() |
Legt die ClientIDMode-Eigenschaft der aktuellen Steuerelementinstanz und aller untergeordneten Steuerelemente auf Inherit fest. (Geerbt von Control) |
| ClearSelection() |
Löscht die Listenauswahl des HtmlSelect-Steuerelements und legt die Selected-Eigenschaft aller Elemente auf |
| CreateChildControls() |
Wird durch das ASP.NET-Seitenframework aufgerufen, um Serversteuerelemente anzuweisen, die eine kompositionsbasierte Implementierung verwenden, um alle untergeordneten Steuerelemente zu erstellen, die sie in Vorbereitung auf ein Postback oder Rendering enthalten. (Geerbt von Control) |
| CreateControlCollection() |
Erstellt ein EmptyControlCollection-Objekt für das HtmlSelect-Steuerelement. |
| DataBind() |
Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente. (Geerbt von Control) |
| DataBind(Boolean) |
Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente mit der Option, das DataBinding-Ereignis auszulösen. (Geerbt von Control) |
| DataBindChildren() |
Bindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| Dispose() |
Ermöglicht es einem Serversteuerelement, die letzte Bereinigung durchzuführen, bevor es aus dem Speicher freigegeben wird. (Geerbt von Control) |
| EndRenderTracing(TextWriter, Object) |
Beendet die Entwurfszeitablaufverfolgung des Renderns von Daten. (Geerbt von Control) |
| EnsureChildControls() |
Stellt fest, ob das Serversteuerelement untergeordnete Steuerelemente enthält. Wenn das nicht der Fall ist, werden untergeordnete Steuerelemente erstellt. (Geerbt von Control) |
| EnsureDataBound() |
Überprüft vor dem Aufruf der HtmlSelect-Methode, ob für das DataBind()-Steuerelement eine Datenbindung erforderlich ist und ob ein gültiges Datenquellensteuerelement angegeben wurde. |
| EnsureID() |
Erstellt einen Bezeichner für Steuerelemente, die nicht über einen zugewiesenen Bezeichner verfügen. (Geerbt von Control) |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| FindControl(String) |
Durchsucht den aktuellen Benennungscontainer nach dem angegebenen Serversteuerelement mit dem angegebenen |
| FindControl(String, Int32) |
Durchsucht den aktuellen Benennungscontainer nach einem Serversteuerelement mit der angegebenen |
| Focus() |
Legt den Eingabefokus auf ein Steuerelement fest. (Geerbt von Control) |
| GetAttribute(String) |
Ruft den Wert des benannten Attributs im HtmlControl-Steuerelement ab. (Geerbt von HtmlControl) |
| GetData() |
Ruft ein IEnumerable-Objekt ab, das die Datenquelle darstellt, die an das HtmlSelect-Steuerelement gebunden ist. |
| GetDesignModeState() |
Ruft die Entwurfszeitdaten für ein Steuerelement ab. (Geerbt von Control) |
| GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
| GetRouteUrl(Object) |
Ruft die URL ab, die einem Satz von Routenparametern entspricht. (Geerbt von Control) |
| GetRouteUrl(RouteValueDictionary) |
Ruft die URL ab, die einem Satz von Routenparametern entspricht. (Geerbt von Control) |
| GetRouteUrl(String, Object) |
Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht. (Geerbt von Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht. (Geerbt von Control) |
| GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
| GetUniqueIDRelativeTo(Control) |
Gibt den mit einem Präfix versehenen Abschnitt der UniqueID-Eigenschaft des angegebenen Steuerelements zurück. (Geerbt von Control) |
| HasControls() |
Ermittelt, ob das Serversteuerelement untergeordnete Steuerelemente enthält. (Geerbt von Control) |
| HasEvents() |
Gibt einen Wert zurück, der angibt, ob Ereignisse für das Steuerelement oder für untergeordnete Steuerelemente registriert werden. (Geerbt von Control) |
| IsLiteralContent() |
Ermittelt, ob das Serversteuerelement nur literalen Inhalt enthält. (Geerbt von Control) |
| LoadControlState(Object) |
Stellt die Informationen zum Steuerelementzustand aus einer früheren Seitenanforderung wieder her, die durch die SaveControlState()-Methode gespeichert wurden. (Geerbt von Control) |
| LoadPostData(String, NameValueCollection) |
Verarbeitet die Postbackdaten für das HtmlSelect-Steuerelement. |
| LoadViewState(Object) |
Stellt die Informationen über den Ansichtszustand des HtmlSelect-Steuerelements aus einer früheren Seitenanforderung wieder her, die mit der SaveViewState()-Methode gespeichert wurden. |
| MapPathSecure(String) |
Ruft den physikalischen Pfad ab, auf den ein absoluter bzw. relativer virtueller Pfad verweist. (Geerbt von Control) |
| MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
| OnBubbleEvent(Object, EventArgs) |
Bestimmt, ob das Ereignis für das Serversteuerelement in der UI-Serversteuerelementhierarchie der Seite nach oben übergeben wird. (Geerbt von Control) |
| OnDataBinding(EventArgs) |
Löst das DataBinding-Ereignis eines HtmlSelect-Steuerelements aus. |
| OnDataPropertyChanged() |
Wird aufgerufen, wenn die DataSource-Eigenschaft, die DataMember-Eigenschaft oder die DataSourceID-Eigenschaft geändert wird. |
| OnDataSourceViewChanged(Object, EventArgs) |
Wird aufgerufen, wenn die DataSource-Eigenschaft, die DataMember-Eigenschaft oder die DataSourceID-Eigenschaft geändert wird. |
| OnInit(EventArgs) |
Löst das Init-Ereignis für das HtmlSelect-Steuerelement aus. |
| OnInit(EventArgs) |
Löst das Init-Ereignis aus. (Geerbt von Control) |
| OnLoad(EventArgs) |
Löst das Load-Ereignis für das HtmlSelect-Steuerelement aus. |
| OnLoad(EventArgs) |
Löst das Load-Ereignis aus. (Geerbt von Control) |
| OnPreRender(EventArgs) |
Löst das PreRender-Ereignis für das HtmlSelect-Steuerelement aus. |
| OnServerChange(EventArgs) |
Löst das ServerChange-Ereignis des HtmlSelect-Steuerelements aus. Dadurch können Sie einen benutzerdefinierten Handler für das Ereignis bereitstellen. |
| OnUnload(EventArgs) |
Löst das Unload-Ereignis aus. (Geerbt von Control) |
| OpenFile(String) |
Ruft einen Stream zum Lesen einer Datei ab. (Geerbt von Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Weist dem übergeordneten Element des Steuerelements alle Ereignisquellen und zugehörige Informationen zu. (Geerbt von Control) |
| RaisePostDataChangedEvent() |
Ruft die OnServerChange(EventArgs)-Methode auf, um dem HtmlSelect-Steuerelement die Zustandsänderung des Steuerelements zu signalisieren. |
| RemovedControl(Control) |
Wird aufgerufen, nachdem ein untergeordnetes Steuerelement aus der Controls-Auflistung des Control-Objekts entfernt wurde. (Geerbt von Control) |
| Render(HtmlTextWriter) |
Rendert das HtmlContainerControl-Steuerelement in das angegebene HtmlTextWriter-Objekt. (Geerbt von HtmlContainerControl) |
| RenderAttributes(HtmlTextWriter) |
Rendert die Attribute des HtmlSelect-Steuerelements in das angegebene HtmlTextWriter-Objekt. |
| RenderBeginTag(HtmlTextWriter) |
Rendert das öffnende HTML-Tag des Steuerelements im HtmlTextWriter-Objekt. (Geerbt von HtmlControl) |
| RenderChildren(HtmlTextWriter) |
Rendert die untergeordneten Steuerelemente des HtmlSelect-Steuerelements in das angegebene HtmlTextWriter-Objekt. |
| RenderControl(HtmlTextWriter) |
Gibt Inhalte von Serversteuerelementen an ein bereitgestelltes HtmlTextWriter-Objekt aus und speichert Ablaufverfolgungsinformationen zum Steuerelement, sofern die Ablaufverfolgung aktiviert ist. (Geerbt von Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Gibt Inhalte von Serversteuerelementen mithilfe eines bereitgestellten HtmlTextWriter-Objekts an ein bereitgestelltes ControlAdapter-Objekt aus. (Geerbt von Control) |
| RenderEndTag(HtmlTextWriter) |
Rendert das Endtag für das HtmlContainerControl-Steuerelement im angegebenen HtmlTextWriter-Objekt. (Geerbt von HtmlContainerControl) |
| ResolveAdapter() |
Ruft den Steuerelementadapter ab, der für das Rendern des angegebenen Steuerelements verantwortlich ist. (Geerbt von Control) |
| ResolveClientUrl(String) |
Ruft eine URL ab, die vom Browser verwendet werden kann. (Geerbt von Control) |
| ResolveUrl(String) |
Konvertiert eine URL in eine vom anfordernden Client verwendbare URL. (Geerbt von Control) |
| SaveControlState() |
Speichert alle Zustandsänderungen des Serversteuerelements, die seit dem Zeitpunkt aufgetreten sind, zu dem die Seite an den Server zurückgesendet wurde. (Geerbt von Control) |
| SaveViewState() |
Speichert alle Änderungen am Ansichtszustand des HtmlSelect-Steuerelements, die seit dem letzten Zurücksenden der Seite an den Server aufgetreten sind. |
| Select(Int32[]) |
Wählt mehrere Elemente aus der HtmlSelect-Auflistung des Items-Steuerelements aus. |
| SetAttribute(String, String) |
Legt den Wert des benannten Attributs im HtmlControl-Steuerelement fest. (Geerbt von HtmlControl) |
| SetDesignModeState(IDictionary) |
Legt die Entwurfszeitdaten für ein Steuerelement fest. (Geerbt von Control) |
| SetRenderMethodDelegate(RenderMethod) |
Beauftragt einen Ereignishandlerdelegaten, das Serversteuerelement und seinen Inhalt im übergeordneten Steuerelement zu rendern. (Geerbt von Control) |
| SetTraceData(Object, Object) |
Legt Ablaufverfolgungsdaten für die Nachverfolgung der Entwurfszeit von Rendering-Daten mithilfe des Ablaufverfolgungsdatenschlüssels und Ablaufverfolgungsdatenwerts fest. (Geerbt von Control) |
| SetTraceData(Object, Object, Object) |
Legt Ablaufverfolgungsdaten für die Nachverfolgung der Entwurfszeit von Rendering-Daten mithilfe des verfolgten Objekts, des Ablaufverfolgungsdatenschlüssels und Ablaufverfolgungsdatenwerts fest. (Geerbt von Control) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
| TrackViewState() |
Verfolgt Änderungen am Ansichtszustand des HtmlSelect-Steuerelements, sodass diese Änderungen im StateBag-Objekt des Steuerelements gespeichert werden können. Auf dieses Objekt kann über die ViewState-Eigenschaft zugegriffen werden. |
Ereignisse
| DataBinding |
Tritt ein, wenn das Serversteuerelement eine Bindung an eine Datenquelle durchführt. (Geerbt von Control) |
| Disposed |
Tritt ein, wenn ein Serversteuerelement im Speicher freigegeben wird. Dies ist die letzte Stufe des Lebenszyklus des Serversteuerelements bei der Anforderung einer ASP.NET-Seite. (Geerbt von Control) |
| Init |
Tritt bei der Initialisierung des Serversteuerelements ein. Dies ist der erste Schritt in dessen Lebenszyklus. (Geerbt von Control) |
| Load |
Tritt ein, wenn das Serversteuerelement in das Page-Objekt geladen wird. (Geerbt von Control) |
| PreRender |
Tritt nach dem Laden des Control-Objekts, jedoch vor dem Rendern ein. (Geerbt von Control) |
| ServerChange |
Tritt ein, wenn sich die im HtmlSelect-Steuerelement ausgewählten Elemente zwischen Bereitstellungen auf dem Server ändern. |
| Unload |
Tritt ein, wenn das Serversteuerelement aus dem Speicher entladen wird. (Geerbt von Control) |
Explizite Schnittstellenimplementierungen
Erweiterungsmethoden
| FindDataSourceControl(Control) |
Gibt die Datenquelle zurück, die dem Datensteuerelement für das angegebene Steuerelement zugeordnet ist. |
| FindFieldTemplate(Control, String) |
Gibt die Feldvorlage für die angegebene Spalte im Benennungscontainer des angegebenen Steuerelements zurück. |
| FindMetaTable(Control) |
Gibt das Metatabellenobjekt für das enthaltende Datensteuerelement zurück. |
Gilt für:
Weitere Informationen
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für