IRelatedEnd Schnittstelle
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Definiert das Ende einer Beziehung.
public interface class IRelatedEnd
public interface IRelatedEnd
type IRelatedEnd = interface
Public Interface IRelatedEnd
- Abgeleitet
Beispiele
Im folgenden Beispiel werden der Contact
Entität neue SalesOrderHeader
Entitäten hinzugefügt. Anschließend ruft sie alle verwandten Enden von der Contact
Entität ab und zeigt den Beziehungsnamen, den Namen der Quellrolle und den Namen der Zielrolle für jedes zugehörige Ende an.
using (AdventureWorksEntities context =
new AdventureWorksEntities())
{
Contact contact = new Contact();
// Create a new SalesOrderHeader.
SalesOrderHeader newSalesOrder1 = new SalesOrderHeader();
// Add SalesOrderHeader to the Contact.
contact.SalesOrderHeaders.Add(newSalesOrder1);
// Create another SalesOrderHeader.
SalesOrderHeader newSalesOrder2 = new SalesOrderHeader();
// Add SalesOrderHeader to the Contact.
contact.SalesOrderHeaders.Add(newSalesOrder2);
// Get all related ends
IEnumerable<IRelatedEnd> relEnds =
((IEntityWithRelationships)contact).RelationshipManager
.GetAllRelatedEnds();
foreach (IRelatedEnd relEnd in relEnds)
{
Console.WriteLine("Relationship Name: {0}", relEnd.RelationshipName);
Console.WriteLine("Source Role Name: {0}", relEnd.SourceRoleName);
Console.WriteLine("Target Role Name: {0}", relEnd.TargetRoleName);
}
}
Hinweise
IRelatedEnd definiert die Anforderungen für ein -Objekt, das ein Ende in einer Zuordnung darstellt. Diese Schnittstelle wird von der RelatedEnd -Klasse implementiert. RelatedEndist die Basisklasse für die - und EntityReference<TEntity> -EntityCollection<TEntity>Klasse.
Eigenschaften
IsLoaded |
Ruft einen Wert ab, der angibt, ob alle verknüpften Objekte geladen wurden. |
RelationshipName |
Ruft den Namen der Beziehung ab, der dieses verknüpfte Ende angehört. |
RelationshipSet |
Gibt einen Verweis auf die Metadaten für das verknüpfte Ende zurück. |
SourceRoleName |
Ruft den Rollennamen am Quellenende der Beziehung ab. |
TargetRoleName |
Ruft den Rollennamen am Zielende der Beziehung ab. |
Methoden
Add(IEntityWithRelationships) |
Fügt dem verknüpften Ende ein Objekt hinzu. |
Add(Object) |
Fügt dem verknüpften Ende ein Objekt hinzu. |
Attach(IEntityWithRelationships) |
Definiert eine Beziehung zwischen zwei angefügten Objekten. |
Attach(Object) |
Definiert eine Beziehung zwischen zwei angefügten Objekten. |
CreateSourceQuery() |
Gibt eine IEnumerable zurück, die die zum verknüpften Ende gehörenden Objekte darstellt. |
GetEnumerator() |
Gibt einen IEnumerator zurück, der die Auflistung verbundener Objekte durchläuft. |
Load() |
Lädt das verbundene Objekt bzw. die verbundenen Objekte mit der Standardzusammenführungsoption in dieses verknüpfte Ende. |
Load(MergeOption) |
Lädt das verbundene Objekt bzw. die verbundenen Objekte mit der angegebenen Mergeoption in das verknüpfte Ende. |
Remove(IEntityWithRelationships) |
Entfernt ein Objekt aus der Auflistung der Objekte am verknüpften Ende. |
Remove(Object) |
Entfernt ein Objekt aus der Auflistung der Objekte am verknüpften Ende. |