ObjectContext.Refresh Methode

Definition

Namespace:

System.Data.Objects

Assembly:

System.Data.Entity.dll

Aktualisiert bestimmte Objekte im Objektkontext mit Daten aus der Datenquelle.

Überlädt

Refresh(RefreshMode, IEnumerable)	Aktualisiert eine Auflistung von Objekten im Objektkontext mit Daten aus der Datenquelle.
Refresh(RefreshMode, Object)	Aktualisiert ein Objekt im Objektkontext mit Daten aus der Datenquelle.

Hinweise

Die Reihenfolge, in der Objekte aktualisiert werden, ist nicht deterministisch.

Refresh(RefreshMode, IEnumerable)

Aktualisiert eine Auflistung von Objekten im Objektkontext mit Daten aus der Datenquelle.

public:
 void Refresh(System::Data::Objects::RefreshMode refreshMode, System::Collections::IEnumerable ^ collection);

public void Refresh (System.Data.Objects.RefreshMode refreshMode, System.Collections.IEnumerable collection);

member this.Refresh : System.Data.Objects.RefreshMode * System.Collections.IEnumerable -> unit

Public Sub Refresh (refreshMode As RefreshMode, collection As IEnumerable)

Parameter

refreshMode

RefreshMode

Ein RefreshMode-Wert, der angibt, ob Eigenschaftsänderungen im Objektkontext durch Eigenschaftswerte aus der Datenquelle überschrieben werden.

collection

IEnumerable

Eine IEnumerable-Auflistung von zu aktualisierenden Objekten.

Ausnahmen

ArgumentNullException

collection ist null.

ArgumentOutOfRangeException

refreshMode ist nicht gültig.

ArgumentException

collection ist leer.

- oder -

Ein Objekt ist nicht an den Kontext angefügt.

Hinweise

Diese Methode hat den doppelten Zweck, zu ermöglichen, dass Objekte im Objektkontext mit Daten aus der Datenquelle aktualisiert werden, und ist der Mechanismus, mit dem Konflikte gelöst werden können. Weitere Informationen finden Sie unter Speichern von Änderungen und Verwalten von Parallelität.

Die Reihenfolge, in der Objekte aktualisiert werden, ist nicht deterministisch.

Nachdem Refresh aufgerufen wurde, werden die ursprünglichen Werte des Objekts immer mit dem Datenquellenwert aktualisiert, aber die aktuellen Werte werden möglicherweise mit dem Datenquellenwert aktualisiert. Dies ist abhängig vom RefreshMode-Wert. Der StoreWins Modus bedeutet, dass die Objekte in der Auflistung so aktualisiert werden sollen, dass sie den Datenquellenwerten entsprechen. ClientWins bedeutet, dass nur die Änderungen im Objektkontext beibehalten werden, auch wenn andere Änderungen in der Datenquelle vorgenommen wurden.

Um sicherzustellen, dass Objekte von der datenquellenseitigen Logik aktualisiert wurden, können Sie mit StoreWins aufrufenRefresh, nachdem Sie die SaveChanges -Methode aufgerufen haben.

Weitere Informationen

• Arbeiten mit Objekten (Entity Framework)

Refresh(RefreshMode, Object)

Aktualisiert ein Objekt im Objektkontext mit Daten aus der Datenquelle.

public:
 void Refresh(System::Data::Objects::RefreshMode refreshMode, System::Object ^ entity);

public void Refresh (System.Data.Objects.RefreshMode refreshMode, object entity);

member this.Refresh : System.Data.Objects.RefreshMode * obj -> unit

Public Sub Refresh (refreshMode As RefreshMode, entity As Object)

Parameter

refreshMode

RefreshMode

Einer der RefreshMode-Werte, der den Modus zum Aktualisieren des ObjectStateManager angibt.

entity

Object

Das zu aktualisierende Objekt.

Ausnahmen

ArgumentNullException

collection ist null.

ArgumentOutOfRangeException

refreshMode ist nicht gültig.

ArgumentException

collection ist leer.

- oder -

Ein Objekt ist nicht an den Kontext angefügt.

Beispiele

In diesem Beispiel wird versucht, Änderungen zu speichern, was zu einem Parallelitätskonflikt führen kann. Anschließend wird gezeigt, wie der Parallelitätskonflikt gelöst wird, indem der Objektkontext aktualisiert wird, bevor die Änderungen erneut gespeichert werden.

using (AdventureWorksEntities context =
    new AdventureWorksEntities())
{
    try
    {
        // Perform an operation with a high-level of concurrency.
        // Change the status of all orders without an approval code.
        ObjectQuery<SalesOrderHeader> orders =
            context.SalesOrderHeaders.Where(
            "it.CreditCardApprovalCode IS NULL").Top("100");

        foreach (SalesOrderHeader order in orders)
        {
            // Reset the order status to 4 = Rejected.
            order.Status = 4;
        }
        try
        {
            // Try to save changes, which may cause a conflict.
            int num = context.SaveChanges();
            Console.WriteLine("No conflicts. " +
                num.ToString() + " updates saved.");
        }
        catch (OptimisticConcurrencyException)
        {
            // Resolve the concurrency conflict by refreshing the
            // object context before re-saving changes.
            context.Refresh(RefreshMode.ClientWins, orders);

            // Save changes.
            context.SaveChanges();
            Console.WriteLine("OptimisticConcurrencyException "
            + "handled and changes saved");
        }

        foreach (SalesOrderHeader order in orders)
        {
            Console.WriteLine("Order ID: " + order.SalesOrderID.ToString()
                + " Order status: " + order.Status.ToString());
        }
    }
    catch (UpdateException ex)
    {
        Console.WriteLine(ex.ToString());
    }
}

Hinweise

Refresh hat den doppelten Zweck, ein Objekt mit Daten aus der Datenquelle zu aktualisieren und der Mechanismus zu sein, mit dem Konflikte gelöst werden können. Weitere Informationen finden Sie unter Speichern von Änderungen und Verwalten von Parallelität.

Die Reihenfolge, in der Objekte aktualisiert werden, ist nicht deterministisch.

Nachdem die Refresh -Methode aufgerufen wurde, werden die ursprünglichen Werte des Objekts immer mit dem Datenquellenwert aktualisiert, aber die aktuellen Werte werden möglicherweise mit dem Datenquellenwert aktualisiert. Dies ist abhängig vom RefreshMode. Der StoreWins Modus bedeutet, dass das Objekt aktualisiert werden muss, um den Datenquellenwerten zu entsprechen. Der ClientWins -Wert bedeutet, dass nur die Änderungen im Objektkontext beibehalten werden, auch wenn andere Änderungen in der Datenquelle vorgenommen wurden.

Um sicherzustellen, dass ein Objekt von der datenquellenseitigen Logik aktualisiert wurde, können Sie die Refresh -Methode mit dem StoreWins -Wert aufrufen, nachdem Sie die SaveChanges -Methode aufgerufen haben.

Weitere Informationen

• Arbeiten mit Objekten (Entity Framework)