FormParameter Osztály

Definíció

Névtér:: System.Web.UI.WebControls

Szerelvény:: System.Web.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Egy HTTP-kérelemmező Form értékét egy paraméterobjektumhoz köti.

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

Öröklődés: Object

Parameter
FormParameter

Példák

Az alábbi példakód bemutatja, hogyan szúrhat be adatokat egy adatbázisba a SqlDataSource vezérlőelem és egy egyszerű ASP.NET weblap használatával. Az adattábla aktuális adatai megjelennek a DropDownList vezérlőben. Új rekordokat úgy vehet fel, hogy beírja az értékeket a TextBox vezérlőkbe, majd a gombra kattint. Amikor a gombra kattint, a megadott értékek be lesznek szúrva az adatbázisba, és frissülnek DropDownList .

Important

Ebben a példában egy szövegdoboz található, amely elfogadja a felhasználói bemenetet, ami potenciális biztonsági fenyegetés. Alapértelmezés szerint ASP.NET weblapok ellenőrzik, hogy a felhasználói bevitel nem tartalmaz-e szkript- vagy HTML-elemeket. További információ: Szkript kihasználása – áttekintés.

<%@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>

Megjegyzések

Az FormParameter osztály használatával a gyűjteményben lévő Form űrlapváltozó értékét egy paraméteres lekérdezésben vagy parancsban használt paraméterhez kötheti. A paraméterhez adatokat kötő vezérlők kivételt jelenthetnek, ha van megadva, FormParameter de nem ad át megfelelő űrlapváltozót. Ha az űrlapváltozó megfelelő érték nélkül van átadva, akkor nem jelenhetnek meg adatok. Adja meg, DefaultValue hogy szükség esetén elkerülje ezeket a helyzeteket.

Az FormParameter osztály biztosítja a FormField tulajdonságot, amely az osztálytól Parameter örököltek mellett azonosítja a kötéshez kötődő űrlapváltozó nevét.

Important

A FormParameter rendszer semmilyen módon nem ellenőrzi az űrlapelem által átadott értéket; a nyers értéket használja. A legtöbb esetben az adatforrás-vezérlők által használt előttek FormParameter értékét ellenőrizheti egy esemény, például a SelectingUpdatingInsertingDeleting használt adatforrás-vezérlő által közzétett esemény kezelésével. Ha a paraméter értéke nem felel meg az érvényesítési teszteknek, a társított Cancel osztály CancelEventArgstulajdonságának beállításával true megszakíthatja az adatműveletet.

Konstruktorok

Name	Description
FormParameter()	Inicializálja az osztály új, meg nem nevezett példányát FormParameter .
FormParameter(FormParameter)	Inicializálja az FormParameter osztály új példányát a paraméter által `original` megadott példány értékeivel.
FormParameter(String, DbType, String)	Inicializálja az FormParameter osztály új példányát a megadott sztring használatával annak meghatározásához, hogy melyik űrlapváltozómezőhöz kell csatlakozni.
FormParameter(String, String)	Inicializálja az FormParameter osztály új nevesített példányát a megadott sztring használatával annak azonosításához, hogy melyik űrlapváltozómezőhöz kell csatlakozni.
FormParameter(String, TypeCode, String)	Inicializálja az FormParameter osztály új nevesített és erősen gépelt példányát a megadott sztring használatával annak azonosításához, hogy melyik űrlapváltozóhoz kell csatlakozni.

Tulajdonságok

Name	Description
ConvertEmptyStringToNull	Lekéri vagy beállít egy értéket, amely jelzi, hogy az Parameter objektumhoz kötött értéket konvertálni `null` kell-e, ha igen Empty. (Öröklődés forrása Parameter)
DbType	Lekéri vagy beállítja a paraméter adatbázistípusát. (Öröklődés forrása Parameter)
DefaultValue	A paraméter alapértelmezett értékét adja meg, ha a metódus meghívásakor Evaluate(HttpContext, Control) a paraméter nem inicializálódik. (Öröklődés forrása Parameter)
Direction	Azt jelzi, hogy az Parameter objektum egy vezérlőelemhez köti-e az értéket, vagy a vezérlőelem használható az érték módosítására. (Öröklődés forrása Parameter)
FormField	Lekéri vagy beállítja annak az űrlapváltozónak a nevét, amelyhez a paraméter kapcsolódik.
IsTrackingViewState	Beolvas egy értéket, amely jelzi, hogy az Parameter objektum menti-e a nézetállapot módosításait. (Öröklődés forrása Parameter)
Name	Lekéri vagy beállítja a paraméter nevét. (Öröklődés forrása Parameter)
Size	Lekéri vagy beállítja a paraméter méretét. (Öröklődés forrása Parameter)
Type	Lekéri vagy beállítja a paraméter típusát. (Öröklődés forrása Parameter)
ValidateInput	Lekéri vagy beállít egy értéket, amely jelzi, hogy a paraméter ügyfélbemenete érvényesítve van-e.
ViewState	Lekéri az állapotinformációk szótárát, amely lehetővé teszi egy objektum nézetállapotának mentését és visszaállítását Parameter ugyanazon lap több kérésében. (Öröklődés forrása Parameter)

Metódusok

Name	Description
Clone()	Az aktuális FormParameter példány duplikátumát adja vissza.
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
Evaluate(HttpContext, Control)	Frissíti és visszaadja az FormParameter objektum értékét.
GetDatabaseType()	Lekéri az DbType aktuális Parameter példány CLR-típusával egyenértékű értéket. (Öröklődés forrása Parameter)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
LoadViewState(Object)	Visszaállítja az adatforrásnézet korábban mentett nézetállapotát. (Öröklődés forrása Parameter)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
OnParameterChanged()	Meghívja OnParametersChanged(EventArgs) az ParameterCollection objektumot tartalmazó gyűjtemény metódusátParameter. (Öröklődés forrása Parameter)
SaveViewState()	Menti az Parameter objektum nézetállapotának módosításait a lap kiszolgálóra való visszatérése óta. (Öröklődés forrása Parameter)
SetDirty()	Megjelöli az Parameter objektumot, hogy az állapota megtekintési állapotban legyen rögzítve. (Öröklődés forrása Parameter)
ToString()	A példány értékét a megfelelő sztring-ábrázolásúvá alakítja. (Öröklődés forrása Parameter)
TrackViewState()	Ez azt eredményezi, hogy az Parameter objektum nyomon követi a nézetállapot változásait, hogy azok a vezérlő ViewState objektumában tárolhatók legyenek, és ugyanazon lap kérései között megmaradjanak. (Öröklődés forrása Parameter)

Explicit interfész-implementációk

Name	Description
ICloneable.Clone()	Az aktuális Parameter példány duplikátumát adja vissza. (Öröklődés forrása Parameter)
IStateManager.IsTrackingViewState	Beolvas egy értéket, amely jelzi, hogy az Parameter objektum menti-e a nézetállapot módosításait. (Öröklődés forrása Parameter)
IStateManager.LoadViewState(Object)	Visszaállítja az adatforrásnézet korábban mentett nézetállapotát. (Öröklődés forrása Parameter)
IStateManager.SaveViewState()	Menti az Parameter objektum nézetállapotának módosításait a lap kiszolgálóra való visszatérése óta. (Öröklődés forrása Parameter)
IStateManager.TrackViewState()	Ez azt eredményezi, hogy az Parameter objektum nyomon követi a nézetállapot változásait, hogy azok a vezérlő ViewState objektumában tárolhatók legyenek, és ugyanazon lap kérései között megmaradjanak. (Öröklődés forrása Parameter)

A következőre érvényes:

Lásd még

Visszajelzés

Hasznosnak találta ezt az oldalt?