ControlParameter Klass

Definition

Namnområde:: System.Web.UI.WebControls

Sammansättning:: System.Web.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Binder värdet för en egenskap för en Control till ett 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

Arv: Object

Parameter
ControlParameter

Exempel

Följande kodexempel visar hur du använder ett ControlParameter objekt för att binda data som visas i en ListBox kontroll till det valda värdet för en DropDownList kontroll i ett deklarativt scenario. Objektet ControlParameter läggs till i SelectParameters kontrollens SqlDataSource samling i formuläret och motsvarar platshållartexten "@Title" i SelectCommand egenskapen.

<!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>

Kommentarer

Du kan använda ControlParameter klassen för att binda värdet för en Control egenskap, till exempel SelectedValue eller SelectedIndex, till en parameter som används i en parameteriserad SQL-fråga, affärsobjektmetod eller filtreringsuttryck.

Klassen ControlParameter innehåller två egenskaper utöver de som ärvts Parameter från klassen: ControlID och PropertyName. Egenskapen ControlID identifierar vilken instans som Control ska bindas till och PropertyName egenskapen identifierar den offentliga egenskapen Control för den som klassen hämtar ett värde från ControlParameter .

Konstruktorer

Name	Description
ControlParameter()	Initierar en ny namnlös instans av ControlParameter klassen.
ControlParameter(ControlParameter)	Initierar en ny instans av ControlParameter klassen med värden från den angivna instansen.
ControlParameter(String, DbType, String, String)	Initierar en ny instans av ControlParameter klassen med hjälp av det angivna parameternamnet, databastypen, kontroll-ID och egenskapsnamnet.
ControlParameter(String, String, String)	Initierar en ny namngiven ControlParameter instans av klassen med det angivna egenskapsnamnet och kontrollnamnet för att identifiera vilken kontroll som ska bindas till.
ControlParameter(String, String)	Initierar en ny namngiven ControlParameter instans av klassen med det angivna kontrollnamnet för att identifiera vilken kontroll som ska bindas till.
ControlParameter(String, TypeCode, String, String)	Initierar en ny namngiven ControlParameter och starkt typinstans av klassen med det angivna egenskapsnamnet och kontrollnamnet för att identifiera vilken kontroll som ska bindas till.

Egenskaper

Name	Description
ControlID	Anger namnet på den kontroll som ControlParameter objektet binder till.
ConvertEmptyStringToNull	Hämtar eller anger ett värde som anger om värdet som objektet är bundet Parameter till ska konverteras till `null` om det är Empty. (Ärvd från Parameter)
DbType	Hämtar eller anger parameterns databastyp. (Ärvd från Parameter)
DefaultValue	Anger ett standardvärde för parametern om värdet som parametern är bunden till är onitialiserat när Evaluate(HttpContext, Control) metoden anropas. (Ärvd från Parameter)
Direction	Anger om objektet Parameter används för att binda ett värde till en kontroll eller om kontrollen kan användas för att ändra värdet. (Ärvd från Parameter)
IsTrackingViewState	Hämtar ett värde som anger om Parameter objektet sparar ändringar i visningstillståndet. (Ärvd från Parameter)
Name	Hämtar eller anger namnet på parametern. (Ärvd från Parameter)
PropertyName	Hämtar eller anger egenskapsnamnet för kontrollen som identifieras av egenskapen ControlID som ControlParameter objektet binder till.
Size	Hämtar eller anger parameterns storlek. (Ärvd från Parameter)
Type	Hämtar eller anger parametertypen. (Ärvd från Parameter)
ViewState	Hämtar en ordlista med tillståndsinformation som gör att du kan spara och återställa visningstillståndet för ett Parameter objekt över flera begäranden för samma sida. (Ärvd från Parameter)

Metoder

Name	Description
Clone()	Returnerar en dubblett av den aktuella ControlParameter instansen.
Equals(Object)	Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object)
Evaluate(HttpContext, Control)	Uppdaterar och returnerar objektets ControlParameter värde.
GetDatabaseType()	Hämtar värdet DbType som motsvarar CLR-typen för den aktuella Parameter instansen. (Ärvd från Parameter)
GetHashCode()	Fungerar som standard-hash-funktion. (Ärvd från Object)
GetType()	Hämtar den aktuella instansen Type . (Ärvd från Object)
LoadViewState(Object)	Återställer datakällans tidigare sparade vytillstånd. (Ärvd från Parameter)
MemberwiseClone()	Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object)
OnParameterChanged()	Anropar metoden för OnParametersChanged(EventArgs) samlingen ParameterCollection som innehåller Parameter objektet. (Ärvd från Parameter)
SaveViewState()	Sparar ändringarna i Parameter objektets visningstillstånd sedan den tid då sidan publicerades tillbaka till servern. (Ärvd från Parameter)
SetDirty()	Parameter Markerar objektet så att dess tillstånd registreras i visningstillstånd. (Ärvd från Parameter)
ToString()	Konverterar värdet för den här instansen till motsvarande strängrepresentation. (Ärvd från Parameter)
TrackViewState()	Parameter Gör att objektet spårar ändringar i dess visningstillstånd så att de kan lagras i kontrollens ViewState objekt och sparas mellan begäranden för samma sida. (Ärvd från Parameter)

Explicita gränssnittsimplementeringar

Name	Description
ICloneable.Clone()	Returnerar en dubblett av den aktuella Parameter instansen. (Ärvd från Parameter)
IStateManager.IsTrackingViewState	Hämtar ett värde som anger om Parameter objektet sparar ändringar i visningstillståndet. (Ärvd från Parameter)
IStateManager.LoadViewState(Object)	Återställer datakällans tidigare sparade vytillstånd. (Ärvd från Parameter)
IStateManager.SaveViewState()	Sparar ändringarna i Parameter objektets visningstillstånd sedan den tid då sidan publicerades tillbaka till servern. (Ärvd från Parameter)
IStateManager.TrackViewState()	Parameter Gör att objektet spårar ändringar i dess visningstillstånd så att de kan lagras i kontrollens ViewState objekt och sparas mellan begäranden för samma sida. (Ärvd från Parameter)

Gäller för

Se även

Feedback

Var den här sidan till hjälp?