ParameterCollection.Add Methode

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Fügt der Auflistung ein Parameter-Objekt hinzu.

Überlädt

Add(Parameter)

Fügt das angegebene Parameter-Objekt an das Ende der Auflistung an.
Add(String, String)

Erstellt ein Parameter-Objekt mit dem angegebenen Namen und Standardwert und hängt es an das Ende der Auflistung an.
Add(String, DbType, String)

Erstellt ein Parameter-Objekt mit dem angegebenen Namen, Datenbanktyp sowie Standardwert und hängt dieses an das Ende der Auflistung an.
Add(String, TypeCode, String)

Erstellt ein Parameter-Objekt mit dem angegebenen Namen, TypeCode und Standardwert, und hängt es an das Ende der Auflistung an.

Add(Parameter)

Fügt das angegebene Parameter-Objekt an das Ende der Auflistung an.

public:
 int Add(System::Web::UI::WebControls::Parameter ^ parameter);
public int Add (System.Web.UI.WebControls.Parameter parameter);
member this.Add : System.Web.UI.WebControls.Parameter -> int
Public Function Add (parameter As Parameter) As Integer

Parameter

parameter
Parameter

Der an die Auflistung anzufügende Parameter.

Gibt zurück

Int32

Der Indexwert des hinzugefügten Elements.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mithilfe eines Steuerelements AccessDataSource und eines FormParameter Objekts Informationen aus einer Microsoft Access-Datenbank in einem GridView Steuerelement anzeigen. Das FormParameter -Objekt wird der SelectParameters Auflistung mithilfe der Add(Parameter) -Methode hinzugefügt.

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

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

Verwenden Sie die Add(Parameter) -Methode, um ein Parameter -Objekt am Ende der Auflistung anzufügen. Diese Implementierung der -Methode akzeptiert das Parameter vom param -Parameter angegebene Objekt und fügt es an die Auflistung an.

Weitere Informationen

Gilt für:

Add(String, String)

Erstellt ein Parameter-Objekt mit dem angegebenen Namen und Standardwert und hängt es an das Ende der Auflistung an.

public:
 int Add(System::String ^ name, System::String ^ value);
public int Add (string name, string value);
member this.Add : string * string -> int
Public Function Add (name As String, value As String) As Integer

Parameter

name
String

Der Name des Parameters.

value
String

Eine Zeichenfolge, die als Standardwert für den Parameter verwendet wird.

Gibt zurück

Int32

Der Indexwert des hinzugefügten Elements.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die Add(String, String) -Methode verwendet werden kann, um einer ParameterCollection Auflistung neue Parameter Objekte hinzuzufügen, indem die name Parameter und value angegeben werden. In diesem Beispiel wird einem Parameter Update-Befehl eines Access-Datenquellensteuerelements, das an den Wert eines Steuerelements gebunden ist, ein TextBox -Objekt hinzugefügt.

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.

<script runat="server">
private void UpdateRecords(Object source, EventArgs e)
{
  CheckBox cb;
  foreach(GridViewRow row in this.GridView1.Rows) {
    cb = (CheckBox) row.Cells[0].Controls[1];
    if(cb.Checked) {
      string oid = (string) row.Cells[1].Text;
      MyAccessDataSource.UpdateParameters.Add("date", TypeCode.DateTime, DateTime.Now.ToString());
      MyAccessDataSource.UpdateParameters.Add("orderid", oid);
      MyAccessDataSource.Update();
      MyAccessDataSource.UpdateParameters.Clear();
    }
  }
}
</script>

<script runat="server">
Private Sub UpdateRecords(source As Object, e As EventArgs)

  Dim cb As CheckBox
  Dim row As GridViewRow

  For Each row In GridView1.Rows

    cb = CType(row.Cells(0).Controls(1), CheckBox)
    If cb.Checked Then

      Dim oid As String
      oid = CType(row.Cells(1).Text, String)

      MyAccessDataSource.UpdateParameters.Add("date", TypeCode.DateTime, DateTime.Now.ToString())

      MyAccessDataSource.UpdateParameters.Add("orderid", oid)

      MyAccessDataSource.Update()
      MyAccessDataSource.UpdateParameters.Clear()
    End If
  Next
End Sub ' UpdateRecords
</script>

Hinweise

Verwenden Sie die Add(String, String) -Methode, um ein Parameter Objekt mit einem Standardwert am Ende der Auflistung zu erstellen und anzufügen. Diese Implementierung der -Methode erstellt das Parameter -Objekt unter Verwendung des namens und des Standardwerts, der durch die Parameter bzwvalue. angegeben name wird, und fügt es an die Auflistung an.

Weitere Informationen

Gilt für:

Add(String, DbType, String)

Erstellt ein Parameter-Objekt mit dem angegebenen Namen, Datenbanktyp sowie Standardwert und hängt dieses an das Ende der Auflistung an.

public:
 int Add(System::String ^ name, System::Data::DbType dbType, System::String ^ value);
public int Add (string name, System.Data.DbType dbType, string value);
member this.Add : string * System.Data.DbType * string -> int
Public Function Add (name As String, dbType As DbType, value As String) As Integer

Parameter

name
String

Der Name des Parameters.

dbType
DbType

Der Datenbanktyp des Parameters.

value
String

Der Standardwert für den Parameter.

Gibt zurück

Int32

Der Indexwert des hinzugefügten Elements.

Hinweise

Diese Methode ist für Datenbanktypen vorgesehen. Verwenden Sie die Add(String, TypeCode, String) -Methode für CLR-Typen.

Gilt für:

Add(String, TypeCode, String)

Erstellt ein Parameter-Objekt mit dem angegebenen Namen, TypeCode und Standardwert, und hängt es an das Ende der Auflistung an.

public:
 int Add(System::String ^ name, TypeCode type, System::String ^ value);
public int Add (string name, TypeCode type, string value);
member this.Add : string * TypeCode * string -> int
Public Function Add (name As String, type As TypeCode, value As String) As Integer

Parameter

name
String

Der Name des Parameters.

type
TypeCode

Der Typ des Parameters.

value
String

Der Standardwert für den Parameter.

Gibt zurück

Int32

Der Indexwert des hinzugefügten Elements.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die Add(String, TypeCode, String) -Methode verwendet werden kann, um einer ParameterCollection Auflistung neue Parameter Objekte hinzuzufügen, indem die nameParameter , valueund type angegeben werden. In diesem Beispiel wird einem Parameter Update-Befehl eines Access-Datenquellensteuerelements, das den Wert der aktuellen Systemzeit bereitstellt, ein -Objekt hinzugefügt. Der Parameter wird mit dem TypeCode von DateTimehinzugefügt.

<script runat="server">
private void UpdateRecords(Object source, EventArgs e)
{
  CheckBox cb;
  foreach(GridViewRow row in this.GridView1.Rows) {
    cb = (CheckBox) row.Cells[0].Controls[1];
    if(cb.Checked) {
      string oid = (string) row.Cells[1].Text;
      MyAccessDataSource.UpdateParameters.Add("date", TypeCode.DateTime, DateTime.Now.ToString());
      MyAccessDataSource.UpdateParameters.Add("orderid", oid);
      MyAccessDataSource.Update();
      MyAccessDataSource.UpdateParameters.Clear();
    }
  }
}
</script>

<script runat="server">
Private Sub UpdateRecords(source As Object, e As EventArgs)

  Dim cb As CheckBox
  Dim row As GridViewRow

  For Each row In GridView1.Rows

    cb = CType(row.Cells(0).Controls(1), CheckBox)
    If cb.Checked Then

      Dim oid As String
      oid = CType(row.Cells(1).Text, String)

      MyAccessDataSource.UpdateParameters.Add("date", TypeCode.DateTime, DateTime.Now.ToString())

      MyAccessDataSource.UpdateParameters.Add("orderid", oid)

      MyAccessDataSource.Update()
      MyAccessDataSource.UpdateParameters.Clear()
    End If
  Next
End Sub ' UpdateRecords
</script>

Hinweise

Verwenden Sie die Add(String, TypeCode, String) -Methode, um ein stark typisiertes Parameter Objekt mit einem Standardwert am Ende der Auflistung zu erstellen und anzufügen. Diese Implementierung der -Methode erstellt das Parameter -Objekt unter Verwendung des Namens, des Typs und des Werts, der durch die nameParameter , type bzw. angegeben value wird, und fügt es an die Auflistung an.

Weitere Informationen

Gilt für: