ControlParameter ControlParameter ControlParameter ControlParameter Class

Definition

Namespace:: System.Web.UI.WebControls System.Web.UI.WebControls System.Web.UI.WebControls 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: ObjectObjectObjectObject
ParameterParameterParameterParameter
ControlParameterControlParameterControlParameterControlParameter

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein ControlParameter -Objekt verwendet wird, um in ListBox einem-Steuerelement angezeigte Daten 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@Titledem Formular hinzugefügt und entspricht dem 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 SelectedValue . b SelectedIndex. oder, 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 Parameter -Klasse geerbt ControlID werden, zwei Eigenschaften bereit: und PropertyName.The ControlParameter class provides two properties in addition to those inherited from the Parameter class: ControlID and PropertyName. Die ControlID -Eigenschaft Control identifiziert die Instanz, an die die PropertyName Bindung erfolgen soll, und die- Control Eigenschaft identifiziert die ControlParameter öffentliche-Eigenschaft des, von dem die-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() ControlParameter() ControlParameter() ControlParameter()	Initialisiert eine neue unbenannte Instanz der ControlParameter-Klasse.Initializes a new unnamed instance of the ControlParameter class.
ControlParameter(ControlParameter) ControlParameter(ControlParameter) ControlParameter(ControlParameter) 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) ControlParameter(String, DbType, String, String) ControlParameter(String, DbType, String, String) 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) ControlParameter(String, String) ControlParameter(String, String) 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) ControlParameter(String, String, String) ControlParameter(String, String, String) 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) ControlParameter(String, TypeCode, String, String) ControlParameter(String, TypeCode, String, String) 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 ControlID ControlID 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 ConvertEmptyStringToNull ConvertEmptyStringToNull 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. (Inherited from Parameter)
DbType DbType DbType DbType	Ruft den Datenbanktyp des Parameters ab oder legt diesen fest.Gets or sets the database type of the parameter. (Inherited from Parameter)
DefaultValue DefaultValue DefaultValue 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. (Inherited from Parameter)
Direction Direction Direction 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. (Inherited from Parameter)
IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState 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. (Inherited from Parameter)
IsTrackingViewState IsTrackingViewState IsTrackingViewState 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. (Inherited from Parameter)
Name Name Name Name	Ruft den Namen des Parameters ab oder legt diesen fest.Gets or sets the name of the parameter. (Inherited from Parameter)
PropertyName PropertyName PropertyName 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 Size Size Size	Ruft die Größe des Parameters ab oder legt sie fest.Gets or sets the size of the parameter. (Inherited from Parameter)
Type Type Type Type	Ruft den Typ des Parameters ab oder legt diesen fest.Gets or sets the type of the parameter. (Inherited from Parameter)
ViewState ViewState ViewState 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. (Inherited from Parameter)

Methoden

Clone() Clone() Clone() Clone()	Gibt ein Duplikat der aktuellen ControlParameter-Instanz zurück.Returns a duplicate of the current ControlParameter instance.
Equals(Object) Equals(Object) Equals(Object) Equals(Object)	Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object. (Inherited from Object)
Evaluate(HttpContext, Control) Evaluate(HttpContext, Control) Evaluate(HttpContext, Control) Evaluate(HttpContext, Control)	Aktualisiert den Wert des ControlParameter-Objekts und gibt ihn zurück.Updates and returns the value of the ControlParameter object.
GetDatabaseType() GetDatabaseType() GetDatabaseType() 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. (Inherited from Parameter)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()	Fungiert als Standardhashfunktion.Serves as the default hash function. (Inherited from Object)
GetType() GetType() GetType() GetType()	Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance. (Inherited from Object)
LoadViewState(Object) LoadViewState(Object) LoadViewState(Object) LoadViewState(Object)	Stellt den früher gespeicherten Ansichtszustand der Datenquellenansicht wieder her.Restores the data source view's previously saved view state. (Inherited from Parameter)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object. (Inherited from Object)
OnParameterChanged() OnParameterChanged() OnParameterChanged() 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. (Inherited from Parameter)
SaveViewState() SaveViewState() SaveViewState() 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. (Inherited from Parameter)
SetDirty() SetDirty() SetDirty() 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. (Inherited from Parameter)
ToString() ToString() ToString() ToString()	Konvertiert den Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung.Converts the value of this instance to its equivalent string representation. (Inherited from Parameter)
TrackViewState() TrackViewState() TrackViewState() 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. (Inherited from Parameter)

Explizite Schnittstellenimplementierungen

ICloneable.Clone() ICloneable.Clone() ICloneable.Clone() ICloneable.Clone()	Gibt ein Duplikat der aktuellen Parameter-Instanz zurück.Returns a duplicate of the current Parameter instance. (Inherited from Parameter)
IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object)	Stellt den früher gespeicherten Ansichtszustand der Datenquellenansicht wieder her.Restores the data source view's previously saved view state. (Inherited from Parameter)
IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState() 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. (Inherited from Parameter)
IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState() 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. (Inherited from Parameter)