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.
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.ObjectStateEntryPublic 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 sourceEntity that returns the specified targetEntity.
- 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 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.
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:
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.ObjectStateEntryPublic 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 targetEntity 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.
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.
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.
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 ObjectStateEntryType 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
The ObjectStateEntry for the relationship that was changed.
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.
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.
