ControlParameter Klasse

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Bindet den Wert einer Eigenschaft eines Control an ein Parameterobjekt.Binds the value of a property of a Control to a parameter object.

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-Steuerelement angezeigte Daten ListBox DropDownList in einem deklarativen Szenario an den ausgewählten Wert eines-Steuer Elements zu binden.The following code example demonstrates how to use a ControlParameter object to bind data displayed in a ListBox control to the selected value of a DropDownList control in a declarative scenario. Das ControlParameter -Objekt wird der SelectParameters -Auflistung des SqlDataSource -Steuer Elements auf dem Formular hinzugefügt und entspricht dem @Title Platzhalter Text in der- SelectCommand Eigenschaft.The ControlParameter object is added to the SelectParameters collection of the SqlDataSource control on the form, and corresponds to the "@Title" placeholder text in the SelectCommand property.

<!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. b. SelectedValue oder SelectedIndex , an einen Parameter zu binden, der in einer parametrisierten SQL-Abfrage, einer Geschäftsobjekt Methode oder einem Filter Ausdruck verwendet wird.You can use the ControlParameter class to bind the value of a Control property, such as SelectedValue or SelectedIndex, to a parameter that is used in a parameterized SQL query, business object method, or filtering expression.

Die ControlParameter -Klasse stellt zusätzlich zu den, die von der-Klasse geerbt werden, zwei Eigenschaften bereit Parameter : ControlID und PropertyName .The ControlParameter class provides two properties in addition to those inherited from the Parameter class: ControlID and PropertyName. Die ControlID -Eigenschaft identifiziert die Control Instanz, an die die Bindung erfolgen soll, und die- PropertyName Eigenschaft identifiziert die öffentliche-Eigenschaft des, Control von dem die- ControlParameter Klasse einen Wert abruft.The ControlID property identifies which Control instance to bind to and the PropertyName property identifies the public property of the Control from which the ControlParameter class retrieves a value.

Konstruktoren

ControlParameter()	Initialisiert eine neue unbenannte Instanz der ControlParameter-Klasse.Initializes a new unnamed instance of the ControlParameter class.
ControlParameter(ControlParameter)	Initialisiert eine neue Instanz der ControlParameter-Klasse mit Werten aus der angegebenen Instanz.Initializes a new instance of the ControlParameter class with values from the specified instance.
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.Initializes a new instance of the ControlParameter class by using the specified parameter name, database type, control ID, and property name.
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.Initializes a new named instance of the ControlParameter class, using the specified control name to identify which control to bind to.
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.Initializes a new named instance of the ControlParameter class, using the specified property name and control name to identify which control to bind to.
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.Initializes a new named and strongly typed instance of the ControlParameter class, using the specified property name and control name to identify which control to bind to.

Eigenschaften

ControlID	Gibt den Namen des Steuerelements an, an das das ControlParameter-Objekt gebunden wird.Specifies the name of the control that the ControlParameter object binds to.
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.Gets or sets a value indicating whether the value that the Parameter object is bound to should be converted to `null` if it is Empty. (Geerbt von Parameter)
DbType	Ruft den Datenbanktyp des Parameters ab oder legt diesen fest.Gets or sets the database type of the parameter. (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.Specifies a default value for the parameter, should the value that the parameter is bound to be uninitialized when the Evaluate(HttpContext, Control) method is called. (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.Indicates whether the Parameter object is used to bind a value to a control, or the control can be used to change the value. (Geerbt von Parameter)
IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das Parameter-Objekt Änderungen des Ansichtszustands speichert.Gets a value indicating whether the Parameter object is saving changes to its view state. (Geerbt von Parameter)
Name	Ruft den Namen des Parameters ab oder legt ihn fest.Gets or sets the name of the parameter. (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.Gets or sets the property name of the control identified by the ControlID property that the ControlParameter object binds to.
Size	Ruft die Größe des Parameters ab oder legt sie fest.Gets or sets the size of the parameter. (Geerbt von Parameter)
Type	Ruft den Typ des Parameters ab oder legt ihn fest.Gets or sets the type of the parameter. (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.Gets a dictionary of state information that allows you to save and restore the view state of a Parameter object across multiple requests for the same page. (Geerbt von Parameter)

Methoden

Clone()	Gibt ein Duplikat der aktuellen ControlParameter-Instanz zurück.Returns a duplicate of the current ControlParameter instance.
Equals(Object)	Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object. (Geerbt von Object)
Evaluate(HttpContext, Control)	Aktualisiert den Wert des ControlParameter-Objekts und gibt ihn zurück.Updates and returns the value of the ControlParameter object.
GetDatabaseType()	Ruft den DbType-Wert ab, der dem CLR-Typ der aktuellen Parameter-Instanz entspricht.Gets the DbType value that is equivalent to the CLR type of the current Parameter instance. (Geerbt von Parameter)
GetHashCode()	Fungiert als Standardhashfunktion.Serves as the default hash function. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance. (Geerbt von Object)
LoadViewState(Object)	Stellt den früher gespeicherten Ansichtszustand der Datenquellenansicht wieder her.Restores the data source view's previously saved view state. (Geerbt von Parameter)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object. (Geerbt von Object)
OnParameterChanged()	Ruft die OnParametersChanged(EventArgs)-Methode der ParameterCollection-Auflistung auf, die das Parameter-Objekt enthält.Calls the OnParametersChanged(EventArgs) method of the ParameterCollection collection that contains the Parameter object. (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.Saves the changes to the Parameter object's view state since the time the page was posted back to the server. (Geerbt von Parameter)
SetDirty()	Markiert das Parameter-Objekt, damit sein Zustand im Ansichtszustand aufgezeichnet wird.Marks the Parameter object so its state will be recorded in view state. (Geerbt von Parameter)
ToString()	Konvertiert den Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung.Converts the value of this instance to its equivalent string representation. (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.Causes the Parameter object to track changes to its view state so they can be stored in the control's ViewState object and persisted across requests for the same page. (Geerbt von Parameter)

Explizite Schnittstellenimplementierungen

ICloneable.Clone()	Gibt ein Duplikat der aktuellen Parameter-Instanz zurück.Returns a duplicate of the current Parameter instance. (Geerbt von Parameter)
IStateManager.IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das Parameter-Objekt Änderungen des Ansichtszustands speichert.Gets a value indicating whether the Parameter object is saving changes to its view state. (Geerbt von Parameter)
IStateManager.LoadViewState(Object)	Stellt den früher gespeicherten Ansichtszustand der Datenquellenansicht wieder her.Restores the data source view's previously saved view state. (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.Saves the changes to the Parameter object's view state since the time the page was posted back to the server. (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.Causes the Parameter object to track changes to its view state so they can be stored in the control's ViewState object and persisted across requests for the same page. (Geerbt von Parameter)

Gilt für: