FormParameter Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Bindet den Wert des Form-Felds einer HTTP-Anforderung an ein Parameterobjekt.
public ref class FormParameter : System::Web::UI::WebControls::Parameterpublic class FormParameter : System.Web.UI.WebControls.Parametertype FormParameter = class
inherit ParameterPublic Class FormParameter
Inherits Parameter- Vererbung
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie Daten mithilfe des SqlDataSource -Steuerelements und einer einfachen ASP.NET Webseite in eine Datenbank eingefügt werden. Die aktuellen Daten in der Datentabelle werden im DropDownList -Steuerelement angezeigt. Sie können neue Datensätze hinzufügen, indem Sie Werte in die TextBox Steuerelemente eingeben und auf die Schaltfläche klicken. Wenn auf die Schaltfläche geklickt wird, werden die angegebenen Werte in die Datenbank eingefügt und aktualisiert DropDownList .
Wichtig
Dieses Beispiel umfasst ein Textfeld, das Benutzereingaben akzeptiert, die ein potenzielles Sicherheitsrisiko darstellen. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.
<%@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>
Hinweise
Sie können die FormParameter -Klasse verwenden, um den Wert einer Formularvariablen in der Auflistung an einen Parameter zu binden, der Form in einer parametrisierten Abfrage oder einem Befehl verwendet wird. Steuerelemente, die Daten an den Parameter binden, lösen möglicherweise eine Ausnahme aus, wenn angegeben FormParameter ist, aber keine entsprechende Formularvariable übergeben wird. Möglicherweise werden auch keine Daten angezeigt, wenn die Formularvariable ohne entsprechenden Wert übergeben wird. Legen Sie fest DefaultValue , um diese Situationen bei Bedarf zu vermeiden.
Die FormParameter -Klasse stellt die FormField -Eigenschaft bereit, die den Namen der Formularvariablen identifiziert, an die gebunden werden soll, zusätzlich zu den von der Parameter -Klasse geerbten.
Wichtig
Der FormParameter überprüft in keiner Weise den vom formular-Element übergebenen Wert, es verwendet den Rohwert. In den meisten Fällen können Sie den Wert von FormParameter überprüfen, bevor er von einem Datenquellensteuerelement verwendet wird, indem Sie ein Ereignis behandeln, z. B. das SelectingEreignis , Updating, Insertingoder Deleting , das von dem verwendeten Datenquellensteuerelement verfügbar gemacht wird. Wenn der Wert des Parameters Die Validierungstests nicht besteht, können Sie den Datenvorgang abbrechen, indem Sie die Cancel -Eigenschaft der zugeordneten CancelEventArgs Klasse auf truefestlegen.
Konstruktoren
| FormParameter() |
Initialisiert eine neue unbenannte Instanz der FormParameter-Klasse. |
| FormParameter(FormParameter) |
Initialisiert eine neue Instanz der FormParameter-Klasse mit den Werten der Instanz, die vom |
| FormParameter(String, DbType, String) |
Initialisiert eine neue Instanz der FormParameter-Klasse, wobei die angegebene Zeichenfolge verwendet wird, um das Formularvariablenfeld zu identifizieren, an das die Bindung erfolgen soll. |
| FormParameter(String, String) |
Initialisiert eine neue benannte Instanz der FormParameter-Klasse, wobei die angegebene Zeichenfolge verwendet wird, um das Formularvariablenfeld zu identifizieren, an das die Bindung erfolgen soll. |
| FormParameter(String, TypeCode, String) |
Initialisiert eine neue benannte und stark typisierte Instanz der FormParameter-Klasse, wobei die angegebene Zeichenfolge verwendet wird, um die Formularvariable zu identifizieren, an die die Bindung erfolgen soll. |
Eigenschaften
| ConvertEmptyStringToNull |
Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob der Wert, an den das Parameter-Objekt gebunden ist, nach |
| DbType |
Ruft den Datenbanktyp des Parameters ab oder legt diesen fest. (Geerbt von Parameter) |
| DefaultValue |
Gibt einen Standardwert für den Parameter an, wenn der Wert, an den der Parameter gebunden ist, beim Aufrufen der Evaluate(HttpContext, Control)-Methode nicht initialisiert ist. (Geerbt von Parameter) |
| Direction |
Gibt an, ob das Parameter-Objekt zum Binden eines Werts an ein Steuerelement oder das Steuerelement zum Ändern des Werts verwendet werden kann. (Geerbt von Parameter) |
| FormField |
Ruft den Namen der Formularvariablen ab, an die der Parameter gebunden ist, oder legt diesen fest. |
| IsTrackingViewState |
Ruft einen Wert ab, der angibt, ob das Parameter-Objekt Änderungen des Ansichtszustands speichert. (Geerbt von Parameter) |
| Name |
Ruft den Namen des Parameters ab oder legt ihn fest. (Geerbt von Parameter) |
| Size |
Ruft die Größe des Parameters ab oder legt sie fest. (Geerbt von Parameter) |
| Type |
Ruft den Typ des Parameters ab oder legt ihn fest. (Geerbt von Parameter) |
| ValidateInput |
Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob die Clienteingabe in den Parametern überprüft wird. |
| ViewState |
Ruft ein Wörterbuch mit Zustandsinformationen ab, mit dem Sie den Ansichtszustand eines Parameter-Objekts über mehrere Anforderungen für dieselbe Seite hinweg speichern und wiederherstellen können. (Geerbt von Parameter) |
Methoden
| Clone() |
Gibt ein Duplikat der aktuellen FormParameter-Instanz zurück. |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| Evaluate(HttpContext, Control) |
Aktualisiert den Wert des FormParameter-Objekts und gibt ihn zurück. |
| GetDatabaseType() |
Ruft den DbType-Wert ab, der dem CLR-Typ der aktuellen Parameter-Instanz entspricht. (Geerbt von Parameter) |
| GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
| GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
| LoadViewState(Object) |
Stellt den früher gespeicherten Ansichtszustand der Datenquellenansicht wieder her. (Geerbt von Parameter) |
| MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
| OnParameterChanged() |
Ruft die OnParametersChanged(EventArgs)-Methode der ParameterCollection-Auflistung auf, die das Parameter-Objekt enthält. (Geerbt von Parameter) |
| SaveViewState() |
Speichert die Änderungen am Ansichtszustand des Parameter-Objekts seit dem Zeitpunkt, zu dem die Seite zurück an den Server gesendet wurde. (Geerbt von Parameter) |
| SetDirty() |
Markiert das Parameter-Objekt, damit sein Zustand im Ansichtszustand aufgezeichnet wird. (Geerbt von Parameter) |
| ToString() |
Konvertiert den Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung. (Geerbt von Parameter) |
| TrackViewState() |
Bewirkt, dass das Parameter-Objekt Änderungen an ihrem Ansichtszustand nachverfolgt, damit sie im ViewState-Objekt des Steuerelements gespeichert und über Anforderungen der gleichen Seite hinweg beibehalten werden. (Geerbt von Parameter) |
Explizite Schnittstellenimplementierungen
| ICloneable.Clone() |
Gibt ein Duplikat der aktuellen Parameter-Instanz zurück. (Geerbt von Parameter) |
| IStateManager.IsTrackingViewState |
Ruft einen Wert ab, der angibt, ob das Parameter-Objekt Änderungen des Ansichtszustands speichert. (Geerbt von Parameter) |
| IStateManager.LoadViewState(Object) |
Stellt den früher gespeicherten Ansichtszustand der Datenquellenansicht wieder her. (Geerbt von Parameter) |
| IStateManager.SaveViewState() |
Speichert die Änderungen am Ansichtszustand des Parameter-Objekts seit dem Zeitpunkt, zu dem die Seite zurück an den Server gesendet wurde. (Geerbt von Parameter) |
| IStateManager.TrackViewState() |
Bewirkt, dass das Parameter-Objekt Änderungen an ihrem Ansichtszustand nachverfolgt, damit sie im ViewState-Objekt des Steuerelements gespeichert und über Anforderungen der gleichen Seite hinweg beibehalten werden. (Geerbt von Parameter) |
