ObjectStateManager.ChangeRelationshipState Method

Definition

Namespace:

System.Data.Objects

Assembly:

System.Data.Entity.dll

Changes the state of the specified relationship between two entity objects.

Overloads

ChangeRelationshipState(Object, Object, String, EntityState)	Changes the state of the relationship between two entity objects that is specified based on the two related objects and the name of the navigation property.
ChangeRelationshipState(Object, Object, String, String, EntityState)	Changes the state of the relationship between two entity objects that is specified based on the two related objects and the properties of the relationship.
ChangeRelationshipState<TEntity>(TEntity, Object, Expression<Func<TEntity,Object>>, EntityState)	Changes the state of the relationship between two entity objects that is specified based on the two related objects and a LINQ expression that defines the navigation property.

Remarks

This method is not supported for relationships based on a foreign key association.

ChangeRelationshipState(Object, Object, String, EntityState)

Changes the state of the relationship between two entity objects that is specified based on the two related objects and the name of the navigation property.

public:
 System::Data::Objects::ObjectStateEntry ^ ChangeRelationshipState(System::Object ^ sourceEntity, System::Object ^ targetEntity, System::String ^ navigationProperty, System::Data::EntityState relationshipState);

public System.Data.Objects.ObjectStateEntry ChangeRelationshipState (object sourceEntity, object targetEntity, string navigationProperty, System.Data.EntityState relationshipState);

member this.ChangeRelationshipState : obj * obj * string * System.Data.EntityState -> System.Data.Objects.ObjectStateEntry

Public Function ChangeRelationshipState (sourceEntity As Object, targetEntity As Object, navigationProperty As String, relationshipState As EntityState) As ObjectStateEntry

Parameters

sourceEntity

Object

The object instance or EntityKey of the source entity at one end of the relationship.

targetEntity

Object

The object instance or EntityKey of the target entity at the other end of the relationship.

navigationProperty

String

The name of the navigation property on sourceEntity that returns the specified targetEntity.

relationshipState

EntityState

The requested EntityState of the specified relationship.

Returns

ObjectStateEntry

The ObjectStateEntry for the relationship that was changed.

Exceptions

ArgumentNullException

When source or target is null.

InvalidOperationException

When trying to change the state of the relationship to a state other than Deleted or Detached when either source or target is in a Deleted state.

-or-

When you try to change the state of the relationship to a state other than Added or Detached when either source or target is in an Added state.

-or-

When state is not a valid EntityState value.

Remarks

Entries for the objects at both ends of the specified relationship must exist in the ObjectStateManager.

Note

This method is not supported for relationships based on a foreign key association.

ChangeRelationshipState(Object, Object, String, String, EntityState)

Changes the state of the relationship between two entity objects that is specified based on the two related objects and the properties of the relationship.

public:
 System::Data::Objects::ObjectStateEntry ^ ChangeRelationshipState(System::Object ^ sourceEntity, System::Object ^ targetEntity, System::String ^ relationshipName, System::String ^ targetRoleName, System::Data::EntityState relationshipState);

public System.Data.Objects.ObjectStateEntry ChangeRelationshipState (object sourceEntity, object targetEntity, string relationshipName, string targetRoleName, System.Data.EntityState relationshipState);

member this.ChangeRelationshipState : obj * obj * string * string * System.Data.EntityState -> System.Data.Objects.ObjectStateEntry

Public Function ChangeRelationshipState (sourceEntity As Object, targetEntity As Object, relationshipName As String, targetRoleName As String, relationshipState As EntityState) As ObjectStateEntry

Parameters

sourceEntity

Object

The object instance or EntityKey of the source entity at one end of the relationship.

targetEntity

Object

The object instance or EntityKey of the target entity at the other end of the relationship.

relationshipName

String

The name of the relationship.

targetRoleName

String

The role name at the targetEntity end of the relationship.

relationshipState

EntityState

The requested EntityState of the specified relationship.

Returns

ObjectStateEntry

The ObjectStateEntry for the relationship that was changed.

Exceptions

ArgumentNullException

When source or target is null.

InvalidOperationException

When you try to change the state of the relationship to a state other than Deleted or Detached when either source or target is in a Deleted state.

-or-

When you try to change the state of the relationship to a state other than Added or Detached when either source or target is in an Added state.

-or-

When state is not a valid EntityState value.

Remarks

Entries for the objects at both ends of the specified relationship must exist in the ObjectStateManager.

Note

This method is not supported for relationships that are based on a foreign key association. For more information, see Defining and Managing Relationships.

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

Changes the state of the relationship between two entity objects that is specified based on the two related objects and a LINQ expression that defines the navigation property.

public:
generic <typename TEntity>
 where TEntity : class System::Data::Objects::ObjectStateEntry ^ ChangeRelationshipState(TEntity sourceEntity, System::Object ^ targetEntity, System::Linq::Expressions::Expression<Func<TEntity, System::Object ^> ^> ^ navigationPropertySelector, System::Data::EntityState relationshipState);

public System.Data.Objects.ObjectStateEntry ChangeRelationshipState<TEntity> (TEntity sourceEntity, object targetEntity, System.Linq.Expressions.Expression<Func<TEntity,object>> navigationPropertySelector, System.Data.EntityState relationshipState) where TEntity : class;

member this.ChangeRelationshipState : 'Entity * obj * System.Linq.Expressions.Expression<Func<'Entity, obj>> * System.Data.EntityState -> System.Data.Objects.ObjectStateEntry (requires 'Entity : null)

Public Function ChangeRelationshipState(Of TEntity As Class) (sourceEntity As TEntity, targetEntity As Object, navigationPropertySelector As Expression(Of Func(Of TEntity, Object)), relationshipState As EntityState) As ObjectStateEntry

Type Parameters

TEntity

The entity type of the sourceEntity object.

Parameters

sourceEntity

TEntity

The object instance or EntityKey of the source entity at one end of the relationship.

targetEntity

Object

The object instance or EntityKey of the target entity at the other end of the relationship.

navigationPropertySelector

Expression<Func<TEntity,Object>>

A LINQ expression that selects the navigation property on sourceEntity that returns the specified targetEntity.

relationshipState

EntityState

The requested EntityState of the specified relationship.

Returns

ObjectStateEntry

The ObjectStateEntry for the relationship that was changed.

Exceptions

ArgumentNullException

When source, target, or selector is null.

ArgumentException

selector is malformed or cannot return a navigation property.

InvalidOperationException

When you try to change the state of the relationship to a state other than Deleted or Detached when either source or target is in a Deleted state.

-or-

When you try to change the state of the relationship to a state other than Added or Detached when either source or target is in an Added state.

-or-

When state is not a valid EntityState value.

Remarks

Entries for the objects at both ends of the specified relationship must exist in the ObjectStateManager.

Note

This method is not supported for relationships that are based on a foreign key association.