ObjectContext.Refresh 方法

定义

命名空间:
System.Data.Objects
程序集:
System.Data.Entity.dll

使用数据源中的数据更新对象上下文中的特定对象。

重载

名称 说明
Refresh(RefreshMode, IEnumerable)

使用数据源中的数据更新对象上下文中的对象集合。
Refresh(RefreshMode, Object)

使用数据源中的数据更新对象上下文中的对象。

注解

刷新对象的顺序是不确定的。

Refresh(RefreshMode, IEnumerable)

使用数据源中的数据更新对象上下文中的对象集合。

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)

参数

refreshMode
RefreshMode

一个 RefreshMode 值，该值指示是否用数据源中的属性值覆盖对象上下文中的属性更改。

collection
IEnumerable

IEnumerable要刷新的对象集合。

例外

ArgumentNullException

collection 是 null。

ArgumentOutOfRangeException

refreshMode 无效。

ArgumentException

collection 为空。

-或-

对象未附加到上下文。

注解

此方法具有允许对象上下文中的对象使用数据源中的数据进行刷新的双重用途，并成为可以解决冲突的机制。

刷新对象的顺序是不确定的。

调用后 Refresh ，对象的原始值将始终使用数据源值进行更新，但当前值可能或可能不会使用数据源值更新。 RefreshMode这取决于值。 模式 StoreWins 意味着应更新集合中的对象以匹配数据源值。 ClientWins 表示即使数据源中存在其他更改，也只会保留对象上下文中的更改。

若要确保数据源端逻辑更新了对象，可以在调用SaveChanges该方法后调用RefreshStoreWins对象。

另请参阅

适用于

Refresh(RefreshMode, Object)

使用数据源中的数据更新对象上下文中的对象。

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)

参数

refreshMode
RefreshMode

值之 RefreshMode 一，指定用于刷新该模式的 ObjectStateManager模式。

entity
Object

要刷新的对象。

例外

ArgumentOutOfRangeException

refreshMode 无效。

ArgumentException

对象未附加到上下文。

示例

此示例尝试保存更改，这可能会导致并发冲突。 然后，它演示如何通过在重新保存更改之前刷新对象上下文来解决并发冲突。

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());
    }
}

注解

Refresh 具有允许使用数据源中的数据刷新对象以及通过该机制解决冲突的双重目的。

刷新对象的顺序是不确定的。

Refresh调用该方法后，对象的原始值将始终使用数据源值进行更新，但当前值可能或可能不会使用数据源值更新。 RefreshMode这取决于 . 模式 StoreWins 表示应更新对象以匹配数据源值。 该值 ClientWins 表示即使数据源中发生了其他更改，也只会保留对象上下文中的更改。

若要确保数据源端逻辑已更新对象，可以在调用该方法后使用StoreWins值调用RefreshSaveChanges该方法。

另请参阅

适用于