ObjectContext.DeleteObject(Object) Metódus

Definíció

Névtér:
System.Data.Objects
Szerelvény:
System.Data.Entity.dll

Objektum megjelölése törlésre.

public:
 void DeleteObject(System::Object ^ entity);
public void DeleteObject(object entity);
member this.DeleteObject : obj -> unit
Public Sub DeleteObject (entity As Object)

Paraméterek

entity
Object

A törölni kívánt entitást meghatározó objektum. Az objektum bármilyen állapotban lehet, kivéve Detached.

Kivételek

ArgumentNullException

entity az null.

InvalidOperationException

entity nem létezik.

Példák

Ez a példa létrehoz egy EntityKey adott ProductID azonosítót, a kulccsal lekér egy Termék objektumot az adatforrásból, törli a terméket, és menti az adatbázis módosításait.

object deletedProduct;

// Define the key of the product to delete.
EntityKey productKey =
    new EntityKey("AdventureWorksEntities.Products",
        "ProductID", productId);

using (AdventureWorksEntities context = new AdventureWorksEntities())
{
    // Get the object to delete with the specified key.
    if (context.TryGetObjectByKey(productKey, out deletedProduct))
    {
        try
        {
            // Delete the object with the specified key
            // and save changes to delete the row from the data source.
            context.DeleteObject(deletedProduct);
            context.SaveChanges();
        }
        catch (OptimisticConcurrencyException ex)
        {
            throw new InvalidOperationException(string.Format(
                "The product with an ID of '{0}' could not be deleted.\n"
                + "Make sure that any related objects are already deleted.\n",
                productKey.EntityKeyValues[0].Value), ex);
        }
    }
    else
    {
        throw new InvalidOperationException(string.Format(
            "The product with an ID of '{0}' could not be found.\n"
            + "Make sure that Product exists.\n",
            productKey.EntityKeyValues[0].Value));
    }
}

Ez a példa töröl egy meglévő rendelési elemet, hozzáad egy új elemet, és menti a módosításokat az adatbázisba.

// Specify the order to update.
int orderId = 43680;

using (AdventureWorksEntities context =
    new AdventureWorksEntities())
{
    try
    {
        var order = (from o in context.SalesOrderHeaders
                     where o.SalesOrderID == orderId
                     select o).First();

        // Change the status and ship date of an existing order.
        order.Status = 1;
        order.ShipDate = DateTime.Today;

        // You do not have to call the Load method to load the details for the order,
        // because  lazy loading is set to true
        // by the constructor of the AdventureWorksEntities object.
        // With  lazy loading set to true the related objects are loaded when
        // you access the navigation property. In this case SalesOrderDetails.

        // Delete the first item in the order.
        context.DeleteObject(order.SalesOrderDetails.First());

        // Create a new SalesOrderDetail object.
        // You can use the static CreateObjectName method (the Entity Framework
        // adds this method to the generated entity types) instead of the new operator:
        // SalesOrderDetail.CreateSalesOrderDetail(1, 0, 2, 750, 1, (decimal)2171.2942, 0, 0,
        //                                         Guid.NewGuid(), DateTime.Today));
        SalesOrderDetail detail = new SalesOrderDetail
        {
            SalesOrderID = 1,
            SalesOrderDetailID = 0,
            OrderQty = 2,
            ProductID = 750,
            SpecialOfferID = 1,
            UnitPrice = (decimal)2171.2942,
            UnitPriceDiscount = 0,
            LineTotal = 0,
            rowguid = Guid.NewGuid(),
            ModifiedDate = DateTime.Now
        };

        order.SalesOrderDetails.Add(detail);

        // Save changes in the object context to the database.
        int changes = context.SaveChanges();

        Console.WriteLine(changes.ToString() + " changes saved!");
        Console.WriteLine("Updated item for order: "
            + order.SalesOrderID.ToString());

        foreach (SalesOrderDetail item in order.SalesOrderDetails)
        {
            Console.WriteLine("Item ID: "
                + item.SalesOrderDetailID.ToString() + "  Product: "
                + item.ProductID.ToString() + "  Quantity: "
                + item.OrderQty.ToString());
        }
    }
    catch (UpdateException ex)
    {
        Console.WriteLine(ex.ToString());
    }
}

Megjegyzések

Egy objektumot jelöl meg a törléshez a .- ObjectStateManagerból. A metódus meghívásakor az objektum törlődik az SaveChanges adatforrásból.

A szülőobjektum törlése a korlátozott kapcsolat összes gyermekobjektumát is törli. Ez az eredmény megegyezik a CascadeDelete kapcsolat társításának tulajdonságának engedélyezésével.

A DeleteObject metódus meghívható a már törölt objektumokra.

A következőre érvényes:

Lásd még