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 das Erstellen eines HtmlSelect Steuerelements veranschaulicht, indem explizit die Elemente deklariert werden, die im Steuerelement angezeigt 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 das Erstellen eines HtmlSelect Steuerelements veranschaulicht, indem das Steuerelement an eine Datenquelle gebunden wird.
<%@ 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 SqlDataSource Steuerelements festgelegt, das zum Abrufen der Daten verwendet wird. Wenn die Seite geladen wird, wird das HtmlSelect Steuerelement automatisch an die durch das 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. Wenn Sie ein Element standardmäßig aus der Liste auswählen möchten, legen Sie die ListItem.Selected Eigenschaft des Elements auf true.
Sie können das Erscheinungsbild und Verhalten des HtmlSelect Steuerelements steuern, indem Sie die Size Eigenschaften 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 Auswahlmöglichkeiten zulassen (durch Festlegen der Multiple Eigenschaft auf true) oder eine Höhe größer als eine Zeile angeben (durch Festlegen der Size Eigenschaft auf einen Wert größer als 1), wird das Steuerelement als Listenfeld angezeigt.
Verwenden Sie die SelectedIndex Eigenschaft, um das ausgewählte Element in einem Steuerelement mit einer Auswahl HtmlSelect zu ermitteln, um den Index des ausgewählten Elements abzurufen. Anschließend können Sie diesen Wert verwenden, um das Element aus der Items Sammlung 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 der einzelnen Elemente.
Die HtmlSelect Klasse stellt zwei Eigenschaften zur Unterstützung der Datenbindung bereit. Zum Binden von Daten an jedes Objekt, das die System.Collections.IEnumerable Schnittstelle implementiert (z System.Data.DataView. B. , System.Collections.ArrayListund System.Collections.Generic.List<T>), oder die IListSource Schnittstelle, verwenden Sie die DataSource Eigenschaft, um die Datenquelle anzugeben, an die eine Bindung erfolgen 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 dessen 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 an die ListItem.Text Eigenschaften ListItem.Value und Eigenschaften eines Elements im Steuerelement gebunden werden, indem Sie die Eigenschaften bzwDataValueField. eigenschaften DataTextField festlegen. 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 z. B. über ein System.Data.DataSet Objekt mit mehreren Tabellen verfügen, müssen Sie angeben, welche Tabelle mit der DataMember Eigenschaft an das Steuerelement gebunden werden soll.
Eine Liste der anfänglichen Eigenschaftswerte für eine Instanz von HtmlSelect, finden Sie im HtmlSelect Konstruktor.
Konstruktoren
| Name | Beschreibung |
|---|---|
| HtmlSelect() |
Initialisiert eine neue Instanz der HtmlSelect-Klasse. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Adapter |
Ruft den browserspezifischen Adapter für das Steuerelement ab. (Geerbt von Control) |
| AppRelativeTemplateSourceDirectory |
Dient zum Abrufen oder Festlegen des anwendungsrelativen virtuellen Verzeichnisses des Page Objekts UserControl , das dieses Steuerelement enthält. (Geerbt von Control) |
| Attributes |
Ruft eine Auflistung aller Attributnamen- und Wertpaare ab, die auf einem Serversteuerelementtag innerhalb der ASP.NET Seite 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 |
Dient zum Abrufen oder Festlegen des Algorithmus, der zum Generieren des Werts der ClientID Eigenschaft verwendet wird. (Geerbt von Control) |
| ClientIDSeparator |
Ruft einen Zeichenwert ab, der das Trennzeichen darstellt, das in der ClientID Eigenschaft verwendet wird. (Geerbt von Control) |
| Context |
Ruft das Objekt ab, das HttpContext dem Serversteuerelement für die aktuelle Webanforderung zugeordnet ist. (Geerbt von Control) |
| Controls |
Ruft ein ControlCollection Objekt ab, das die untergeordneten Steuerelemente für ein angegebenes Serversteuerelement in der Ui-Hierarchie darstellt. (Geerbt von Control) |
| DataItemContainer |
Ruft einen Verweis auf den Benennungscontainer ab, wenn der Benennungscontainer IDataItemContainerimplementiert wird. (Geerbt von Control) |
| DataKeysContainer |
Ruft einen Verweis auf den Benennungscontainer ab, wenn der Benennungscontainer IDataKeysControlimplementiert wird. (Geerbt von Control) |
| DataMember |
Dient zum Abrufen oder Festlegen der Datenmenge, die an das HtmlSelect Steuerelement von einer DataSource Eigenschaft mit mehreren Datensätzen gebunden werden soll. |
| DataSource |
Ruft die Quelle der Informationen ab, die an das HtmlSelect Steuerelement gebunden werden sollen, oder legt diese fest. |
| DataSourceID |
Dient zum Abrufen oder Festlegen der ID Eigenschaft des Datenquellensteuerelements, das das HtmlSelect Steuerelement zum Abrufen der Datenquelle verwenden soll. |
| DataTextField |
Dient zum Abrufen oder Festlegen des Felds aus der Datenquelle, das an die Text Eigenschaft jedes Elements im HtmlSelect Steuerelement gebunden werden soll. |
| DataValueField |
Dient zum Abrufen oder Festlegen des Felds aus der Datenquelle, das an die Value Eigenschaft jedes Elements im HtmlSelect Steuerelement gebunden werden soll. |
| DesignMode |
Ruft einen Wert ab, der angibt, ob ein Steuerelement auf einer Entwurfsoberfläche verwendet wird. (Geerbt von Control) |
| Disabled |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das HTML-Serversteuerelement deaktiviert ist. (Geerbt von HtmlControl) |
| EnableTheming |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob Designs für dieses Steuerelement gelten. (Geerbt von Control) |
| EnableViewState |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Serversteuerelement den Ansichtszustand und den Ansichtszustand aller enthaltenen untergeordneten Steuerelemente für den anfordernden Client behält. (Geerbt von Control) |
| Events |
Ruft eine Liste von Ereignishandlerdelegatten für das Steuerelement ab. Diese Eigenschaft ist schreibgeschützt. (Geerbt von Control) |
| HasChildViewState |
Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des aktuellen Serversteuerelements über gespeicherte Ansichtszustandseinstellungen verfügen. (Geerbt von Control) |
| ID |
Ruft den programmgesteuerten Bezeichner ab, der dem Serversteuerelement zugewiesen ist, oder legt diesen fest. (Geerbt von Control) |
| IdSeparator |
Ruft das Zeichen ab, das zum Trennen von Steuerelementbezeichnern verwendet wird. (Geerbt von Control) |
| InnerHtml |
Dient zum Abrufen oder Festlegen des Inhalts zwischen den öffnenden und schließenden Tags des Steuerelements, ohne dass Sonderzeichen automatisch in die entsprechenden HTML-Entitäten konvertiert werden. Diese Eigenschaft wird für dieses Steuerelement nicht unterstützt. |
| InnerText |
Dient zum Abrufen oder Festlegen des Inhalts zwischen den öffnenden und schließenden Tags des Steuerelements mit der automatischen Konvertierung von Sonderzeichen in die entsprechenden HTML-Entitäten. 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 ist. |
| IsChildControlStateCleared |
Ruft einen Wert ab, der angibt, ob In diesem Steuerelement enthaltene Steuerelemente den Steuerelementstatus aufweisen. (Geerbt von Control) |
| IsTrackingViewState |
Ruft einen Wert ab, der angibt, ob das Serversteuerelement Änderungen am Ansichtszustand 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 aufgeführten Elemente enthält. |
| LoadViewStateByID |
Ruft einen Wert ab, der angibt, ob das Steuerelement am Laden des Ansichtszustands anstelle ID von Index teilnimmt. (Geerbt von Control) |
| Multiple |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob mehrere Elemente gleichzeitig im HtmlSelect Steuerelement ausgewählt werden können. |
| Name |
Dient zum Abrufen oder Festlegen des eindeutigen Bezeichnernamens, der dem HtmlSelect Steuerelement zugeordnet ist. |
| NamingContainer |
Ruft einen Verweis auf den Benennungscontainer des Serversteuerelements ab, der einen eindeutigen Namespace für die Unterscheidung zwischen Serversteuerelementen mit demselben ID Eigenschaftswert erstellt. (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 Seitensteuerelementhierarchie ab. (Geerbt von Control) |
| RenderingCompatibility |
Ruft einen Wert ab, der die ASP.NET Version angibt, mit der html gerendert wird, kompatibel ist. (Geerbt von Control) |
| RequiresDataBinding |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das HtmlSelect Steuerelement an seine angegebene Datenquelle gebunden werden muss. |
| 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 aktuell ausgewählten Elemente im HtmlSelect Steuerelement enthält. |
| Site |
Ruft Informationen zum Container ab, der das aktuelle Steuerelement hostt, wenn es auf einer Entwurfsoberfläche gerendert wird. (Geerbt von Control) |
| Size |
Ruft die Höhe (in Zeilen) des HtmlSelect Steuerelements ab oder legt sie fest. |
| SkinID |
Ruft die Haut ab, die auf das Steuerelement angewendet werden soll, oder legt sie fest. (Geerbt von Control) |
| Style |
Ruft eine Auflistung aller CSS-Eigenschaften (Cascading Stylesheet) 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 |
Dient zum Abrufen oder Festlegen eines Verweises auf die Vorlage, die dieses Steuerelement enthält. (Geerbt von Control) |
| TemplateSourceDirectory |
Ruft das virtuelle Verzeichnis des Page oder UserControl das aktuelle Serversteuerelement ab. (Geerbt von Control) |
| UniqueID |
Ruft den eindeutigen hierarchisch qualifizierten Bezeichner für das Serversteuerelement ab. (Geerbt von Control) |
| ValidateRequestMode |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Steuerelement Clienteingaben aus dem Browser auf potenziell gefährliche Werte überprüft. (Geerbt von Control) |
| Value |
Ruft den Wert des ausgewählten Elements im HtmlSelect Steuerelement ab oder legt die SelectedIndex Eigenschaft des Steuerelements auf den Index des ersten Elements in der Liste mit dem angegebenen Wert fest. |
| ViewState |
Ruft ein Wörterbuch mit Statusinformationen ab, mit dem Sie den Ansichtszustand eines Serversteuerelements für mehrere Anforderungen für dieselbe Seite speichern und wiederherstellen können. (Geerbt von Control) |
| ViewStateIgnoresCase |
Ruft einen Wert ab, der angibt, ob der HtmlControl Ansichtszustand Groß-/Kleinschreibung beachtet. (Geerbt von HtmlControl) |
| ViewStateMode |
Ruft den Ansichtszustandsmodus dieses Steuerelements ab oder legt diesen fest. (Geerbt von Control) |
| Visible |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob ein Serversteuerelement als Benutzeroberfläche auf der Seite gerendert wird. (Geerbt von Control) |
Methoden
| Name | Beschreibung |
|---|---|
| AddedControl(Control, Int32) |
Wird aufgerufen, nachdem der Auflistung des Objekts ein untergeordnetes Control Steuerelement hinzugefügt Controls wurde. (Geerbt von Control) |
| AddParsedSubObject(Object) |
Fügt dem HtmlSelect Steuerelement ein analysiertes untergeordnetes Steuerelement hinzu. |
| ApplyStyleSheetSkin(Page) |
Wendet die im Seitenstylesheet definierten Formatvorlageneigenschaften auf das Steuerelement an. (Geerbt von Control) |
| BeginRenderTracing(TextWriter, Object) |
Beginnt mit der Entwurfszeitablaufverfolgung von Renderingdaten. (Geerbt von Control) |
| BuildProfileTree(String, Boolean) |
Sammelt Informationen über das Serversteuerelement und liefert sie an die Eigenschaft, die Trace angezeigt werden soll, wenn die Ablaufverfolgung für die Seite aktiviert ist. (Geerbt von Control) |
| ClearCachedClientID() |
Legt den zwischengespeicherten ClientID Wert auf |
| ClearChildControlState() |
Löscht die Steuerelementstatusinformationen für die untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| ClearChildState() |
Löscht die Ansichts- und Steuerelementstatusinformationen für alle untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| ClearChildViewState() |
Löscht die Ansichtsstatusinformationen für alle untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| ClearEffectiveClientIDMode() |
Legt die ClientIDMode Eigenschaft der aktuellen Steuerelementinstanz und aller untergeordneten Steuerelemente auf Inherit. (Geerbt von Control) |
| ClearSelection() |
Löscht die Listenauswahl des HtmlSelect Steuerelements und legt die Selected Eigenschaft aller Elemente auf |
| CreateChildControls() |
Wird vom ASP.NET Seitenframework aufgerufen, um Serversteuerelemente zu benachrichtigen, die kompositionsbasierte Implementierung verwenden, um alle untergeordneten Steuerelemente zu erstellen, die sie in Vorbereitung auf das Veröffentlichen von Zurück- 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 einer Option zum Auslösen des DataBinding Ereignisses. (Geerbt von Control) |
| DataBindChildren() |
Bindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| Dispose() |
Ermöglicht es einem Serversteuerelement, die endgültige Bereinigung durchzuführen, bevor es aus dem Arbeitsspeicher freigegeben wird. (Geerbt von Control) |
| EndRenderTracing(TextWriter, Object) |
Beendet die Entwurfszeitablaufverfolgung von Renderingdaten. (Geerbt von Control) |
| EnsureChildControls() |
Bestimmt, ob das Serversteuerelement untergeordnete Steuerelemente enthält. Wenn dies nicht der Fall ist, werden untergeordnete Steuerelemente erstellt. (Geerbt von Control) |
| EnsureDataBound() |
Überprüft, ob für das HtmlSelect Steuerelement eine Datenbindung erforderlich ist und dass vor dem Aufrufen der DataBind() Methode ein gültiges Datenquellensteuerelement angegeben wird. |
| EnsureID() |
Erstellt einen Bezeichner für Steuerelemente, denen kein Bezeichner zugewiesen ist. (Geerbt von Control) |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| FindControl(String, Int32) |
Durchsucht den aktuellen Benennungscontainer für ein Serversteuerelement mit der angegebenen |
| FindControl(String) |
Durchsucht den aktuellen Benennungscontainer für ein Serversteuerelement mit dem angegebenen |
| Focus() |
Legt den Eingabefokus auf ein Steuerelement fest. (Geerbt von Control) |
| GetAttribute(String) |
Ruft den Wert des benannten Attributs für das 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 Entwurfszeitdaten für ein Steuerelement ab. (Geerbt von Control) |
| GetHashCode() |
Dient 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 die Type der aktuellen Instanz ab. (Geerbt von Object) |
| GetUniqueIDRelativeTo(Control) |
Gibt den präfixierten Teil der UniqueID Eigenschaft des angegebenen Steuerelements zurück. (Geerbt von Control) |
| HasControls() |
Bestimmt, 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 untergeordnete Steuerelemente registriert sind. (Geerbt von Control) |
| IsLiteralContent() |
Bestimmt, ob das Serversteuerelement nur Literalinhalte enthält. (Geerbt von Control) |
| LoadControlState(Object) |
Stellt Steuerstatusinformationen aus einer vorherigen Seitenanforderung wieder her, die von der SaveControlState() Methode gespeichert wurde. (Geerbt von Control) |
| LoadPostData(String, NameValueCollection) |
Verarbeitet die Postbackdaten für das HtmlSelect Steuerelement. |
| LoadViewState(Object) |
Stellt die Ansichtsstatusinformationen des HtmlSelect Steuerelements aus einer vorherigen Seitenanforderung wieder her, die von der SaveViewState() Methode gespeichert wurde. |
| MapPathSecure(String) |
Ruft den physischen Pfad ab, dem ein virtueller Pfad, entweder absolut oder relativ, zugeordnet ist. (Geerbt von Control) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| OnBubbleEvent(Object, EventArgs) |
Bestimmt, ob das Ereignis für das Serversteuerelement an die Ui-Serversteuerelementhierarchie der Seite übergeben wird. (Geerbt von Control) |
| OnDataBinding(EventArgs) |
Löst das DataBinding Ereignis eines HtmlSelect Steuerelements aus. |
| OnDataPropertyChanged() |
Wird aufgerufen, wenn die Eigenschaft DataMemberoder DataSourceID die DataSourceEigenschaft geändert wird. |
| OnDataSourceViewChanged(Object, EventArgs) |
Wird aufgerufen, wenn die Eigenschaft DataMemberoder DataSourceID die DataSourceEigenschaft 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 Steuerelements HtmlSelect aus. Auf diese Weise 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 Verwendeten zum Lesen einer Datei ab. (Geerbt von Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Weist alle Quellen des Ereignisses und dessen Informationen dem übergeordneten Element des Steuerelements zu. (Geerbt von Control) |
| RaisePostDataChangedEvent() |
Ruft die OnServerChange(EventArgs) Methode auf, um das HtmlSelect Steuerelement zu signalisieren, dass sich der Zustand des Steuerelements geändert hat. |
| 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 auf das angegebene HtmlTextWriter Objekt. (Geerbt von HtmlContainerControl) |
| RenderAttributes(HtmlTextWriter) |
Rendert die Attribute des HtmlSelect Steuerelements für das angegebene HtmlTextWriter Objekt. |
| RenderBeginTag(HtmlTextWriter) |
Rendert das öffnende HTML-Tag des Steuerelements in das angegebene HtmlTextWriter Objekt. (Geerbt von HtmlControl) |
| RenderChildren(HtmlTextWriter) |
Rendert die untergeordneten Steuerelemente des HtmlSelect Steuerelements im angegebenen HtmlTextWriter Objekt. |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Gibt den Inhalt des Serversteuerelements mithilfe eines bereitgestellten Objekts an ein bereitgestelltes HtmlTextWriterControlAdapter Objekt aus. (Geerbt von Control) |
| RenderControl(HtmlTextWriter) |
Gibt Den Inhalt des Serversteuerelements an ein bereitgestelltes HtmlTextWriter Objekt aus und speichert Ablaufverfolgungsinformationen zum Steuerelement, wenn die Ablaufverfolgung aktiviert ist. (Geerbt von Control) |
| RenderEndTag(HtmlTextWriter) |
Rendert das schließende Tag für das HtmlContainerControl Steuerelement in das angegebene 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) |
Wandelt eine URL in eine URL um, die auf dem anfordernden Client verwendet werden kann. (Geerbt von Control) |
| SaveControlState() |
Speichert alle Änderungen des Serversteuerelementstatus, die seit dem Zeitpunkt der Zurückpostung der Seite auf dem Server aufgetreten sind. (Geerbt von Control) |
| SaveViewState() |
Speichert alle HtmlSelect Änderungen des Steuerelementansichtszustands, die seit der Zurückpostung der Seite auf dem Server aufgetreten sind. |
| Select(Int32[]) |
Wählt mehrere Elemente der HtmlSelect Auflistung des Steuerelements Items aus. |
| SetAttribute(String, String) |
Legt den Wert des benannten Attributs für das HtmlControl Steuerelement fest. (Geerbt von HtmlControl) |
| SetDesignModeState(IDictionary) |
Legt Entwurfszeitdaten für ein Steuerelement fest. (Geerbt von Control) |
| SetRenderMethodDelegate(RenderMethod) |
Weist einen Ereignishandlerdelegat zu, um das Serversteuerelement und dessen Inhalt in seinem übergeordneten Steuerelement zu rendern. (Geerbt von Control) |
| SetTraceData(Object, Object, Object) |
Legt Ablaufverfolgungsdaten für die Entwurfszeitablaufverfolgung von Renderingdaten mithilfe des ablaufverfolgungsobjekts, des Ablaufverfolgungsdatenschlüssels und des Ablaufverfolgungsdatenwerts fest. (Geerbt von Control) |
| SetTraceData(Object, Object) |
Legt Ablaufverfolgungsdaten für die Entwurfszeitablaufverfolgung von Renderingdaten mithilfe des Ablaufverfolgungsdatenschlüssels und des Ablaufverfolgungsdatenwerts fest. (Geerbt von Control) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
| TrackViewState() |
Verfolgt Ansichtszustandsänderungen am HtmlSelect Steuerelement nach, sodass die Änderungen im Objekt des Steuerelements StateBag gespeichert werden können. Auf dieses Objekt kann über die ViewState Eigenschaft zugegriffen werden. |
Ereignisse
| Name | Beschreibung |
|---|---|
| DataBinding |
Tritt auf, wenn das Serversteuerelement eine Bindung an eine Datenquelle ausführt. (Geerbt von Control) |
| Disposed |
Tritt auf, wenn ein Serversteuerelement aus dem Arbeitsspeicher freigegeben wird. Dies ist die letzte Phase des Lebenszyklus des Serversteuerelements, wenn eine ASP.NET Seite angefordert wird. (Geerbt von Control) |
| Init |
Tritt auf, wenn das Serversteuerelement initialisiert wird, was der erste Schritt im Lebenszyklus ist. (Geerbt von Control) |
| Load |
Tritt auf, wenn das Serversteuerelement in das Page Objekt geladen wird. (Geerbt von Control) |
| PreRender |
Tritt ein, nachdem das Control Objekt geladen wurde, aber vor dem Rendern. (Geerbt von Control) |
| ServerChange |
Tritt auf, wenn sich die ausgewählten Elemente im HtmlSelect Steuerelement zwischen Beiträgen auf dem Server ändern. |
| Unload |
Tritt auf, wenn das Serversteuerelement aus dem Arbeitsspeicher entladen wird. (Geerbt von Control) |
Explizite Schnittstellenimplementierungen
Erweiterungsmethoden
| Name | Beschreibung |
|---|---|
| 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 metatable -Objekt für das enthaltende Datensteuerelement zurück. |
