FormParameter 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 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 TextBox ovládacích 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 vstup uživatele neobsahuje skripty ani elementy HTML. Další informace naleznete 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 k vytvoření vazby FormParameter hodnoty proměnné formuláře v Form kolekci na parametr použitý v parametrizovaném dotazu nebo příkazu. Ovládací prvky, které sváže data s parametrem, mohou vyvolat výjimku, pokud FormParameter je zadán, ale není předána žádná odpovídající proměnná formuláře. Mohou také zobrazit žádná data, pokud je proměnná formuláře předána bez odpovídající hodnoty. DefaultValue Nastavte, aby se těmto situacím v případě potřeby zabránilo.

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

Důležité

Neověřuje FormParameter hodnotu předanou elementem formuláře žádným způsobem; používá nezpracovanou hodnotu. Ve většině případů můžete ověřit hodnotu FormParameter před tím, než ji použije ovládací prvek zdroje dat, zpracováním události, jako Selectingje například , Updatingnebo InsertingDeleting událost vystavená ovládacím prvku 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 true.

Konstruktory

Name	Description
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 FormParameter třídy pomocí zadaného řetězce k identifikaci pole proměnné formuláře, které se má svázat.
FormParameter(String, TypeCode, String)	Inicializuje novou pojmenovanou a silně typovou instanci FormParameter třídy pomocí zadaného řetězce k identifikaci proměnné formuláře, ke které se má vytvořit vazba.

Vlastnosti

Name	Description
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)
FormField	Získá nebo nastaví název proměnné formuláře, ke které parametr vytvoří vazbu.
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)
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á určuje, zda je vstup klienta v parametru ověřen.
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í FormParameter 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 FormParameter .
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á?

Sdílet prostřednictvím

FormParameter Třída

Definice

Příklady

Poznámky

Konstruktory

Vlastnosti

Metody

Explicitní implementace rozhraní

Platí pro

Viz také

Váš názor