ObjectStateManager.ChangeRelationshipState Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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. |
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 virtual System.Data.Entity.Core.Objects.ObjectStateEntry ChangeRelationshipState (object sourceEntity, object targetEntity, string navigationProperty, System.Data.Entity.EntityState relationshipState);abstract member ChangeRelationshipState : obj * obj * string * System.Data.Entity.EntityState -> System.Data.Entity.Core.Objects.ObjectStateEntry
override this.ChangeRelationshipState : obj * obj * string * System.Data.Entity.EntityState -> System.Data.Entity.Core.Objects.ObjectStateEntryPublic Overridable Function ChangeRelationshipState (sourceEntity As Object, targetEntity As Object, navigationProperty As String, relationshipState As EntityState) As ObjectStateEntryParameters
- 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 source that returns the specified target .
- relationshipState
- EntityState
The requested EntityState of the specified relationship.
Returns
The ObjectStateEntry for the relationship that was changed.
Exceptions
When source or target is null.
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 state or when state is not a valid EntityState value
Applies to
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 virtual System.Data.Entity.Core.Objects.ObjectStateEntry ChangeRelationshipState (object sourceEntity, object targetEntity, string relationshipName, string targetRoleName, System.Data.Entity.EntityState relationshipState);abstract member ChangeRelationshipState : obj * obj * string * string * System.Data.Entity.EntityState -> System.Data.Entity.Core.Objects.ObjectStateEntry
override this.ChangeRelationshipState : obj * obj * string * string * System.Data.Entity.EntityState -> System.Data.Entity.Core.Objects.ObjectStateEntryPublic Overridable Function ChangeRelationshipState (sourceEntity As Object, targetEntity As Object, relationshipName As String, targetRoleName As String, relationshipState As EntityState) As ObjectStateEntryParameters
- 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 target end of the relationship.
- relationshipState
- EntityState
The requested EntityState of the specified relationship.
Returns
The ObjectStateEntry for the relationship that was changed.
Exceptions
When source or target is null.
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.
Applies to
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.
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1006:DoNotNestGenericTypesInMemberSignatures")]
public virtual System.Data.Entity.Core.Objects.ObjectStateEntry ChangeRelationshipState<TEntity> (TEntity sourceEntity, object targetEntity, System.Linq.Expressions.Expression<Func<TEntity,object>> navigationPropertySelector, System.Data.Entity.EntityState relationshipState) where TEntity : class;abstract member ChangeRelationshipState : 'Entity * obj * System.Linq.Expressions.Expression<Func<'Entity, obj>> * System.Data.Entity.EntityState -> System.Data.Entity.Core.Objects.ObjectStateEntry (requires 'Entity : null)
override this.ChangeRelationshipState : 'Entity * obj * System.Linq.Expressions.Expression<Func<'Entity, obj>> * System.Data.Entity.EntityState -> System.Data.Entity.Core.Objects.ObjectStateEntry (requires 'Entity : null)Public Overridable Function ChangeRelationshipState(Of TEntity As Class) (sourceEntity As TEntity, targetEntity As Object, navigationPropertySelector As Expression(Of Func(Of TEntity, Object)), relationshipState As EntityState) As ObjectStateEntryType Parameters
- TEntity
The entity type of the source 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 source that returns the specified target .
- relationshipState
- EntityState
The requested EntityState of the specified relationship.
Returns
The ObjectStateEntry for the relationship that was changed.
- Attributes
Exceptions
When source , target , or selector is null.
selector is malformed or cannot return a navigation property.
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.
Applies to
Entity Framework