FormParameter FormParameter FormParameter FormParameter Class

Definition

Bindet den Wert des Form-Felds einer HTTP-Anforderung an ein Parameterobjekt.Binds the value of an HTTP request Form field to a parameter object.

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
Vererbung
FormParameterFormParameterFormParameterFormParameter

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Daten mithilfe des SqlDataSource -Steuer Elements und einer einfachen ASP.NET-Webseite in eine Datenbank eingefügt werden.The following code example demonstrates how to insert data into a database using the SqlDataSource control and a simple ASP.NET Web page. Die aktuellen Daten in der Datentabelle werden im DropDownList -Steuerelement angezeigt.The current data in the data table is displayed in the DropDownList control. Sie können neue Datensätze hinzufügen, indem Sie TextBox Werte in die Steuerelemente eingeben und auf die Schaltfläche klicken.You can add new records by entering values in the TextBox controls and clicking the button. Wenn auf die Schaltfläche geklickt wird, werden die angegebenen Werte in die Datenbank eingefügt, DropDownList und der wird aktualisiert.When the button is clicked, the specified values are inserted into the database, and the DropDownList is refreshed.

Wichtig

Dieses Beispiel umfasst ein Textfeld, das Benutzereingaben akzeptiert, die ein potenzielles Sicherheitsrisiko darstellen.This example has a text box that accepts user input, which is a potential security threat. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.For more information, see Script Exploits Overview.

<%@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 Form Auflistung an einen Parameter zu binden, der in einer parametrisierten Abfrage oder einem parametrisierten Befehl verwendet wird.You can use the FormParameter class to bind the value of a form variable in the Form collection to a parameter used in a parameterized query or command. Steuerelemente, die Daten an den-Parameter binden, lösen möglich FormParameter erweise eine Ausnahme aus, wenn eine angegeben wird, aber keine entsprechende Formular Variable übergeben wird.Controls that bind data to the parameter might throw an exception if a FormParameter is specified but no corresponding form variable is passed. Möglicherweise werden auch keine Daten angezeigt, wenn die Formular Variable ohne entsprechenden Wert übermittelt wird.They might also display no data if the form variable is passed with no corresponding value. DefaultValue Legen Sie fest, um diese Situationen bei Bedarf zu vermeiden.Set the DefaultValue to avoid these situations where appropriate.

Die FormParameter -Klasse stellt FormField die-Eigenschaft bereit, die den Namen der zu bindenden Formularvariablen, zusätzlich zu den von der Parameter -Klasse geerbten, angibt.The FormParameter class provides the FormField property, which identifies the name of the form variable to bind to, in addition to those inherited from the Parameter class.

Wichtig

Der FormParameter überprüft nicht den Wert, der vom Formular Element in beliebiger Weise übermittelt wird, sondern verwendet den Rohwert.The FormParameter does not validate the value passed by the form element in any way; it uses the raw value. In den meisten Fällen können Sie den Wert von FormParameter validieren, bevor er von einem Datenquellen-Steuerelement verwendet wird, indem ein Ereignis behandelt wird, z. b. das SelectingEreignis, Updating, Insertingoder Deleting , das vom verwendeten Datenquellen-Steuerelement verfügbar gemacht wird.In most cases you can validate the value of the FormParameter before it is used by a data source control by handling an event, such as the Selecting, Updating, Inserting, or Deleting event exposed by the data source control you are using. Wenn der Wert des-Parameters die Validierungstests nicht besteht, können Sie den Daten Vorgang abbrechen, indem Sie Cancel die-Eigenschaft der CancelEventArgs zugeordneten trueKlasse auf festlegen.If the value of the parameter does not pass your validation tests, you can cancel the data operation by setting the Cancel property of the associated CancelEventArgs class to true.

Konstruktoren

FormParameter() FormParameter() FormParameter() FormParameter()

Initialisiert eine neue unbenannte Instanz der FormParameter-Klasse.Initializes a new unnamed instance of the FormParameter class.

FormParameter(FormParameter) FormParameter(FormParameter) FormParameter(FormParameter) FormParameter(FormParameter)

Initialisiert eine neue Instanz der FormParameter-Klasse mit den Werten der Instanz, die vom original-Parameter angegeben wird.Initializes a new instance of the FormParameter class with the values of the instance specified by the original parameter.

FormParameter(String, DbType, String) FormParameter(String, DbType, String) FormParameter(String, DbType, String) 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.Initializes a new instance of the FormParameter class, using the specified string to identify which form variable field to bind to.

FormParameter(String, String) FormParameter(String, String) FormParameter(String, String) 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.Initializes a new named instance of the FormParameter class, using the specified string to identify which form variable field to bind to.

FormParameter(String, TypeCode, String) FormParameter(String, TypeCode, String) FormParameter(String, TypeCode, String) 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.Initializes a new named and strongly typed instance of the FormParameter class, using the specified string to identify which form variable to bind to.

Eigenschaften

ConvertEmptyStringToNull ConvertEmptyStringToNull ConvertEmptyStringToNull ConvertEmptyStringToNull

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob der Wert, an den das Parameter-Objekt gebunden ist, nach null konvertiert werden soll, wenn er Empty ist.Gets or sets a value indicating whether the value that the Parameter object is bound to should be converted to null if it is Empty.

(Inherited from Parameter)
DbType DbType DbType DbType

Ruft den Datenbanktyp des Parameters ab oder legt diesen fest.Gets or sets the database type of the parameter.

(Inherited from Parameter)
DefaultValue DefaultValue DefaultValue 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.Specifies a default value for the parameter, should the value that the parameter is bound to be uninitialized when the Evaluate(HttpContext, Control) method is called.

(Inherited from Parameter)
Direction Direction Direction Direction

Gibt an, ob das Parameter-Objekt zum Binden eines Werts an ein Steuerelement oder das Steuerelement zum Ändern des Werts verwendet werden kann.Indicates whether the Parameter object is used to bind a value to a control, or the control can be used to change the value.

(Inherited from Parameter)
FormField FormField FormField FormField

Ruft den Namen der Formularvariablen ab, an die der Parameter gebunden ist, oder legt diesen fest.Gets or sets the name of the form variable that the parameter binds to.

IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das Parameter-Objekt Änderungen des Ansichtszustands speichert.Gets a value indicating whether the Parameter object is saving changes to its view state.

(Inherited from Parameter)
IsTrackingViewState IsTrackingViewState IsTrackingViewState IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das Parameter-Objekt Änderungen des Ansichtszustands speichert.Gets a value indicating whether the Parameter object is saving changes to its view state.

(Inherited from Parameter)
Name Name Name Name

Ruft den Namen des Parameters ab oder legt diesen fest.Gets or sets the name of the parameter.

(Inherited from Parameter)
Size Size Size Size

Ruft die Größe des Parameters ab oder legt sie fest.Gets or sets the size of the parameter.

(Inherited from Parameter)
Type Type Type Type

Ruft den Typ des Parameters ab oder legt diesen fest.Gets or sets the type of the parameter.

(Inherited from Parameter)
ValidateInput ValidateInput ValidateInput ValidateInput

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob die Clienteingabe in den Parametern überprüft wird.Gets or sets a value that indicates whether the client input in the parameter is validated.

ViewState ViewState ViewState 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.Gets a dictionary of state information that allows you to save and restore the view state of a Parameter object across multiple requests for the same page.

(Inherited from Parameter)

Methoden

Clone() Clone() Clone() Clone()

Gibt ein Duplikat der aktuellen FormParameter-Instanz zurück.Returns a duplicate of the current FormParameter instance.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Evaluate(HttpContext, Control) Evaluate(HttpContext, Control) Evaluate(HttpContext, Control) Evaluate(HttpContext, Control)

Aktualisiert den Wert des FormParameter-Objekts und gibt ihn zurück.Updates and returns the value of the FormParameter object.

GetDatabaseType() GetDatabaseType() GetDatabaseType() GetDatabaseType()

Ruft den DbType-Wert ab, der dem CLR-Typ der aktuellen Parameter-Instanz entspricht.Gets the DbType value that is equivalent to the CLR type of the current Parameter instance.

(Inherited from Parameter)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
LoadViewState(Object) LoadViewState(Object) LoadViewState(Object) LoadViewState(Object)

Stellt den früher gespeicherten Ansichtszustand der Datenquellenansicht wieder her.Restores the data source view's previously saved view state.

(Inherited from Parameter)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
OnParameterChanged() OnParameterChanged() OnParameterChanged() OnParameterChanged()

Ruft die OnParametersChanged(EventArgs)-Methode der ParameterCollection-Auflistung auf, die das Parameter-Objekt enthält.Calls the OnParametersChanged(EventArgs) method of the ParameterCollection collection that contains the Parameter object.

(Inherited from Parameter)
SaveViewState() SaveViewState() SaveViewState() SaveViewState()

Speichert die Änderungen am Ansichtszustand des Parameter-Objekts seit dem Zeitpunkt, zu dem die Seite zurück an den Server gesendet wurde.Saves the changes to the Parameter object's view state since the time the page was posted back to the server.

(Inherited from Parameter)
SetDirty() SetDirty() SetDirty() SetDirty()

Markiert das Parameter-Objekt, damit sein Zustand im Ansichtszustand aufgezeichnet wird.Marks the Parameter object so its state will be recorded in view state.

(Inherited from Parameter)
ToString() ToString() ToString() ToString()

Konvertiert den Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung.Converts the value of this instance to its equivalent string representation.

(Inherited from Parameter)
TrackViewState() TrackViewState() TrackViewState() 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.Causes the Parameter object to track changes to its view state so they can be stored in the control's ViewState object and persisted across requests for the same page.

(Inherited from Parameter)

Explizite Schnittstellenimplementierungen

ICloneable.Clone() ICloneable.Clone() ICloneable.Clone() ICloneable.Clone()

Gibt ein Duplikat der aktuellen Parameter-Instanz zurück.Returns a duplicate of the current Parameter instance.

(Inherited from Parameter)
IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object)

Stellt den früher gespeicherten Ansichtszustand der Datenquellenansicht wieder her.Restores the data source view's previously saved view state.

(Inherited from Parameter)
IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState()

Speichert die Änderungen am Ansichtszustand des Parameter-Objekts seit dem Zeitpunkt, zu dem die Seite zurück an den Server gesendet wurde.Saves the changes to the Parameter object's view state since the time the page was posted back to the server.

(Inherited from Parameter)
IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState() 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.Causes the Parameter object to track changes to its view state so they can be stored in the control's ViewState object and persisted across requests for the same page.

(Inherited from Parameter)

Gilt für:

Siehe auch