ControlParameter Klasse

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

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.

Bindet den Wert einer Eigenschaft eines Control Objekts an ein Parameterobjekt.

public ref class ControlParameter : System::Web::UI::WebControls::Parameter

public class ControlParameter : System.Web.UI.WebControls.Parameter

type ControlParameter = class
    inherit Parameter

Public Class ControlParameter
Inherits Parameter

Vererbung: Object

Parameter
ControlParameter

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein ControlParameter Objekt verwendet wird, um Daten zu binden, die in einem ListBox Steuerelement angezeigt werden, an den ausgewählten Wert eines DropDownList Steuerelements in einem deklarativen Szenario. Das ControlParameter Objekt wird der SelectParameters Auflistung des SqlDataSource Steuerelements im Formular hinzugefügt und entspricht dem Platzhaltertext "@Title" in der SelectCommand Eigenschaft.

<!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 runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <p><asp:dropdownlist
          id="DropDownList1"
          runat="server"
          autopostback="True">
          <asp:listitem selected="True">Sales Representative</asp:listitem>
          <asp:listitem>Sales Manager</asp:listitem>
          <asp:listitem>Vice President, Sales</asp:listitem>
      </asp:dropdownlist></p>

      <asp:sqldatasource
          id="SqlDataSource1"
          runat="server"
          connectionstring="<%$ ConnectionStrings:MyNorthwind%>"
          selectcommand="SELECT LastName FROM Employees WHERE Title = @Title">
          <selectparameters>
              <asp:controlparameter name="Title" controlid="DropDownList1" propertyname="SelectedValue"/>
          </selectparameters>
      </asp:sqldatasource>

      <p><asp:listbox
          id="ListBox1"
          runat="server"
          datasourceid="SqlDataSource1"
          datatextfield="LastName">
      </asp:listbox></p>

    </form>
  </body>
</html>

<!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 runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <p><asp:dropdownlist
          id="DropDownList1"
          runat="server"
          autopostback="True">
          <asp:listitem selected="True">Sales Representative</asp:listitem>
          <asp:listitem>Sales Manager</asp:listitem>
          <asp:listitem>Vice President, Sales</asp:listitem>
      </asp:dropdownlist></p>

      <asp:sqldatasource
          id="SqlDataSource1"
          runat="server"
          connectionstring="<%$ ConnectionStrings:MyNorthwind%>"
          selectcommand="SELECT LastName FROM Employees WHERE Title = @Title">
          <selectparameters>
              <asp:controlparameter name="Title" controlid="DropDownList1" propertyname="SelectedValue"/>
          </selectparameters>
      </asp:sqldatasource>

      <p><asp:listbox
          id="ListBox1"
          runat="server"
          datasourceid="SqlDataSource1"
          datatextfield="LastName">
      </asp:listbox></p>

    </form>
  </body>
</html>

Hinweise

Sie können die ControlParameter Klasse verwenden, um den Wert einer Control Eigenschaft, z SelectedValue . B. oder SelectedIndex, an einen Parameter zu binden, der in einer parametrisierten SQL-Abfrage, Geschäftsobjektmethode oder filterungsausdruck verwendet wird.

Die ControlParameter Klasse stellt zusätzlich zu den von der Parameter Klasse geerbten Eigenschaften zwei Eigenschaften bereit: ControlID und PropertyName. Die ControlID Eigenschaft gibt an, an welche Control Instanz eine Bindung erfolgen soll, und die PropertyName Eigenschaft gibt die öffentliche Eigenschaft der Control Klasse an, aus der die ControlParameter Klasse einen Wert abruft.

Konstruktoren

Name	Beschreibung
ControlParameter()	Initialisiert eine neue unbenannte Instanz der ControlParameter Klasse.
ControlParameter(ControlParameter)	Initialisiert eine neue Instanz der ControlParameter Klasse mit Werten aus der angegebenen Instanz.
ControlParameter(String, DbType, String, String)	Initialisiert eine neue Instanz der ControlParameter Klasse mithilfe des angegebenen Parameternamens, des Datenbanktyps, der Steuerelement-ID und des Eigenschaftennamens.
ControlParameter(String, String, String)	Initialisiert eine neue benannte Instanz der ControlParameter Klasse, wobei der angegebene Eigenschaftenname und der Steuerelementname verwendet werden, um zu identifizieren, an welches Steuerelement eine Bindung erfolgen soll.
ControlParameter(String, String)	Initialisiert eine neue benannte Instanz der ControlParameter Klasse, wobei der angegebene Steuerelementname verwendet wird, um zu identifizieren, an welches Steuerelement eine Bindung erfolgen soll.
ControlParameter(String, TypeCode, String, String)	Initialisiert eine neue benannte und stark typierte Instanz der ControlParameter Klasse, wobei der angegebene Eigenschaftenname und der Steuerelementname verwendet werden, um zu identifizieren, an welches Steuerelement eine Bindung erfolgen soll.

Eigenschaften

Name	Beschreibung
ControlID	Gibt den Namen des Steuerelements an, an das das ControlParameter Objekt gebunden ist.
ConvertEmptyStringToNull	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Wert, an den das Parameter Objekt gebunden ist, konvertiert `null` werden soll, wenn es ist Empty. (Geerbt von Parameter)
DbType	Dient zum Abrufen oder Festlegen des Datenbanktyps des Parameters. (Geerbt von Parameter)
DefaultValue	Gibt einen Standardwert für den Parameter an, sollte der Wert, an den der Parameter gebunden ist, nicht initialisiert werden, wenn die Evaluate(HttpContext, Control) Methode aufgerufen wird. (Geerbt von Parameter)
Direction	Gibt an, ob das Parameter Objekt verwendet wird, um einen Wert an ein Steuerelement zu binden, oder das Steuerelement kann verwendet werden, um den Wert zu ändern. (Geerbt von Parameter)
IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das Parameter Objekt Änderungen am Ansichtszustand speichert. (Geerbt von Parameter)
Name	Dient zum Abrufen oder Festlegen des Namens des Parameters. (Geerbt von Parameter)
PropertyName	Dient zum Abrufen oder Festlegen des Eigenschaftennamens des Steuerelements, das von der ControlID Eigenschaft identifiziert wird, an die das ControlParameter Objekt gebunden wird.
Size	Dient zum Abrufen oder Festlegen der Größe des Parameters. (Geerbt von Parameter)
Type	Dient zum Abrufen oder Festlegen des Typs des Parameters. (Geerbt von Parameter)
ViewState	Ruft ein Wörterbuch mit Statusinformationen ab, mit dem Sie den Ansichtszustand eines Parameter Objekts über mehrere Anforderungen für dieselbe Seite speichern und wiederherstellen können. (Geerbt von Parameter)

Methoden

Name	Beschreibung
Clone()	Gibt ein Duplikat der aktuellen ControlParameter Instanz zurück.
Equals(Object)	Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object)
Evaluate(HttpContext, Control)	Aktualisiert und gibt den Wert des ControlParameter Objekts zurück.
GetDatabaseType()	Ruft den DbType Wert ab, der dem CLR-Typ der aktuellen Parameter Instanz entspricht. (Geerbt von Parameter)
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
LoadViewState(Object)	Stellt den zuvor gespeicherten Ansichtszustand der Datenquellenansicht wieder her. (Geerbt von Parameter)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
OnParameterChanged()	Ruft die OnParametersChanged(EventArgs) Methode der ParameterCollection Auflistung auf, die das Parameter Objekt enthält. (Geerbt von Parameter)
SaveViewState()	Speichert die Änderungen am Ansichtszustand des Parameter Objekts seit dem Zeitpunkt, zu dem die Seite wieder auf dem Server gepostet wurde. (Geerbt von Parameter)
SetDirty()	Markiert das Parameter Objekt so, dass sein Zustand im Ansichtszustand aufgezeichnet wird. (Geerbt von Parameter)
ToString()	Konvertiert den Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung. (Geerbt von Parameter)
TrackViewState()	Bewirkt, dass das Parameter Objekt Änderungen am Ansichtszustand nachverfolgt, sodass sie im Objekt des Steuerelements ViewState gespeichert und über Anforderungen für dieselbe Seite hinweg beibehalten werden können. (Geerbt von Parameter)

Explizite Schnittstellenimplementierungen

Name	Beschreibung
ICloneable.Clone()	Gibt ein Duplikat der aktuellen Parameter Instanz zurück. (Geerbt von Parameter)
IStateManager.IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das Parameter Objekt Änderungen am Ansichtszustand speichert. (Geerbt von Parameter)
IStateManager.LoadViewState(Object)	Stellt den zuvor gespeicherten Ansichtszustand der Datenquellenansicht wieder her. (Geerbt von Parameter)
IStateManager.SaveViewState()	Speichert die Änderungen am Ansichtszustand des Parameter Objekts seit dem Zeitpunkt, zu dem die Seite wieder auf dem Server gepostet wurde. (Geerbt von Parameter)
IStateManager.TrackViewState()	Bewirkt, dass das Parameter Objekt Änderungen am Ansichtszustand nachverfolgt, sodass sie im Objekt des Steuerelements ViewState gespeichert und über Anforderungen für dieselbe Seite hinweg beibehalten werden können. (Geerbt von Parameter)

Gilt für:

Weitere Informationen

Feedback

War diese Seite hilfreich?