Exporter (0) Imprimer
Développer tout

SqlDataSource.Delete, méthode

Exécute une opération de suppression à l'aide de la chaîne SQL DeleteCommand et de tous les paramètres de la collection DeleteParameters.

Espace de noms: System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

public int Delete ()
public int Delete ()
public function Delete () : int
Non applicable.

Valeur de retour

Une valeur qui représente le nombre de lignes supprimées de la base de données sous-jacente.

Type d'exceptionCondition

InvalidOperationException

SqlDataSource ne peut pas établir de connexion avec la source de données sous-jacente.

Avant que l'opération de suppression ne soit effectuée, la méthode OnDeleting est appelée pour déclencher l'événement Deleting. Vous pouvez gérer cet événement pour examiner les valeurs des paramètres et effectuer tout prétraitement avant une opération de suppression.

RemarqueRemarque :

Si vous n'êtes pas familiarisé avec les fonctionnalités d'accès aux données dans ASP.NET 2.0, il est conseillé de consulter une ou plusieurs des rubriques suivantes avant de continuer :

Lorsque l'opération est terminée, la méthode OnDeleted est appelée pour déclencher l'événement Deleted. Vous pouvez gérer cet événement pour examiner les valeurs de retour et les codes d'erreur, ainsi que pour effectuer tout post-traitement.

La méthode Delete est fournie pour l'accès par programme à la méthode Delete. Si le contrôle SqlDataSource est associé à un contrôle lié aux données, le contrôle lié aux données appelle automatiquement la méthode Delete.

La méthode Deletedélègue à la méthode Delete de l'objet SqlDataSourceView associé au contrôle SqlDataSource. Pour exécuter l'opération, SqlDataSourceView génère un objet DbCommand à l'aide du texte DeleteCommand et de toute valeur DeleteParameters associée, puis exécute DbCommand sur la base de données sous-jacente.

L'exemple de code suivant illustre comment définir le texte DeleteCommand afin qu'il supprime un ordre de la base de données Northwind. Initialement, les données sont récupérées de la table Orders et sont affichées dans un contrôle DropDownList. Vous devez déclarer la propriété DeleteParameters explicitement et appeler la méthode Delete lors de l'utilisation de contrôles liés aux données, tels que DropDownList (contrairement aux autres contrôles, tels que GridView et DetailsView qui remplissent automatiquement les paramètres et appellent la méthode Delete sur un contrôle de source de données). Dans cet exemple, l'événement OnClick est délégué au gestionnaire d'événements OnDelete privé qui appelle explicitement la méthode Delete du contrôle 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 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Microsoft .NET Framework 3.0 est pris en charge sur Windows Vista, Microsoft Windows XP SP2 et Windows Server 2003 SP1.

.NET Framework

Prise en charge dans : 3.0, 2.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft