SqlDataSource.DeleteParameters Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar den parametersamling som innehåller de parametrar som används av DeleteCommand egenskapen från objektet SqlDataSourceView som är associerat med SqlDataSource kontrollen.
public:
property System::Web::UI::WebControls::ParameterCollection ^ DeleteParameters { System::Web::UI::WebControls::ParameterCollection ^ get(); };
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public System.Web.UI.WebControls.ParameterCollection DeleteParameters { get; }
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.DeleteParameters : System.Web.UI.WebControls.ParameterCollection
Public ReadOnly Property DeleteParameters As ParameterCollection
Egenskapsvärde
En ParameterCollection som innehåller de parametrar som används av egenskapen DeleteCommand .
- Attribut
Exempel
Följande kodexempel visar hur du ställer in DeleteCommand texten för att ta bort en order från Northwind-databasen. Inledningsvis hämtas data från tabellen Beställningar och visas i en DropDownList kontroll. Du måste uttryckligen deklarera DeleteParameters egenskapen och anropa Delete metoden när du använder databundna kontroller, till exempel DropDownList (till skillnad från andra kontroller, till exempel GridView och DetailsView, som automatiskt fyller i parametrarna och anropar Delete en datakällskontroll). I det här exemplet OnClick delegeras händelsen till den privata OnDelete händelsehanteraren, som uttryckligen anropar Delete kontrollens SqlDataSource metod.
<%@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 OnDelete(Object sender, EventArgs e) {
SqlDataSource1.Delete();
}
</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:SqlDataSource
id="SqlDataSource1"
runat="server"
ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
SelectCommand="SELECT OrderID FROM Orders"
DeleteCommand="DELETE FROM [Order Details] WHERE OrderID=@OrderID;DELETE FROM Orders WHERE OrderID=@OrderID;">
<DeleteParameters>
<asp:ControlParameter Name="OrderID" ControlId="DropDownList1" PropertyName="SelectedValue" />
</DeleteParameters>
</asp:SqlDataSource>
<asp:DropDownList
id="DropDownList1"
runat="server"
DataTextField="OrderID"
DataValueField="OrderID"
DataSourceID="SqlDataSource1">
</asp:DropDownList>
<asp:Button
id="Button1"
runat="server"
Text="Delete Order"
OnClick="OnDelete">
</asp:Button>
</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">
Sub On_Delete(ByVal sender As Object, ByVal e As EventArgs)
SqlDataSource1.Delete()
End Sub 'On_Delete
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:SqlDataSource
id="SqlDataSource1"
runat="server"
ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
SelectCommand="SELECT OrderID FROM Orders"
DeleteCommand="DELETE FROM [Order Details] WHERE OrderID=@OrderID;DELETE FROM Orders WHERE OrderID=@OrderID;">
<DeleteParameters>
<asp:ControlParameter Name="OrderID" ControlId="DropDownList1" PropertyName="SelectedValue" />
</DeleteParameters>
</asp:SqlDataSource>
<asp:DropDownList
id="DropDownList1"
runat="server"
DataTextField="OrderID"
DataValueField="OrderID"
DataSourceID="SqlDataSource1">
</asp:DropDownList>
<asp:Button
id="Button1"
runat="server"
Text="Delete Order"
OnClick="On_Delete">
</asp:Button>
</form>
</body>
</html>
Kommentarer
Om egenskapen DeleteCommand innehåller en parameteriserad SQL-fråga DeleteParameters innehåller samlingen alla Parameter objekt som motsvarar parameterplatshållarna i SQL-strängen.
Note
Kontrollera att inga BoundField kontroller i den databundna kontroll som du binder till SqlDataSource kontrollen har namn som matchar eventuella parameternamn i DeleteParameters samlingen. Parametrar som har samma namn som bundna fält undantas från SQL-kommandot och felet "parametern angavs inte" kan uppstå.
Om egenskapen ConflictDetection är inställd på CompareAllValues värdet skapas parametrarna för både gamla och nya värden för data. Parametrarna för de gamla värdena namnges enligt egenskapen OldValuesParameterFormatString .
Beroende på ADO.NET-providern kan ordningen på parametrarna i samlingen DeleteParameters vara viktig. Leverantörerna System.Data.OleDb och System.Data.Odbc associerar parametrarna i samlingen enligt den ordning som parametrarna visas i den parametriserade SQL-frågan. Providern System.Data.SqlClient, som är standardprovidern ADO.NET för kontrollen SqlDataSource, associerar parametrarna i samlingen genom att matcha namnet på parametern med platshållaren i SQL-frågan. Mer information om parameteriserade SQL-frågor och -kommandon finns i Använda parametrar med SqlDataSource-kontrollen.
Egenskapen DeleteParameters hämtar egenskapen DeleteParameters som finns i objektet SqlDataSourceView som är associerat med SqlDataSource kontrollen.
Important
Värden infogas i parametrar utan validering, vilket är ett potentiellt säkerhetshot. Deleting Använd händelsen för att verifiera parametervärden innan du kör frågan. Mer information finns i Översikt över skriptexploateringar.