ObjectContext.Detach(Object) Método

  • Referencia

Definición

Espacio de nombres:
System.Data.Objects
Ensamblado:
System.Data.Entity.dll

Quita el objeto del contexto del objeto.

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

Parámetros

entity
Object

Objeto que se va a desasociar. Solamente se quita el objeto entity; si hay objetos relacionados de los que el mismo ObjectStateManager realiza un seguimiento, dichos objetos no se desasociarán automáticamente.

Excepciones

ArgumentNullException

El valor de entity es null.

InvalidOperationException

entity no está asociada a este ObjectContext (por ejemplo, se creó recientemente y todavía no se ha asociado con ningún contexto, se obtuvo a través de algún otro contexto o ya estaba desasociada).

Ejemplos

// This method is called to detach SalesOrderHeader objects and
// related SalesOrderDetail objects from the supplied object
// context when no longer needed by the application.
// Once detached, the resources can be garbage collected.
private static void DetachOrders(ObjectContext context,
    SalesOrderHeader order)
{
    try
    {
        // Detach each item from the collection.
        while (order.SalesOrderDetails.Count > 0)
        {
            // Detach the first SalesOrderDetail in the collection.
            context.Detach(order.SalesOrderDetails.First());
        }

        // Detach the order.
        context.Detach(order);
    }
    catch (InvalidOperationException ex)
    {
        Console.WriteLine(ex.ToString());
    }
}

Comentarios

Quita el objeto del ObjectStateManager. Esto deshabilita el seguimiento de cambios y la resolución de identidades para ese objeto. Para más información, consulte Adjuntar y desasociar objetos.

Después de llamar al método Detach, el sistema dejará de mantener referencias que señalan este objeto y el recolector de elementos no utilizados puede recogerlo.

Nota

La recolección de elementos no utilizados solo se puede producir si el código de usuario no tiene ninguna referencia al objeto desasociado.

Al desasociar objetos deben tenerse en cuenta las consideraciones siguientes:

  • Detach solo afecta al objeto específico que se pasa al método. Si el objeto que se desasocia tiene objetos relacionados en el contexto del objeto, esos objetos no se desasocian.

  • La desasociación de objetos no afecta a los datos del origen de datos.

  • Durante una operación de desasociar, no se aplican las directivas de eliminación en cascada ni las restricciones referenciales en cascada.

Para más información, consulte Adjuntar y desasociar objetos.

Se aplica a

Consulte también