ParameterCollection.Add Methode
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.
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 -> intPublic Function Add (parameter As Parameter) As IntegerParameter
Gibt zurück
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 -> intPublic Function Add (name As String, value As String) As IntegerParameter
- name
- String
Der Name des Parameters.
- value
- String
Eine Zeichenfolge, die als Standardwert für den Parameter verwendet wird.
Gibt zurück
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 -> intPublic Function Add (name As String, dbType As DbType, value As String) As IntegerParameter
- name
- String
Der Name des Parameters.
- dbType
- DbType
Der Datenbanktyp des Parameters.
- value
- String
Der Standardwert für den Parameter.
Gibt zurück
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)
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 -> intPublic Function Add (name As String, type As TypeCode, value As String) As IntegerParameter
- name
- String
Der Name des Parameters.
- type
- TypeCode
Der Typ des Parameters.
- value
- String
Der Standardwert für den Parameter.
Gibt zurück
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 value . angegeben wird, und fügt es an die Auflistung an.
Weitere Informationen
Gilt für:
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für