IRelatedEnd.Add 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.
Adds an object to the related end.
Overloads
| Add(IEntityWithRelationships) |
Adds an object to the related end. |
| Add(Object) |
Adds an object to the related end. |
Add(IEntityWithRelationships)
Adds an object to the related end.
public:
void Add(System::Data::Objects::DataClasses::IEntityWithRelationships ^ entity);public void Add (System.Data.Objects.DataClasses.IEntityWithRelationships entity);abstract member Add : System.Data.Objects.DataClasses.IEntityWithRelationships -> unitPublic Sub Add (entity As IEntityWithRelationships)Parameters
- entity
- IEntityWithRelationships
An object to add to the collection. entity must implement IEntityWithRelationships.
Remarks
The Add method adds an object to the related end. The related end must be an EntityCollection<TEntity>.
When the source object implements IEntityWithRelationships and is being tracked in the ObjectStateManager, the object being added is also tracked.
The RelatedEnd class explicitly implements the Add method. The EntityCollection<TEntity> class uses this implementation. For more information, see Add.
If the related end is an EntityReference<TEntity> and the Value property of the reference is not null, this method throws an exception.
Applies to
Add(Object)
Adds an object to the related end.
public:
void Add(System::Object ^ entity);public void Add (object entity);abstract member Add : obj -> unitPublic Sub Add (entity As Object)Parameters
- entity
- Object
An object to add to the collection.
Remarks
Use this method overload for entity classes that do not implement IEntityWithRelationships. Use the Add method for entity classes that do implement IEntityWithRelationships.
The Add method adds an object to the related end. The related end must be an EntityCollection<TEntity>.
The RelatedEnd class explicitly implements the Add method. The EntityCollection<TEntity> class uses this implementation. For more information, see Add.
If the related end is an EntityReference<TEntity> and the Value property of the reference is not null, this method throws an exception.
