ControlParameter Klasse

Referenz

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 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 in einem ListBox Steuerelement angezeigte Daten an den ausgewählten Wert eines DropDownList Steuerelements in einem deklarativen Szenario zu binden. 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, einer Geschäftsobjektmethode oder einem Filterausdruck 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 instance gebunden werden soll, und die PropertyName -Eigenschaft gibt die öffentliche Eigenschaft des Control an, von der die ControlParameter -Klasse einen Wert abruft.

Konstruktoren

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 unter Verwendung des angegebenen Parameternamens, des angegebenen Datenbanktyps, der angegebenen Steuerelement-ID sowie des angegebenen Eigenschaftennamens.
ControlParameter(String, String)	Initialisiert eine neue benannte Instanz der ControlParameter-Klasse, wobei anhand des angegebenen Steuerelementnamens das Steuerelement identifiziert wird, an das die Bindung erfolgen soll.
ControlParameter(String, String, String)	Initialisiert eine neue benannte Instanz der ControlParameter-Klasse, wobei mithilfe des angegebenen Eigenschaftennamens und des Steuerelementnamens das Steuerelement identifiziert wird, an das die Bindung erfolgen soll.
ControlParameter(String, TypeCode, String, String)	Initialisiert eine neu benannte und stark typisierte Instanz der ControlParameter-Klasse, wobei mithilfe des angegebenen Eigenschaftennamens und des Steuerelementnamens das Steuerelement angegeben wird, an das die Bindung erfolgen soll.

Eigenschaften

ControlID	Gibt den Namen des Steuerelements an, an das das ControlParameter-Objekt gebunden wird.
ConvertEmptyStringToNull	Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob der Wert, an den das Parameter-Objekt gebunden ist, nach `null` konvertiert werden soll, wenn er Empty ist. (Geerbt von Parameter)
DbType	Ruft den Datenbanktyp des Parameters ab oder legt diesen fest. (Geerbt von Parameter)
DefaultValue	Gibt einen Standardwert für den Parameter an, wenn der Wert, an den der Parameter gebunden ist, beim Aufrufen der Evaluate(HttpContext, Control)-Methode nicht initialisiert ist. (Geerbt von Parameter)
Direction	Gibt an, ob das Parameter-Objekt zum Binden eines Werts an ein Steuerelement oder das Steuerelement zum Ändern des Werts verwendet werden kann. (Geerbt von Parameter)
IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das Parameter-Objekt Änderungen des Ansichtszustands speichert. (Geerbt von Parameter)
Name	Ruft den Namen des Parameters ab oder legt ihn fest. (Geerbt von Parameter)
PropertyName	Ruft den Eigenschaftennamen des Steuerelements ab, das durch die ControlID-Eigenschaft angegeben wird, an die das ControlParameter-Objekt gebunden wird, oder legt den Eigenschaftennamen fest.
Size	Ruft die Größe des Parameters ab oder legt sie fest. (Geerbt von Parameter)
Type	Ruft den Typ des Parameters ab oder legt ihn fest. (Geerbt von Parameter)
ViewState	Ruft ein Wörterbuch mit Zustandsinformationen ab, mit dem Sie den Ansichtszustand eines Parameter-Objekts über mehrere Anforderungen für dieselbe Seite hinweg speichern und wiederherstellen können. (Geerbt von Parameter)

Methoden

Clone()	Gibt ein Duplikat der aktuellen ControlParameter-Instanz zurück.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
Evaluate(HttpContext, Control)	Aktualisiert den Wert des ControlParameter-Objekts und gibt ihn zurück.
GetDatabaseType()	Ruft den DbType-Wert ab, der dem CLR-Typ der aktuellen Parameter-Instanz entspricht. (Geerbt von Parameter)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
LoadViewState(Object)	Stellt den früher gespeicherten Ansichtszustand der Datenquellenansicht wieder her. (Geerbt von Parameter)
MemberwiseClone()	Erstellt eine flache Kopie des 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 zurück an den Server gesendet wurde. (Geerbt von Parameter)
SetDirty()	Markiert das Parameter-Objekt, damit 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 an ihrem Ansichtszustand nachverfolgt, damit sie im ViewState-Objekt des Steuerelements gespeichert und über Anforderungen der gleichen Seite hinweg beibehalten werden. (Geerbt von Parameter)

Explizite Schnittstellenimplementierungen

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 des Ansichtszustands speichert. (Geerbt von Parameter)
IStateManager.LoadViewState(Object)	Stellt den früher 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 zurück an den Server gesendet wurde. (Geerbt von Parameter)
IStateManager.TrackViewState()	Bewirkt, dass das Parameter-Objekt Änderungen an ihrem Ansichtszustand nachverfolgt, damit sie im ViewState-Objekt des Steuerelements gespeichert und über Anforderungen der gleichen Seite hinweg beibehalten werden. (Geerbt von Parameter)

Gilt für: