SqlDataSource.DeleteCommand Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define a string SQL que o SqlDataSource controlo usa para eliminar dados da base de dados subjacente.
public:
property System::String ^ DeleteCommand { System::String ^ get(); void set(System::String ^ value); };public string DeleteCommand { get; set; }member this.DeleteCommand : string with get, setPublic Property DeleteCommand As StringValor de Propriedade
Uma string SQL que o SqlDataSource utilizador usa para apagar dados.
Exemplos
O exemplo de código seguinte demonstra como definir o DeleteCommand texto para eliminar uma ordem da tabela de Ordens da base de dados da Northwind. Os dados são recolhidos da tabela de Ordens e apresentados num GridView controlo. O GridView botão Delete renderiza automaticamente quando a AutoGenerateDeleteButton propriedade está definida para true. Além disso, quando o botão Delete é clicado, o controlo GridView preenche automaticamente a DeleteParameters coleção e chama o Delete método. Finalmente, como este exemplo de código elimina dados, é adicionado um gestor de eventos para tentar fazer backup da base de dados para o disco antes da Delete operação ser realizada.
<%@Page Language="C#" %>
<%@Import Namespace="System.Data.SqlClient" %>
<!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 OnRecordDeleting(Object source, SqlDataSourceCommandEventArgs e) {
// Cancel the delete operation if the checkbox is not checked.
if (!CheckBox1.Checked) {
e.Cancel = true;
Label1.Text = "The command was cancelled because the CheckBox was not checked.";
}
}
private void OnRecordDeleted(object source, SqlDataSourceStatusEventArgs e) {
Label1.Text = e.AffectedRows + " row(s) were deleted";
}
</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"
DataSourceMode="DataSet"
ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
SelectCommand="SELECT * FROM Orders"
DeleteCommand="DELETE FROM [Order Details] WHERE OrderID=@OrderID;DELETE FROM Orders WHERE OrderID=@OrderID;"
OnDeleting="OnRecordDeleting"
OnDeleted="OnRecordDeleted">
</asp:SqlDataSource>
<br />
<asp:CheckBox
id="CheckBox1"
runat="server"
autopostback="true"
text="Check To Delete Data" />
<br />
<br />
<asp:GridView
id="GridView1"
runat="server"
AutoGenerateColumns="False"
DataKeyNames="OrderID"
AutoGenerateDeleteButton="True"
AllowPaging="True"
PageSize="20"
DataSourceID="SqlDataSource1">
<Columns>
<asp:BoundField HeaderText="Order ID" DataField="OrderID" />
<asp:BoundField HeaderText="Customer" DataField="CustomerID" />
<asp:BoundField HeaderText="Order Placed" DataField="OrderDate" />
<asp:BoundField HeaderText="Order Shipped" DataField="ShippedDate" />
</Columns>
</asp:GridView>
<asp:Label
id="Label1"
runat="server">
</asp:Label>
</form>
</body>
</html>
<%@Page Language="VB" %>
<%@Import Namespace="System.Data.SqlClient" %>
<!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_Record_Deleting(ByVal source As Object, ByVal e As SqlDataSourceCommandEventArgs)
' Cancel the delete operation if the checkbox is not checked.
If Not CheckBox1.Checked
e.Cancel = True
Label1.Text = "The command was cancelled because the CheckBox was not checked."
End If
End Sub 'On_Record_Deleting
Sub On_Record_Deleted(ByVal source As Object, ByVal e As SqlDataSourceStatusEventArgs)
Label1.Text = e.AffectedRows & " row(s) were deleted"
End Sub
</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"
DataSourceMode="DataSet"
ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
SelectCommand="SELECT * FROM Orders"
DeleteCommand="DELETE FROM [Order Details] WHERE OrderID=@OrderID;DELETE FROM Orders WHERE OrderID=@OrderID;"
OnDeleting="On_Record_Deleting"
OnDeleted="On_Record_Deleted">
</asp:SqlDataSource>
<br />
<asp:CheckBox
id="CheckBox1"
runat="server"
autopostback="true"
text="Check To Delete Data" />
<br />
<br />
<asp:GridView
id="GridView1"
runat="server"
AutoGenerateColumns="False"
DataKeyNames="OrderID"
AutoGenerateDeleteButton="True"
AllowPaging="True"
PageSize="20"
DataSourceID="SqlDataSource1">
<Columns>
<asp:BoundField HeaderText="Order ID" DataField="OrderID" />
<asp:BoundField HeaderText="Customer" DataField="CustomerID" />
<asp:BoundField HeaderText="Order Placed" DataField="OrderDate" />
<asp:BoundField HeaderText="Order Shipped" DataField="ShippedDate" />
</Columns>
</asp:GridView>
<asp:Label
id="Label1"
runat="server">
</asp:Label>
</form>
</body>
</html>
Observações
Representa DeleteCommand uma consulta SQL ou o nome de um procedimento armazenado, e é utilizado pelo Delete método.
Como diferentes produtos de bases de dados usam diferentes variedades de SQL, a sintaxe da string SQL depende do fornecedor atual .NET ADO que está a ser utilizado, que é identificado pela propriedade ProviderName. Se a string SQL for uma consulta ou comando parametrizado, a sintaxe do parâmetro também depende do fornecedor ADO.NET utilizado. Por exemplo, se o fornecedor for o System.Data.SqlClient, que é o fornecedor padrão para a SqlDataSource classe, a sintaxe do parâmetro é '@parameterName'. No entanto, se o fornecedor estiver definido como ou System.Data.OdbcSystem.Data.OleDb, o marcador de posição do parâmetro é '?'. Para mais informações sobre consultas e comandos SQL parametrizados, consulte Utilização de Parâmetros com o Controlo SqlDataSource.
A DeleteCommand propriedade pode ser uma string SQL ou o nome de um procedimento armazenado, se a base de dados suportar procedimentos armazenados.
A DeleteCommand propriedade delega à DeleteCommand propriedade do SqlDataSourceView objeto associada ao SqlDataSource controlo.
Importante
Por razões de segurança, a DeleteCommand propriedade não está armazenada no estado de visualização. Como é possível decodificar o conteúdo do estado da vista no cliente, armazenar informação sensível sobre a estrutura da base de dados no estado da vista pode resultar numa vulnerabilidade à divulgação de informação.