FormParameter Třída

Reference

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 pole požadavku Form HTTP na objekt parametru.

public ref class FormParameter : System::Web::UI::WebControls::Parameter

public class FormParameter : System.Web.UI.WebControls.Parameter

type FormParameter = class
    inherit Parameter

Public Class FormParameter
Inherits Parameter

Dědičnost: Object

Parameter
FormParameter

Příklady

Následující příklad kódu ukazuje, jak vložit data do databáze pomocí SqlDataSource ovládacího prvku a jednoduché ASP.NET webové stránky. Aktuální data v tabulce dat se zobrazí v ovládacím DropDownList prvku. Nové záznamy můžete přidat zadáním hodnot do ovládacích TextBox prvků a kliknutím na tlačítko. Po kliknutí na tlačítko se zadané hodnoty vloží do databáze a DropDownList aktualizuje se.

Důležité

Tento příklad obsahuje textové pole, které přijímá vstup uživatele, což je potenciální bezpečnostní hrozba. Ve výchozím nastavení ASP.NET webové stránky ověřují, že uživatelský vstup neobsahuje skript nebo elementy HTML. Další informace najdete v tématu Přehled zneužití skriptů.

<%@Page  Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
private void InsertShipper (object source, EventArgs e) {
  SqlDataSource1.Insert();
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:dropdownlist
        id="DropDownList1"
        runat="server"
        datasourceid="SqlDataSource1"
        datatextfield="CompanyName"
        datavaluefield="ShipperID" />

<!-- Security Note: The SqlDataSource uses a FormParameter,
     Security Note: which does not perform validation of input from the client.
     Security Note: To validate the value of the FormParameter, handle the Inserting event. -->

      <asp:sqldatasource
        id="SqlDataSource1"
        runat="server"
        connectionstring="<%$ ConnectionStrings:MyNorthwind %>"
        selectcommand="SELECT CompanyName,ShipperID FROM Shippers"
        insertcommand="INSERT INTO Shippers (CompanyName,Phone) VALUES (@CoName,@Phone)">
          <insertparameters>
            <asp:formparameter name="CoName" formfield="CompanyNameBox" />
            <asp:formparameter name="Phone"  formfield="PhoneBox" />
          </insertparameters>
      </asp:sqldatasource>

      <br /><asp:textbox
           id="CompanyNameBox"
           runat="server" />

      <asp:RequiredFieldValidator
        id="RequiredFieldValidator1"
        runat="server"
        ControlToValidate="CompanyNameBox"
        Display="Static"
        ErrorMessage="Please enter a company name." />

      <br /><asp:textbox
           id="PhoneBox"
           runat="server" />

      <asp:RequiredFieldValidator
        id="RequiredFieldValidator2"
        runat="server"
        ControlToValidate="PhoneBox"
        Display="Static"
        ErrorMessage="Please enter a phone number." />

      <br /><asp:button
           id="Button1"
           runat="server"
           text="Insert New Shipper"
           onclick="InsertShipper" />

    </form>
  </body>
</html>

<%@Page  Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
Private Sub InsertShipper (ByVal Source As Object, ByVal e As EventArgs)
  SqlDataSource1.Insert()
End Sub ' InsertShipper
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:dropdownlist
        id="DropDownList1"
        runat="server"
        datasourceid="SqlDataSource1"
        datatextfield="CompanyName"
        datavaluefield="ShipperID" />

<!-- Security Note: The SqlDataSource uses a FormParameter,
     Security Note: which does not perform validation of input from the client.
     Security Note: To validate the value of the FormParameter, handle the Inserting event. -->

      <asp:sqldatasource
        id="SqlDataSource1"
        runat="server"
        connectionstring="<%$ ConnectionStrings:MyNorthwind %>"
        selectcommand="SELECT CompanyName,ShipperID FROM Shippers"
        insertcommand="INSERT INTO Shippers (CompanyName,Phone) VALUES (@CoName,@Phone)">
          <insertparameters>
            <asp:formparameter name="CoName" formfield="CompanyNameBox" />
            <asp:formparameter name="Phone"  formfield="PhoneBox" />
          </insertparameters>
      </asp:sqldatasource>

      <br /><asp:textbox
           id="CompanyNameBox"
           runat="server" />

      <asp:RequiredFieldValidator
        id="RequiredFieldValidator1"
        runat="server"
        ControlToValidate="CompanyNameBox"
        Display="Static"
        ErrorMessage="Please enter a company name." />

      <br /><asp:textbox
           id="PhoneBox"
           runat="server" />

      <asp:RequiredFieldValidator
        id="RequiredFieldValidator2"
        runat="server"
        ControlToValidate="PhoneBox"
        Display="Static"
        ErrorMessage="Please enter a phone number." />

      <br /><asp:button
           id="Button1"
           runat="server"
           text="Insert New Shipper"
           onclick="InsertShipper" />

    </form>
  </body>
</html>

Poznámky

Třídu můžete použít FormParameter k vytvoření vazby hodnoty proměnné formuláře v kolekci Form s parametrem použitým v parametrizovaném dotazu nebo příkazu. Ovládací prvky, které sváže data s parametrem, můžou vyvolat výjimku, pokud FormParameter je zadána, ale není předána žádná odpovídající proměnná formuláře. Můžou také zobrazit žádná data, pokud je proměnná formuláře předána bez odpovídající hodnoty. DefaultValue Pokud je to vhodné, nastavte parametr , abyste se těmto situacím vyhnuli.

Třída FormParameter poskytuje FormField vlastnost, která identifikuje název proměnné formuláře, která se má svázat, kromě těch zděděných z Parameter třídy.

Důležité

Nástroj FormParameter nijak neověřuje hodnotu předanou elementem form; používá nezpracovanou hodnotu. Ve většině případů můžete hodnotu FormParameter před použitím správy zdrojů dat ověřit zpracováním události, jako InsertingSelectingUpdatingje , nebo Deleting událost vystavená ovládacím prvek zdroje dat, který používáte. Pokud hodnota parametru neprojde ověřovacími testy, můžete operaci dat zrušit nastavením Cancel vlastnosti přidružené CancelEventArgs třídy na truehodnotu .

Konstruktory

FormParameter()	Inicializuje novou nepojmenovanou instanci FormParameter třídy.
FormParameter(FormParameter)	Inicializuje novou instanci FormParameter třídy s hodnotami instance určené parametrem `original` .
FormParameter(String, DbType, String)	Inicializuje novou instanci třídy pomocí zadaného FormParameter řetězce k identifikaci pole proměnné formuláře, které se má svázat.
FormParameter(String, String)	Inicializuje novou pojmenovanou instanci třídy pomocí zadaného FormParameter řetězce k identifikaci pole proměnné formuláře, které se má svázat.
FormParameter(String, TypeCode, String)	Inicializuje novou pojmenovanou instanci třídy silného typu pomocí zadaného FormParameter řetězce k identifikaci proměnné formuláře, která se má svázat.

Vlastnosti

ConvertEmptyStringToNull	Získá nebo nastaví hodnotu určující, zda má být hodnota, na kterou Parameter je objekt vázán, převedena, `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 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)
FormField	Získá nebo nastaví název proměnné formuláře, se kterou parametr vytvoří vazbu.
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)
Size	Získá nebo nastaví velikost parametru. (Zděděno od Parameter)
Type	Získá nebo nastaví typ parametru. (Zděděno od Parameter)
ValidateInput	Získá nebo nastaví hodnotu, která označuje, zda vstup klienta v parametru je ověřen.
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í FormParameter 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 objektuFormParameter.
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)

Platí pro

FormParameter Třída

Definice

Příklady

Poznámky

Konstruktory

Vlastnosti

Metody

Explicitní implementace rozhraní

Platí pro

Viz také

Váš názor

Další materiály