ParameterCollection.Add Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Ajoute un objet Parameter à la collection.
Surcharges
| Add(Parameter) |
Ajoute l'objet Parameter spécifié à la fin de la collection. |
| Add(String, String) |
Crée un objet Parameter avec le nom spécifié et la valeur par défaut et l'ajoute à la fin de la collection. |
| Add(String, DbType, String) |
Crée un objet Parameter avec le nom, le type de base de données et la valeur par défaut spécifiés, puis l'ajoute à la fin de la collection. |
| Add(String, TypeCode, String) |
Crée un objet Parameter avec le nom spécifié, TypeCode et la valeur par défaut et l'ajoute à la fin de la collection. |
Add(Parameter)
Ajoute l'objet Parameter spécifié à la fin de la collection.
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 IntegerParamètres
Retours
Valeur d'index de l'élément ajouté.
Exemples
L’exemple de code suivant montre comment utiliser un AccessDataSource contrôle et un FormParameter objet pour afficher les informations d’une base de données Access Microsoft dans un GridView contrôle. L’objet FormParameter est ajouté à la collection à l’aide SelectParameters de la Add(Parameter) méthode .
Important
Cet exemple comprend une zone de texte qui accepte une entrée d'utilisateur, ce qui constitue une menace potentielle pour la sécurité. Par défaut, les pages web ASP.NET vérifient que l’entrée d’utilisateur n’inclut pas de script ou d’éléments HTML. Pour plus d’informations, consultez Vue d’ensemble des attaques de script.
<%@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>
Remarques
Utilisez la Add(Parameter) méthode pour ajouter un Parameter objet à la fin de la collection. Cette implémentation de la méthode prend l’objet Parameter spécifié par le param paramètre et l’ajoute à la collection.
Voir aussi
S’applique à
Add(String, String)
Crée un objet Parameter avec le nom spécifié et la valeur par défaut et l'ajoute à la fin de la collection.
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 IntegerParamètres
- name
- String
Le nom du paramètre.
- value
- String
Chaîne qui s'utilise en tant que valeur par défaut du paramètre.
Retours
Valeur d'index de l'élément ajouté.
Exemples
L’exemple de code suivant montre comment la Add(String, String) méthode peut être utilisée pour ajouter de nouveaux Parameter objets à une ParameterCollection collection en fournissant les name paramètres et value . Dans cet exemple, un Parameter objet est ajouté à une commande Update d’un contrôle de source de données Access lié à la valeur d’un TextBox contrôle.
Important
Cet exemple comprend une zone de texte qui accepte une entrée d'utilisateur, ce qui constitue une menace potentielle pour la sécurité. Par défaut, les pages web ASP.NET vérifient que l’entrée d’utilisateur n’inclut pas de script ou d’éléments HTML. Pour plus d’informations, consultez Vue d’ensemble des attaques de script.
<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>
Remarques
Utilisez la Add(String, String) méthode pour créer et ajouter un Parameter objet avec une valeur par défaut à la fin de la collection. Cette implémentation de la méthode crée l’objet à l’aide Parameter du nom et de la valeur par défaut spécifiés par les name paramètres et value , respectivement, et l’ajoute à la collection.
Voir aussi
S’applique à
Add(String, DbType, String)
Crée un objet Parameter avec le nom, le type de base de données et la valeur par défaut spécifiés, puis l'ajoute à la fin de la collection.
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 IntegerParamètres
- name
- String
Le nom du paramètre.
- dbType
- DbType
Type de base de données du paramètre.
- value
- String
Valeur par défaut du paramètre.
Retours
Valeur d'index de l'élément ajouté.
Remarques
Cette méthode s’adresse aux types de base de données. Utilisez la méthode pour les Add(String, TypeCode, String) types CLR.
S’applique à
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 IntegerParamètres
- name
- String
Le nom du paramètre.
- type
- TypeCode
Type du paramètre.
- value
- String
Valeur par défaut du paramètre.
Retours
Valeur d'index de l'élément ajouté.
Exemples
L’exemple de code suivant montre comment la Add(String, TypeCode, String) méthode peut être utilisée pour ajouter de nouveaux Parameter objets à une ParameterCollection collection en fournissant les nameparamètres , valueet type . Dans cet exemple, un Parameter objet est ajouté à une commande Update d’un contrôle de source de données Access qui fournit la valeur de l’heure système actuelle. Le paramètre est ajouté avec le TypeCode de DateTime.
<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>
Remarques
Utilisez la Add(String, TypeCode, String) méthode pour créer et ajouter un objet fortement typé Parameter avec une valeur par défaut à la fin de la collection. Cette implémentation de la méthode crée l’objet à l’aide Parameter du nom, du type et de la valeur spécifiés par les nameparamètres et typevalue , respectivement, et l’ajoute à la collection.
Voir aussi
S’applique à
Commentaires
Bientôt disponible : tout au long de 2024, nous allons éliminer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d'informations, consultez : https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour