Данная статья переведена с помощью средств машинного перевода. Чтобы просмотреть ее на английском языке, установите флажок Английский. Вы также можете просматривать английский текст во всплывающем окне, наводя указатель мыши на переведенный текст.
Перевод
Английский

Класс ObjectStateManager

 

Опубликовано: Октябрь 2016

Поддерживает состояние объекта и обеспечивает управление идентификаторами для экземпляров типа сущности и экземпляров связи.

Пространство имен:   System.Data.Objects
Сборка:  System.Data.Entity (в System.Data.Entity.dll)

System.Object
  System.Data.Objects.ObjectStateManager

public class ObjectStateManager

ИмяОписание
System_CAPS_pubmethodObjectStateManager(MetadataWorkspace)

Инициализирует новый экземпляр класса ObjectStateManager.

ИмяОписание
System_CAPS_pubpropertyMetadataWorkspace

Возвращает рабочую область метаданных MetadataWorkspace, связанную с этим диспетчером состояний.

ИмяОписание
System_CAPS_pubmethodChangeObjectState(Object, EntityState)

Изменяет состояние записи ObjectStateEntry для определенного объекта на указанное состояние entityState.

System_CAPS_pubmethodChangeRelationshipState(Object, Object, String, EntityState)

Изменяет состояние отношения между двумя объектами сущностей, заданное на основании двух связанных объектов и имени свойства навигации.

System_CAPS_pubmethodChangeRelationshipState(Object, Object, String, String, EntityState)

Изменяет состояние отношения между двумя объектами сущностей, заданное на основании двух связанных объектов и свойств отношения.

System_CAPS_pubmethodChangeRelationshipState<TEntity>(TEntity, Object, Expression<Func<TEntity, Object>>, EntityState)

Изменяет состояние отношения между двумя объектами сущностей, заданное на основании двух связанных объектов и выражения LINQ, определяющего свойство навигации.

System_CAPS_pubmethodEquals(Object)

Определяет, равен ли заданный объект текущему объекту.(Наследуется от Object.)

System_CAPS_protmethodFinalize()

Позволяет объекту попытаться освободить ресурсы и выполнить другие операции очистки, перед тем как он будет уничтожен во время сборки мусора.(Наследуется от Object.)

System_CAPS_pubmethodGetHashCode()

Служит хэш-функцией по умолчанию.(Наследуется от Object.)

System_CAPS_pubmethodGetObjectStateEntries(EntityState)

Возвращает коллекцию объектов ObjectStateEntry для объектов или связей с заданным состоянием.

System_CAPS_pubmethodGetObjectStateEntry(EntityKey)

Возвращает запись ObjectStateEntry для объекта или запись связи с указанным ключом.

System_CAPS_pubmethodGetObjectStateEntry(Object)

Возвращает запись ObjectStateEntry для указанного объекта.

System_CAPS_pubmethodGetRelationshipManager(Object)

Возвращает объект RelationshipManager, используемый указанным объектом.

System_CAPS_pubmethodGetType()

Возвращает объект Type для текущего экземпляра.(Наследуется от Object.)

System_CAPS_protmethodMemberwiseClone()

Создает неполную копию текущего объекта Object.(Наследуется от Object.)

System_CAPS_pubmethodToString()

Возвращает строку, представляющую текущий объект.(Наследуется от Object.)

System_CAPS_pubmethodTryGetObjectStateEntry(EntityKey, ObjectStateEntry)

Пытается получить элемент ObjectStateEntry для объекта или связи с указанным ключом EntityKey.

System_CAPS_pubmethodTryGetObjectStateEntry(Object, ObjectStateEntry)

Пытается получить элемент ObjectStateEntry, соответствующий указанному объекту Object.

System_CAPS_pubmethodTryGetRelationshipManager(Object, RelationshipManager)

Возвращает объект RelationshipManager, используемый указанным объектом.

ИмяОписание
System_CAPS_pubeventObjectStateManagerChanged

Событие происходит при добавлении или удалении сущностей из диспетчера состояний.

Диспетчер ObjectStateManager отслеживает результаты запроса и предоставляет бизнес-логику, применяемую для слияния нескольких перекрывающихся результатов запросов. В нем также выполняется отслеживание изменений в оперативной памяти при вставке, удалении или изменении объектов пользователем, кроме того, предоставляется набор изменений для обновлений. Этот набор изменений используется обработчиком изменений для сохранения внесенных изменений.

Этот класс обычно используется в контексте объекта ObjectContext, а не непосредственно в приложениях.

Эти примеры основаны на модель AdventureWorks Sales.

В следующем примере диспетчер ObjectStateManager возвращается из контекста объекта ObjectContext и используется для получения доступа к объекту в этом контексте.

int orderId = 43680;

using (AdventureWorksEntities context =
    new AdventureWorksEntities())
{
    ObjectStateManager objectStateManager = context.ObjectStateManager;
    ObjectStateEntry stateEntry = null;

    var order = (from o in context.SalesOrderHeaders
                 where o.SalesOrderID == orderId
                 select o).First();

    // Attempts to retrieve ObjectStateEntry for the given EntityKey.
    bool isPresent = objectStateManager.TryGetObjectStateEntry(((IEntityWithKey)order).EntityKey, out stateEntry);
    if (isPresent)
    {
        Console.WriteLine("The entity was found");
    }
}

В следующем примере используется метод TryGetObjectStateEntry(EntityKey, ObjectStateEntry) для возвращаемого диспетчера ObjectStateManager, чтобы получить объект по его ключу сущности.

private static void ApplyItemUpdates(SalesOrderDetail originalItem,
    SalesOrderDetail updatedItem)
{
    using (AdventureWorksEntities context =
        new AdventureWorksEntities())
    {
        context.SalesOrderDetails.Attach(updatedItem);
        // Check if the ID is 0, if it is the item is new. 
        // In this case we need to chage the state to Added.
        if (updatedItem.SalesOrderDetailID == 0)
        {
            // Because the ID is generated by the database we do not need to
            // set updatedItem.SalesOrderDetailID.
            context.ObjectStateManager.ChangeObjectState(updatedItem, System.Data.EntityState.Added);
        }
        else
        {
            // If the SalesOrderDetailID is not 0, then the item is not new
            // and needs to be updated. Because we already added the 
            // updated object to the context we need to apply the original values.
            // If we attached originalItem to the context 
            // we would need to apply the current values:
            // context.ApplyCurrentValues("SalesOrderDetails", updatedItem);
            // Applying current or original values, changes the state 
            // of the attached object to Modified.
            context.ApplyOriginalValues("SalesOrderDetails", originalItem);
        }
        context.SaveChanges();
    }
}

.NET Framework
Доступно с 3.5

Любые открытые статические элементы ( Предоставлен общий доступ в Visual Basic) этого типа являются потокобезопасными. Потокобезопасность элементов экземпляров не гарантируется.

Вернуться в начало
Показ: