Esta documentación está archivada y no tiene mantenimiento.

SqlDataSource.DeleteParameters (Propiedad)

Actualización: noviembre 2007

Obtiene la colección de parámetros que contiene los parámetros utilizados por la propiedad DeleteCommand desde el objeto SqlDataSourceView asociado con el control SqlDataSource.

Espacio de nombres:  System.Web.UI.WebControls
Ensamblado:  System.Web (en System.Web.dll)

[PersistenceModeAttribute(PersistenceMode.InnerProperty)]
public ParameterCollection DeleteParameters { get; }
/** @property */
/** @attribute PersistenceModeAttribute(PersistenceMode.InnerProperty) */
public ParameterCollection get_DeleteParameters()

public function get DeleteParameters () : ParameterCollection

Valor de propiedad

Tipo: System.Web.UI.WebControls.ParameterCollection
ParameterCollection que contiene los parámetros utilizados por la propiedad DeleteCommand.

Si la propiedad DeleteCommand contiene una consulta SQL parametrizada, la colección DeleteParameters contiene los objetos Parameter que corresponden a los marcadores de posición de los parámetros en la cadena SQL.

Si la propiedad ConflictDetection se establece en el valor CompareAllValues, se crean parámetros tanto para los valores antiguos como para los nuevos. Los parámetros para los valores antiguos se denominan según la propiedad OldValuesParameterFormatString.

Dependiendo del proveedor de ADO.NET, el orden de los parámetros en la colección DeleteParameters podría ser importante. Los proveedores de System.Data.OleDb y System.Data.Odbc asocian los parámetros de la colección en función del orden en que aparecen los parámetros en la consulta SQL parametrizada. El proveedor System.Data.SqlClient, que es el proveedor ADO.NET predeterminado para el control SqlDataSource, asocia los parámetros de la colección comparando el nombre del parámetro con el marcador de posición en la consulta SQL. Para obtener más información sobre las consultas y comandos parametrizados de SQL, vea Utilizar parámetros con el control SqlDataSource.

La propiedad DeleteParameters recupera la propiedad DeleteParameters contenida por el objeto SqlDataSourceView que está asociado al control SqlDataSource.

bkcfzttd.alert_security(es-es,VS.90).gifNota de seguridad:

Los valores se insertan en parámetros sin validación, lo que puede suponer una amenaza para la seguridad. Utilice el evento Deleting para validar los valores de los parámetros antes de ejecutar la consulta. Para obtener más información, vea Información general sobre los ataques mediante secuencias de comandos.

El ejemplo de código siguiente muestra cómo establecer el texto DeleteCommand para eliminar un pedido de la base de datos Northwind. Inicialmente, los datos se recuperan de la tabla Orders y se muestran en un control DropDownList. Debe declarar explícitamente la propiedad DeleteParameters y llamar al método Delete cuando utilice controles enlazados a datos tales como el control DropDownList (a diferencia de otros controles, tales como GridView y DetailsView, que rellenan automáticamente los parámetros y llaman al método Delete de un control de origen de datos). En este ejemplo, el evento OnClick se delega al controlador del evento OnDelete privado, que llama explícitamente al método Delete del control SqlDataSource.

<%@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="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 OnDelete(Object sender, System.EventArgs e)
    {
        SqlDataSource1.Delete();
    } //OnDelete
</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="Data Source=localhost;Integrated Security=SSPI;Initial Catalog=Northwind;"
                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>


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0
Mostrar: