SqlDataSource.UpdateParameters-Eigenschaft
Assembly: System.Web (in system.web.dll)
/** @property */ public ParameterCollection get_UpdateParameters ()
public function get UpdateParameters () : ParameterCollection
Eigenschaftenwert
Eine ParameterCollection, die die von der UpdateCommand-Eigenschaft verwendeten Parameter enthält.Wenn die UpdateCommand-Eigenschaft eine parametrisierte SQL-Abfrage enthält, enthält die UpdateParameters-Auflistung alle Parameter-Objekte, die den Parameterplatzhaltern in der SQL-Zeichenfolge entsprechen.
Die OldValuesParameterFormatString-Eigenschaft kann Auswirkungen auf die Parameter haben. Dies gilt besonders, wenn der Name einen Primärschlüssel bezeichnet, z. B. einen von der DataKeyNames-Eigenschaft des datengebundenen Steuerelements angegebenen Schlüssel, oder in Lösch- und Aktualisierungsszenarios, in denen die ConflictDetection-Eigenschaft auf den CompareAllValues-Wert festgelegt ist und eine Reihe von oldValues an die entsprechenden Datenmethode übergeben werden. In diesem Fall wird die Formatzeichenfolge für jeden Parameternamen in der oldValues-Auflistung übernommen.
Je nach dem ADO.NET-Anbieter ist die Reihenfolge der Parameter in der UpdateParameters-Auflistung möglicherweise wichtig. Der System.Data.OleDb-Anbieter und der System.Data.Odbc-Anbieter ordnen die Parameter in der Auflistung in der Reihenfolge zu, in der die Parameter in der parametrisierten SQL-Abfrage angezeigt werden. Der System.Data.SqlClient-Anbieter, der der Standard-ADO.NET-Anbieter für das SqlDataSource-Steuerelement ist, ordnet die Parameter in der Auflistung durch Abgleichen des Parameternamens mit einem Platzhalteralias in der SQL-Abfrage zu. Weitere Informationen zu parametrisierten SQL-Abfragen und -Befehlen finden Sie unter Verwenden von Parametern mit dem SqlDataSource-Steuerelement.
Die UpdateParameters-Eigenschaft ruft die im SqlDataSourceView-Objekt enthaltene UpdateParameters-Eigenschaft ab, die dem SqlDataSource-Steuerelement zugeordnet ist.
Im folgenden Codebeispiel wird die Verwendung eines SqlDataSource-Steuerelements zum Anzeigen von Daten in einem DropDownList-Steuerelement sowie das Aktualisieren von Daten beim Klicken auf die Schaltfläche Senden veranschaulicht. Der UpdateCommand wird mit einer parametrisierten SQL-Anweisung festgelegt, und der UpdateParameters-Auflistung werden zwei ControlParameter-Parameter hinzugefügt. Wenn auf die Schaltfläche Senden geklickt wird, wird das OnClick-Ereignis behandelt, um die Update-Methode explizit aufzurufen.
<%@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 On_Click(Object source, EventArgs e) { try { SqlDataSource1.Update(); } catch (Exception except) { // Handle the Exception. } Label2.Text="The record was updated successfully!"; } </SCRIPT> <HTML> <BODY> <FORM runat="server"> <asp:SqlDataSource id="SqlDataSource1" runat="server" ConnectionString="<%$ ConnectionStrings:MyNorthwind%>" SelectCommand="SELECT EmployeeID, LastName, Address FROM Employees" UpdateCommand="UPDATE Employees SET Address=@Address WHERE EmployeeID=@EmployeeID"> <UpdateParameters> <asp:ControlParameter Name="Address" ControlId="TextBox1" PropertyName="Text"/> <asp:ControlParameter Name="EmployeeID" ControlId="DropDownList1" PropertyName="SelectedValue"/> </UpdateParameters> </asp:SqlDataSource> <asp:DropDownList id="DropDownList1" runat="server" DataTextField="LastName" DataValueField="EmployeeID" DataSourceID="SqlDataSource1"> </asp:DropDownList> <P> <asp:Label id="Label1" runat="server" Text="Enter a new address for the selected user." /> <asp:TextBox id="TextBox1" runat="server" /> <asp:Button id="Submit" runat="server" Text="Submit" OnClick="On_Click" /> <P><asp:Label id="Label2" runat="server" Text="" /> </FORM> </BODY> </HTML>
<%@Page Language="VJ#" %>
<!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 On_Click(Object source, System.EventArgs e)
{
try {
SqlDataSource1.Update();
}
catch (Exception except) {
// Handle the Exception.
}
Label2.set_Text("The record was updated successfully!");
} //On_Click
</SCRIPT>
<HTML>
<BODY>
<FORM runat="server">
<asp:SqlDataSource
id="SqlDataSource1"
runat="server"
ConnectionString="Data Source=localhost;Integrated Security=SSPI;Initial Catalog=Northwind;"
SelectCommand="SELECT EmployeeID, LastName, Address FROM Employees"
UpdateCommand="UPDATE Employees SET Address=@Address WHERE EmployeeID=@EmployeeID">
<UpdateParameters>
<asp:ControlParameter Name="Address" ControlId="TextBox1" PropertyName="Text"/>
<asp:ControlParameter Name="EmployeeID" ControlId="DropDownList1" PropertyName="SelectedValue"/>
</UpdateParameters>
</asp:SqlDataSource>
<asp:DropDownList
id="DropDownList1"
runat="server"
DataTextField="LastName"
DataValueField="EmployeeID"
DataSourceID="SqlDataSource1">
</asp:DropDownList>
<P>
<asp:Label id="Label1" runat="server" Text="Enter a new address for the selected user." />
<asp:TextBox id="TextBox1" runat="server" />
<asp:Button id="Submit" runat="server" Text="Submit" OnClick="On_Click" />
<P><asp:Label id="Label2" runat="server" Text="" />
</FORM>
</BODY>
</HTML>
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
