ControlParameter Třída
Definice
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 objektu Control 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
Příklady
Následující příklad kódu ukazuje, jak použít ControlParameter objekt 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 je přidán 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 vlastnosti, například SelectedValue nebo SelectedIndex, s parametrem, který se používá v parametrizovaném dotazu SQL, metodě obchodního Control objektu nebo výrazu filtrování.
Třída ControlParameter poskytuje kromě vlastností zděděných z Parameter třídy dvě vlastnosti: ControlID a PropertyName. Vlastnost ControlID identifikuje, ke které Control instanci se má svázat, a PropertyName vlastnost identifikuje veřejnou vlastnost objektu Control , ze kterého ControlParameter třída načte hodnotu.
Konstruktory
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) |
Inicializuje novou pojmenovanou instanci třídy pomocí zadaného ControlParameter názvu ovládacího prvku k identifikaci ovládacího prvku, který se má svázat. |
ControlParameter(String, String, String) |
Inicializuje novou pojmenovanou instanci třídy pomocí zadaného ControlParameter názvu vlastnosti a názvu ovládacího prvku, který se má svázat. |
ControlParameter(String, TypeCode, String, String) |
Inicializuje novou pojmenovanou instanci třídy silného typu pomocí zadaného ControlParameter názvu vlastnosti a názvu ovládacího prvku k identifikaci ovládacího prvku, který se má svázat. |
Vlastnosti
ControlID |
Určuje název ovládacího prvku, se kterým objekt vytvoří ControlParameter vazbu. |
ConvertEmptyStringToNull |
Získá nebo nastaví hodnotu určující, zda má být hodnota, na kterou Parameter je objekt vázán, převedena, |
DbType |
Získá nebo nastaví typ databáze parametru. (Zděděno od Parameter) |
DefaultValue |
Určuje výchozí hodnotu parametru, pokud hodnota, kterou je parametr vázán být neinicializován 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 na ovládací prvek, nebo zda lze ovládací prvek použít ke změně hodnoty. (Zděděno od Parameter) |
IsTrackingViewState |
Získá hodnotu označující, zda Parameter objekt ukládá změny do svého 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 ovládacího prvku identifikované vlastností ControlID , které ControlParameter objekt váže. |
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 více požadavků na stejnou stránku. (Zděděno od Parameter) |
Metody
Clone() |
Vrátí duplikát aktuální ControlParameter instance. |
Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
Evaluate(HttpContext, Control) |
Aktualizace a vrátí hodnotu objektuControlParameter. |
GetDatabaseType() |
DbType Získá hodnotu, která je ekvivalentní k CLR typ aktuální Parameter instance. (Zděděno od Parameter) |
GetHashCode() |
Slouží jako výchozí hashovací funkce. (Zděděno od Object) |
GetType() |
Získá aktuální Type instanci. (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 Objectsouboru . (Zděděno od Object) |
OnParameterChanged() |
Zavolá metodu OnParametersChanged(EventArgs)ParameterCollection kolekce, která obsahuje Parameter objekt. (Zděděno od Parameter) |
SaveViewState() |
Uloží změny stavu zobrazení objektu Parameter od okamžiku, kdy byla stránka odeslána zpět na server. (Zděděno od Parameter) |
SetDirty() |
Označí Parameter objekt tak, aby jeho stav byl zaznamenán ve stavu zobrazení. (Zděděno od Parameter) |
ToString() |
Převede hodnotu této instance na její odpovídající řetězcovou reprezentaci. (Zděděno od Parameter) |
TrackViewState() |
Způsobí, že Parameter objekt sleduje změny stavu zobrazení, aby je bylo možné uložit do objektu ovládacího prvku ViewState a zachovat v požadavcích na stejnou stránku. (Zděděno od Parameter) |
Explicitní implementace rozhraní
ICloneable.Clone() |
Vrátí duplikát aktuální Parameter instance. (Zděděno od Parameter) |
IStateManager.IsTrackingViewState |
Získá hodnotu označující, zda Parameter objekt ukládá změny do svého 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 stavu zobrazení objektu Parameter od okamžiku, kdy byla stránka odeslána zpět na server. (Zděděno od Parameter) |
IStateManager.TrackViewState() |
Způsobí, že Parameter objekt sleduje změny stavu zobrazení, aby je bylo možné uložit do objektu ovládacího prvku ViewState a zachovat v požadavcích na stejnou stránku. (Zděděno od Parameter) |