FormParameter Konstruktoren

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

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.

Initialisiert eine neue Instanz der FormParameter-Klasse.

Überlädt

Name	Beschreibung
FormParameter()	Initialisiert eine neue unbenannte Instanz der FormParameter Klasse.
FormParameter(FormParameter)	Initialisiert eine neue Instanz der FormParameter Klasse mit den Werten der vom Parameter angegebenen `original` Instanz.
FormParameter(String, String)	Initialisiert eine neue benannte Instanz der Klasse mithilfe der FormParameter angegebenen Zeichenfolge, um zu identifizieren, an welches Formularvariablenfeld gebunden werden soll.
FormParameter(String, DbType, String)	Initialisiert eine neue Instanz der FormParameter Klasse, wobei die angegebene Zeichenfolge verwendet wird, um zu identifizieren, an welches Formularvariablenfeld gebunden werden soll.
FormParameter(String, TypeCode, String)	Initialisiert eine neue benannte und stark typierte Instanz der FormParameter Klasse, wobei die angegebene Zeichenfolge verwendet wird, um zu identifizieren, an welche Formularvariable gebunden werden soll.

FormParameter()

Initialisiert eine neue unbenannte Instanz der FormParameter Klasse.

public:
 FormParameter();

public FormParameter();

Public Sub New ()

Beispiele

Von Bedeutung

Der FormParameter wert, der vom Formularelement übergeben wird, wird nicht überprüft; er verwendet den Rohwert. In den meisten Fällen können Sie den Wert der FormParameter Datenquelle überprüfen, bevor sie von einem Datenquellensteuerelement verwendet wird, indem Sie ein Ereignis behandeln, z. B. das Selecting, Updating, Insertingoder Deleting das Ereignis, das von dem verwendeten Datenquellensteuerelement verfügbar gemacht wird. Wenn der Wert des Parameters ihre Überprüfungstests nicht bestanden, können Sie den Datenvorgang abbrechen, indem Sie die Cancel Eigenschaft der zugeordneten CancelEventArgs Klasse auf truefestlegen.

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

void Page_Load(Object sender, EventArgs e){

  // You can add a FormParameter to the AccessDataSource control's
  // SelectParameters collection programmatically.
  AccessDataSource1.SelectParameters.Clear();

  // Security Note: The AccessDataSource uses a FormParameter,
  // Security Note: which does not perform validation of input from the client.
  // Security Note: To validate the value of the FormParameter,
  // Security Note: handle the Selecting event.

  FormParameter formParam = new FormParameter();
  formParam.Name="lastname";
  formParam.Type=TypeCode.String;
  formParam.FormField="LastNameBox";
  AccessDataSource1.SelectParameters.Add(formParam);
}
</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:accessdatasource
          id="AccessDataSource1"
          runat="server"
          datasourcemode="DataSet"
          datafile="Northwind.mdb"
          selectcommand="SELECT OrderID,CustomerID,OrderDate,RequiredDate,ShippedDate
                         FROM Orders WHERE EmployeeID =
                         (SELECT EmployeeID FROM Employees WHERE LastName = @lastname)">
      </asp:accessdatasource>

      <br />Enter the name "Davolio" or "King" in the text box and click the button.

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

      <br />
      <asp:button
        id="Button1"
        runat="server"
        text="Get Records" />

      <br />
      <asp:gridview
          id="GridView1"
          runat="server"
          allowsorting="True"
          datasourceid="AccessDataSource1" />

    </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 Page_Load(sender As Object, e As EventArgs)

  ' You can add a FormParameter to the AccessDataSource control's
  ' SelectParameters collection programmatically.
  AccessDataSource1.SelectParameters.Clear()

  ' Security Note: The AccessDataSource uses a FormParameter,
  ' Security Note: which does not perform validation of input from the client.
  ' Security Note: To validate the value of the FormParameter,
  ' Security Note: handle the Selecting event.
  Dim formParam As New FormParameter()
  formParam.Name="lastname"
  formParam.Type=TypeCode.String
  formParam.FormField="LastNameBox"
  AccessDataSource1.SelectParameters.Add(formParam)

End Sub ' Page_Load

</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:accessdatasource
          id="AccessDataSource1"
          runat="server"
          datasourcemode="DataSet"
          datafile="Northwind.mdb"
          selectcommand="SELECT OrderID,CustomerID,OrderDate,RequiredDate,ShippedDate
                         FROM Orders WHERE EmployeeID =
                         (SELECT EmployeeID FROM Employees WHERE LastName = @lastname)">
      </asp:accessdatasource>

      <br />Enter the name "Davolio" or "King" in the text box and click the button.

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

      <br />
      <asp:button
        id="Button1"
        runat="server"
        text="Get Records" />

      <br />
      <asp:gridview
          id="GridView1"
          runat="server"
          allowsorting="True"
          datasourceid="AccessDataSource1" />

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

Hinweise

Ein mit dem FormParameter Konstruktor erstelltes FormParameter Objekt wird mit Standardwerten für alle zugehörigen Eigenschaften initialisiert. Die FormField Initialisierung erfolgt in String.Empty. Darüber hinaus wird die Name Eigenschaft initialisiert in String.Empty, die Type Eigenschaft wird initialisiert in TypeCode.Object, die Direction Eigenschaft wird initialisiert in , und die DefaultValue Eigenschaft wird in NULL initialisiert Input(Nothing in Visual Basic).

Weitere Informationen

Verwenden von Parametern mit Datenquellensteuerelementen

Gilt für:

FormParameter(FormParameter)

Initialisiert eine neue Instanz der FormParameter Klasse mit den Werten der vom Parameter angegebenen original Instanz.

protected:
 FormParameter(System::Web::UI::WebControls::FormParameter ^ original);

protected FormParameter(System.Web.UI.WebControls.FormParameter original);

new System.Web.UI.WebControls.FormParameter : System.Web.UI.WebControls.FormParameter -> System.Web.UI.WebControls.FormParameter

Protected Sub New (original As FormParameter)

Parameter

original: FormParameter

Eine FormParameter Instanz, von der die aktuelle Instanz initialisiert wird.

Hinweise

Der FormParameter Konstruktor ist ein protected Kopierkonstruktor, der zum Klonen einer FormParameter Instanz verwendet wird. Die Werte der FormParameter, einschließlich FormField, Nameund Type werden alle in die neue Instanz übertragen.

Weitere Informationen

Gilt für:

FormParameter(String, String)

Initialisiert eine neue benannte Instanz der Klasse mithilfe der FormParameter angegebenen Zeichenfolge, um zu identifizieren, an welches Formularvariablenfeld gebunden werden soll.

public:
 FormParameter(System::String ^ name, System::String ^ formField);

public FormParameter(string name, string formField);

new System.Web.UI.WebControls.FormParameter : string * string -> System.Web.UI.WebControls.FormParameter

Public Sub New (name As String, formField As String)

Parameter

name: String

Der Name des Parameters.

formField: String

Der Name der Formularvariable, an die das Parameterobjekt gebunden ist. Der Standardwert lautet Empty.

Beispiele

Von Bedeutung

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

void Page_Load(Object sender, EventArgs e){

  // You can add a FormParameter to the AccessDataSource control's
  // SelectParameters collection programmatically.
  AccessDataSource1.SelectParameters.Clear();

  // Security Note: The AccessDataSource uses a FormParameter,
  // Security Note: which does not perform validation of input from the client.
  // Security Note: To validate the value of the FormParameter,
  // Security Note: handle the Selecting event.

  FormParameter formParam = new FormParameter("lastname","LastNameBox");
  formParam.Type=TypeCode.String;
  AccessDataSource1.SelectParameters.Add(formParam);
}

</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:accessdatasource
          id="AccessDataSource1"
          runat="server"
          datasourcemode="DataSet"
          datafile="Northwind.mdb"
          selectcommand="SELECT OrderID,CustomerID,OrderDate,RequiredDate,ShippedDate
                         FROM Orders WHERE EmployeeID =
                         (SELECT EmployeeID FROM Employees WHERE LastName = @lastname)">
      </asp:accessdatasource>

      <br />Enter the name "Davolio" or "King" in the text box and click the button.

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

      <br />
      <asp:button
        id="Button1"
        runat="server"
        text="Get Records" />

      <br />
      <asp:gridview
          id="GridView1"
          runat="server"
          allowsorting="True"
          datasourceid="AccessDataSource1">
      </asp:gridview>

    </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 Page_Load(sender As Object, e As EventArgs)

  ' You can add a FormParameter to the AccessDataSource control's
  ' SelectParameters collection programmatically.
  AccessDataSource1.SelectParameters.Clear()

  ' Security Note: The AccessDataSource uses a FormParameter,
  ' Security Note: which does not perform validation of input from the client.
  ' Security Note: To validate the value of the FormParameter,
  ' Security Note: handle the Selecting event.

  Dim formParam As New FormParameter("lastname","LastNameBox")
  formParam.Type=TypeCode.String
  AccessDataSource1.SelectParameters.Add(formParam)
End Sub ' Page_Load

</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:accessdatasource
          id="AccessDataSource1"
          runat="server"
          datasourcemode="DataSet"
          datafile="Northwind.mdb"
          selectcommand="SELECT OrderID,CustomerID,OrderDate,RequiredDate,ShippedDate
                         FROM Orders WHERE EmployeeID =
                         (SELECT EmployeeID FROM Employees WHERE LastName = @lastname)">
      </asp:accessdatasource>

      <br />Enter the name "Davolio" or "King" in the text box and click the button.

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

      <br />
      <asp:button
        id="Button1"
        runat="server"
        text="Get Records" />

      <br />
      <asp:gridview
          id="GridView1"
          runat="server"
          allowsorting="True"
          datasourceid="AccessDataSource1">
      </asp:gridview>

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

Hinweise

Ein FormParameter mit dem FormParameter Konstruktor erstelltes Objekt wird mit dem angegebenen Parameternamen und der angegebenen Zeichenfolge initialisiert, die die Formularvariable identifiziert, an die der Parameter gebunden ist. Die Type Eigenschaften Direction werden mit Standardwerten initialisiert.

Weitere Informationen

Gilt für:

FormParameter(String, DbType, String)

Initialisiert eine neue Instanz der FormParameter Klasse, wobei die angegebene Zeichenfolge verwendet wird, um zu identifizieren, an welches Formularvariablenfeld gebunden werden soll.

public:
 FormParameter(System::String ^ name, System::Data::DbType dbType, System::String ^ formField);

public FormParameter(string name, System.Data.DbType dbType, string formField);

new System.Web.UI.WebControls.FormParameter : string * System.Data.DbType * string -> System.Web.UI.WebControls.FormParameter

Public Sub New (name As String, dbType As DbType, formField As String)

Parameter

name: String

Der Name des Parameters.

dbType: DbType

Der Datenbanktyp des Parameters.

formField: String

Der Name der Formularvariable, an die das Parameterobjekt gebunden ist.

Gilt für:

FormParameter(String, TypeCode, String)

Initialisiert eine neue benannte und stark typierte Instanz der FormParameter Klasse, wobei die angegebene Zeichenfolge verwendet wird, um zu identifizieren, an welche Formularvariable gebunden werden soll.

public:
 FormParameter(System::String ^ name, TypeCode type, System::String ^ formField);

public FormParameter(string name, TypeCode type, string formField);

new System.Web.UI.WebControls.FormParameter : string * TypeCode * string -> System.Web.UI.WebControls.FormParameter

Public Sub New (name As String, type As TypeCode, formField As String)

Parameter

name: String

Der Name des Parameters.

type: TypeCode

Der Typ, den der Parameter darstellt. Der Standardwert lautet Object.

formField: String

Der Name der Formularvariable, an die das Parameterobjekt gebunden ist. Der Standardwert lautet Empty.

Beispiele

Von Bedeutung

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

void Page_Load(Object sender, EventArgs e){

  // You can add a FormParameter to the AccessDataSource control's
  // SelectParameters collection programmatically.
  AccessDataSource1.SelectParameters.Clear();

  // Security Note: The AccessDataSource uses a FormParameter,
  // Security Note: which does not perform validation of input from the client.
  // Security Note: To validate the value of the FormParameter,
  // Security Note: handle the Selecting event.

  FormParameter formParam = new FormParameter("lastname", TypeCode.String, "LastNameBox");
  AccessDataSource1.SelectParameters.Add(formParam);
}

</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:accessdatasource
          id="AccessDataSource1"
          runat="server"
          datasourcemode="DataSet"
          datafile="Northwind.mdb"
          selectcommand="SELECT OrderID,CustomerID,OrderDate,RequiredDate,ShippedDate
                         FROM Orders WHERE EmployeeID =
                          (SELECT EmployeeID FROM Employees WHERE LastName = @lastname)">
      </asp:accessdatasource>

      <br />Enter the name "Davolio" or "King" in the text box and click the button.

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

      <br />
      <asp:button
        id="Button1"
        runat="server"
        text="Get Records" />

      <br />
      <asp:gridview
          id="GridView1"
          runat="server"
          allowsorting="True"
          datasourceid="AccessDataSource1">
      </asp:gridview>

    </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 Page_Load(sender As Object, e As EventArgs)

  ' You can add a FormParameter to the AccessDataSource control's
  ' SelectParameters collection programmatically.
  AccessDataSource1.SelectParameters.Clear()

  ' Security Note: The AccessDataSource uses a FormParameter,
  ' Security Note: which does not perform validation of input from the client.
  ' Security Note: To validate the value of the FormParameter,
  ' Security Note: handle the Selecting event.

  Dim formParam As New FormParameter("lastname",TypeCode.String,"LastNameBox")
  AccessDataSource1.SelectParameters.Add(formParam)

End Sub ' Page_Load

</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:accessdatasource
          id="AccessDataSource1"
          runat="server"
          datasourcemode="DataSet"
          datafile="Northwind.mdb"
          selectcommand="SELECT OrderID,CustomerID,OrderDate,RequiredDate,ShippedDate
                         FROM Orders WHERE EmployeeID =
                           (SELECT EmployeeID FROM Employees WHERE LastName = @lastname)">
      </asp:accessdatasource>

      <br />Enter the name "Davolio" or "King" in the text box and click the button.

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

      <br />
      <asp:button
        id="Button1"
        runat="server"
        text="Get Records" />

      <br />
      <asp:gridview
          id="GridView1"
          runat="server"
          allowsorting="True"
          datasourceid="AccessDataSource1">
      </asp:gridview>

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

Hinweise

Ein FormParameter mit dem FormParameter Konstruktor erstelltes Objekt wird mit dem angegebenen Parameternamen und der Zeichenfolge initialisiert, Typedie die Formularvariable identifiziert, an die der Parameter gebunden ist. Nur die Eigenschaften und ConvertEmptyStringToNull Eigenschaften Direction werden mit Standardwerten initialisiert.

Weitere Informationen

Gilt für:

Feedback

War diese Seite hilfreich?

Freigeben über

FormParameter Konstruktoren

Definition

Überlädt

FormParameter()

Beispiele

Hinweise

Weitere Informationen

Gilt für:

FormParameter(FormParameter)

Parameter

Hinweise

Weitere Informationen

Gilt für:

FormParameter(String, String)

Parameter

Beispiele

Hinweise

Weitere Informationen

Gilt für:

FormParameter(String, DbType, String)

Parameter

Gilt für:

FormParameter(String, TypeCode, String)

Parameter

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Feedback