ControlParameter Třída

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Vytvoří vazbu hodnoty vlastnosti Control objektu parametru.

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

Dědičnost: Object

Parameter
ControlParameter

Příklady

Následující příklad kódu ukazuje použití objektu ControlParameter k vytvoření vazby dat zobrazených v ovládacím ListBox prvku na vybranou DropDownList hodnotu ovládacího prvku v deklarativním scénáři. Objekt ControlParameter se přidá do SelectParameters kolekce SqlDataSource ovládacího prvku ve formuláři a odpovídá zástupného textu "@Title" ve SelectCommand vlastnosti.

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

Poznámky

Třídu můžete použít ControlParameter k vytvoření vazby hodnoty Control vlastnosti, například SelectedValue nebo SelectedIndex, na parametr, který se používá v parametrizovaném dotazu SQL, metodě obchodního objektu nebo filtrovací výraz.

Třída ControlParameter poskytuje dvě vlastnosti kromě zděděných z Parameter třídy: ControlID a PropertyName. Vlastnost ControlID určuje, která Control instance se má svázat, a PropertyName vlastnost identifikuje veřejnou vlastnost Control , ze které ControlParameter třída načte hodnotu.

Konstruktory

Name	Description
ControlParameter()	Inicializuje novou nepojmenovanou instanci ControlParameter třídy.
ControlParameter(ControlParameter)	Inicializuje novou instanci ControlParameter třídy s hodnotami ze zadané instance.
ControlParameter(String, DbType, String, String)	Inicializuje novou instanci třídy pomocí zadaného ControlParameter názvu parametru, typu databáze, ID ovládacího prvku a názvu vlastnosti.
ControlParameter(String, String, String)	Inicializuje novou pojmenovanou instanci třídy pomocí zadaného ControlParameter názvu vlastnosti a názvu ovládacího prvku k identifikaci, který ovládací prvek se má svázat.
ControlParameter(String, String)	Inicializuje novou pojmenovanou instanci ControlParameter třídy pomocí zadaného názvu ovládacího prvku k identifikaci, který ovládací prvek se má svázat.
ControlParameter(String, TypeCode, String, String)	Inicializuje novou pojmenovanou a silně typovou instanci ControlParameter třídy pomocí zadaného názvu vlastnosti a názvu ovládacího prvku k identifikaci, který ovládací prvek se má svázat.

Vlastnosti

Name	Description
ControlID	Určuje název ovládacího prvku, ke kterému ControlParameter objekt vytvoří vazbu.
ConvertEmptyStringToNull	Získá nebo nastaví hodnotu určující, zda hodnota, na kterou Parameter je objekt vázán, by měla být převedena na `null` , pokud je Empty. (Zděděno od Parameter)
DbType	Získá nebo nastaví typ databáze parametru. (Zděděno od Parameter)
DefaultValue	Určuje výchozí hodnotu parametru, pokud má být parametr vázán na neinicializaci při Evaluate(HttpContext, Control) zavolání metody. (Zděděno od Parameter)
Direction	Určuje, zda Parameter se objekt používá k vytvoření vazby hodnoty k ovládacímu prvku, nebo lze použít ke změně hodnoty. (Zděděno od Parameter)
IsTrackingViewState	Získá hodnotu určující, zda Parameter objekt ukládá změny do jeho stavu zobrazení. (Zděděno od Parameter)
Name	Získá nebo nastaví název parametru. (Zděděno od Parameter)
PropertyName	Získá nebo nastaví název vlastnosti identifikované ControlID vlastností, ke které ControlParameter objekt vytvoří vazbu.
Size	Získá nebo nastaví velikost parametru. (Zděděno od Parameter)
Type	Získá nebo nastaví typ parametru. (Zděděno od Parameter)
ViewState	Získá slovník informací o stavu, který umožňuje uložit a obnovit stav zobrazení objektu Parameter napříč více požadavky na stejnou stránku. (Zděděno od Parameter)

Metody

Name	Description
Clone()	Vrátí duplikát aktuální ControlParameter instance.
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
Evaluate(HttpContext, Control)	Aktualizuje a vrátí hodnotu objektu ControlParameter .
GetDatabaseType()	DbType Získá hodnotu, která je ekvivalentní typu CLR aktuální Parameter instance. (Zděděno od Parameter)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
LoadViewState(Object)	Obnoví dříve uložený stav zobrazení zdroje dat. (Zděděno od Parameter)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
OnParameterChanged()	OnParametersChanged(EventArgs) Volá metodu ParameterCollection kolekce, která obsahuje Parameter objekt. (Zděděno od Parameter)
SaveViewState()	Uloží změny do stavu zobrazení objektu Parameter od doby, kdy byla stránka odeslána zpět na server. (Zděděno od Parameter)
SetDirty()	Parameter Označí objekt tak, aby byl jeho stav zaznamenán ve stavu zobrazení. (Zděděno od Parameter)
ToString()	Převede hodnotu této instance na ekvivalentní řetězcové vyjádření. (Zděděno od Parameter)
TrackViewState()	Způsobí, že Parameter objekt bude sledovat změny jeho stavu zobrazení, aby je bylo možné uložit do objektu ViewState ovládacího prvku a zachovat napříč požadavky na stejnou stránku. (Zděděno od Parameter)

Explicitní implementace rozhraní

Name	Description
ICloneable.Clone()	Vrátí duplikát aktuální Parameter instance. (Zděděno od Parameter)
IStateManager.IsTrackingViewState	Získá hodnotu určující, zda Parameter objekt ukládá změny do jeho stavu zobrazení. (Zděděno od Parameter)
IStateManager.LoadViewState(Object)	Obnoví dříve uložený stav zobrazení zdroje dat. (Zděděno od Parameter)
IStateManager.SaveViewState()	Uloží změny do stavu zobrazení objektu Parameter od doby, kdy byla stránka odeslána zpět na server. (Zděděno od Parameter)
IStateManager.TrackViewState()	Způsobí, že Parameter objekt bude sledovat změny jeho stavu zobrazení, aby je bylo možné uložit do objektu ViewState ovládacího prvku a zachovat napříč požadavky na stejnou stránku. (Zděděno od Parameter)

Platí pro

Viz také

Váš názor

Byla tato stránka užitečná?