Freigeben über


IConventionNavigation Schnittstelle

Definition

Stellt eine Navigationseigenschaft dar, die zum Navigieren in einer Beziehung verwendet werden kann.

public interface IConventionNavigation : Microsoft.EntityFrameworkCore.Metadata.IConventionPropertyBase, Microsoft.EntityFrameworkCore.Metadata.INavigation
public interface IConventionNavigation : Microsoft.EntityFrameworkCore.Metadata.IConventionNavigationBase, Microsoft.EntityFrameworkCore.Metadata.INavigation
public interface IConventionNavigation : Microsoft.EntityFrameworkCore.Metadata.IConventionNavigationBase, Microsoft.EntityFrameworkCore.Metadata.IReadOnlyNavigation
type IConventionNavigation = interface
    interface INavigation
    interface IPropertyBase
    interface IAnnotatable
    interface IConventionPropertyBase
    interface IConventionAnnotatable
type IConventionNavigation = interface
    interface INavigation
    interface INavigationBase
    interface IPropertyBase
    interface IAnnotatable
    interface IConventionNavigationBase
    interface IConventionPropertyBase
    interface IConventionAnnotatable
type IConventionNavigation = interface
    interface IReadOnlyNavigation
    interface IReadOnlyNavigationBase
    interface IReadOnlyPropertyBase
    interface IReadOnlyAnnotatable
    interface IConventionNavigationBase
    interface IConventionPropertyBase
    interface IConventionAnnotatable
Public Interface IConventionNavigation
Implements IConventionPropertyBase, INavigation
Public Interface IConventionNavigation
Implements IConventionNavigationBase, INavigation
Public Interface IConventionNavigation
Implements IConventionNavigationBase, IReadOnlyNavigation
Implementiert

Hinweise

Diese Schnittstelle wird während der Modellerstellung verwendet und ermöglicht das Ändern der Metadaten. Sobald das Modell erstellt wurde, INavigation stellt eine schreibgeschützte Ansicht der gleichen Metadaten dar.

Weitere Informationen und Beispiele finden Sie unter Modellerstellungskonventionen .

Eigenschaften

Builder

Ruft den Generator ab, der zum Konfigurieren dieser Navigation verwendet werden kann.

ClrType

Ruft den Werttyp ab, den dieses eigenschaftsähnliche Objekt enthält.

(Geerbt von IReadOnlyPropertyBase)
DeclaringEntityType

Ruft den Typ ab, zu dem diese Navigationseigenschaft gehört.

DeclaringType

Ruft den Typ ab, zu dem dieses eigenschaftsähnliche Objekt gehört.

(Geerbt von IReadOnlyPropertyBase)
FieldInfo

Ruft das FieldInfo für das zugrunde liegende CLR-Feld für dieses eigenschaftsähnliche Objekt ab. Dies kann null für Schatteneigenschaften oder wenn das Sicherungsfeld nicht bekannt ist.

(Geerbt von IReadOnlyPropertyBase)
ForeignKey

Ruft den Fremdschlüssel ab, der die Beziehung definiert, durch die diese Navigationseigenschaft navigiert.

Inverse

Ruft die umgekehrte Navigation ab.

IsCollection

Ruft einen Wert ab, der angibt, ob die Navigationseigenschaft eine Auflistungseigenschaft ist.

(Geerbt von IReadOnlyNavigationBase)
IsEagerLoaded

Ruft einen Wert ab, der angibt, ob diese Navigation standardmäßig geladen werden soll.

(Geerbt von IReadOnlyNavigationBase)
IsInModel

Gibt an, ob sich dieses Objekt in einem Modell befindet, d. h. nicht aus einem modell entfernt wurde.

(Geerbt von IConventionAnnotatable)
IsOnDependent

Ruft einen Wert ab, der angibt, ob die Navigationseigenschaft auf der abhängigen Seite des zugrunde liegenden Fremdschlüssels definiert ist.

(Geerbt von IReadOnlyNavigation)
Item[String]

Ruft den Wert der Anmerkung mit dem angegebenen Namen ab und gibt zurück null , wenn sie nicht vorhanden ist.

(Geerbt von IReadOnlyAnnotatable)
LazyLoadingEnabled

Bestimmt, ob diese Navigation lazy-load soll, wenn das lazy-loading aktiviert ist und ein Mechanismus für das lazy-loading im Modell konfiguriert wurde.

(Geerbt von IReadOnlyNavigationBase)
Name

Ruft den Namen dieses eigenschaftsähnlichen Objekts ab.

(Geerbt von IReadOnlyPropertyBase)
PropertyInfo

Ruft die PropertyInfo für die zugrunde liegende CLR-Eigenschaft für dieses eigenschaftsähnliche Objekt ab. Dies kann für Schatteneigenschaften oder bei direkter Zuordnung zu einem Feld erfolgen null .

(Geerbt von IReadOnlyPropertyBase)
Sentinel

Ruft den Sentinelwert ab, der angibt, dass diese Eigenschaft nicht festgelegt ist.

(Geerbt von IReadOnlyPropertyBase)
TargetEntityType

Ruft den Entitätstyp ab, von dem diese Navigationseigenschaft eine instance enthält.

Methoden

AddAnnotation(String, Object, Boolean)

Fügt diesem Objekt eine Anmerkung hinzu. Löst aus, wenn bereits eine Anmerkung mit dem angegebenen Namen vorhanden ist.

(Geerbt von IConventionAnnotatable)
AddAnnotations(IEnumerable<IConventionAnnotation>, Boolean)

Fügt einem -Objekt Anmerkungen hinzu.

(Geerbt von IConventionAnnotatable)
AddRuntimeAnnotation(String, Object)

Fügt diesem Objekt eine Laufzeitanmerkung hinzu. Löst aus, wenn bereits eine Anmerkung mit dem angegebenen Namen vorhanden ist.

(Geerbt von IAnnotatable)
AnnotationsToDebugString(Int32)

Ruft die Debugzeichenfolge für alle Im -Objekt deklarierten Anmerkungen ab.

(Geerbt von IReadOnlyAnnotatable)
FindAnnotation(String)

Ruft die Anmerkung mit dem angegebenen Namen ab und gibt zurück null , wenn sie nicht vorhanden ist.

(Geerbt von IReadOnlyAnnotatable)
FindRuntimeAnnotation(String)

Ruft die Laufzeitanmerkung mit dem angegebenen Namen ab und gibt zurück null , wenn sie nicht vorhanden ist.

(Geerbt von IAnnotatable)
FindRuntimeAnnotationValue(String)

Ruft den Wert der Laufzeitanmerkung mit dem angegebenen Namen ab und gibt zurück null , wenn sie nicht vorhanden ist.

(Geerbt von IAnnotatable)
GetAnnotation(String)

Ruft die Anmerkung mit dem angegebenen Namen ab und löst aus, wenn sie nicht vorhanden ist.

(Geerbt von IReadOnlyAnnotatable)
GetAnnotations()

Ruft alle Anmerkungen für das aktuelle Objekt ab.

(Geerbt von IReadOnlyAnnotatable)
GetCollectionAccessor()

Ruft die IClrCollectionAccessor für diese Navigationseigenschaft ab, wenn es sich um eine Sammlungsnavigation handelt.

(Geerbt von INavigationBase)
GetConfigurationSource()

Gibt die Konfigurationsquelle für diese Eigenschaft zurück.

(Geerbt von IConventionPropertyBase)
GetCurrentValueComparer()

Ruft einen zum IComparer<T> Vergleichen von Werten in nachverfolgten Einträgen ab IUpdateEntry .

(Geerbt von IPropertyBase)
GetFieldInfoConfigurationSource()

Gibt die Konfigurationsquelle für FieldInfozurück.

(Geerbt von IConventionPropertyBase)
GetFieldName()

Ruft den Namen des Sicherungsfelds für diese Eigenschaft ab, oder null , wenn das Sicherungsfeld nicht bekannt ist.

(Geerbt von IReadOnlyPropertyBase)
GetGetter()

Ruft einen zum Lesen des Werts dieser Eigenschaft ab IClrPropertyGetter .

(Geerbt von IPropertyBase)
GetIndex()

Ruft den Eigenschaftenindex für diese Eigenschaft ab.

(Geerbt von IPropertyBase)
GetInverseConfigurationSource()

Gibt die Konfigurationsquelle für Inversezurück.

GetIsEagerLoadedConfigurationSource()

Gibt die Konfigurationsquelle für IsEagerLoadedzurück.

(Geerbt von IConventionNavigationBase)
GetLazyLoadingEnabledConfigurationSource()

Gibt die Konfigurationsquelle für LazyLoadingEnabledzurück.

(Geerbt von IConventionNavigationBase)
GetMemberInfo(Boolean, Boolean)

Ruft den oder FieldInfo ab, der PropertyInfo zum Abrufen oder Festlegen eines Werts für die angegebene Eigenschaft verwendet werden soll.

(Geerbt von IPropertyBase)
GetOrAddRuntimeAnnotationValue<TValue,TArg>(String, Func<TArg,TValue>, TArg)

Ruft den Wert der Laufzeitanmerkung mit dem angegebenen Namen ab und fügt ihn hinzu, falls keine vorhanden ist.

(Geerbt von IAnnotatable)
GetPropertyAccessMode()

Ruft das ab, das PropertyAccessMode für dieses eigenschaftsähnliche Objekt verwendet wird.

(Geerbt von IReadOnlyPropertyBase)
GetPropertyAccessModeConfigurationSource()

Gibt die Konfigurationsquelle für GetPropertyAccessMode()zurück.

(Geerbt von IConventionPropertyBase)
GetRuntimeAnnotations()

Ruft alle Laufzeitanmerkungen für das aktuelle Objekt ab.

(Geerbt von IAnnotatable)
IsIndexerProperty()

Ruft einen Wert ab, der angibt, ob es sich um eine Indexereigenschaft handelt. Eine Indexereigenschaft ist eine Eigenschaft, auf die über einen Indexer für die Entitätsklasse zugegriffen wird.

(Geerbt von IReadOnlyPropertyBase)
IsShadowProperty()

Ruft einen Wert ab, der angibt, ob es sich um eine Schatteneigenschaft handelt. Eine Schatteneigenschaft ist eine Eigenschaft, die keine entsprechende Eigenschaft in der Entitätsklasse aufweist. Der aktuelle Wert für die -Eigenschaft wird in der ChangeTracker gespeichert und nicht in Instanzen der Entitätsklasse gespeichert.

(Geerbt von IReadOnlyPropertyBase)
RemoveAnnotation(String)

Entfernt die Anmerkung mit dem angegebenen Namen aus diesem Objekt.

(Geerbt von IConventionAnnotatable)
RemoveRuntimeAnnotation(String)

Entfernt die angegebene Laufzeitanmerkung aus diesem Objekt.

(Geerbt von IAnnotatable)
SetAnnotation(String, Object, Boolean)

Legt die unter dem angegebenen Namen gespeicherte Anmerkung fest. Überschreibt die vorhandene Anmerkung, wenn bereits eine Anmerkung mit dem angegebenen Namen vorhanden ist.

(Geerbt von IConventionAnnotatable)
SetField(FieldInfo, Boolean)
Veraltet.

Legt den FieldInfo für das zugrunde liegende CLR-Feld fest, das von dieser Eigenschaft verwendet werden soll.

Standardmäßig wird das Sicherungsfeld verwendet, wenn eines gefunden oder angegeben wurde, wenn neue Objekte erstellt werden, in der Regel, wenn Entitäten aus der Datenbank abgefragt werden. Eigenschaften werden für alle anderen Zugriffe verwendet. Dies kann durch Aufrufen SetPropertyAccessMode(Nullable<PropertyAccessMode>, Boolean)von geändert werden.

(Geerbt von IConventionPropertyBase)
SetField(String, Boolean)

Legt das zugrunde liegende CLR-Feld fest, das von dieser Eigenschaft verwendet werden soll. Dies kann null für Schatteneigenschaften oder wenn das Hintergrundfeld für die Eigenschaft nicht bekannt ist.

(Geerbt von IConventionPropertyBase)
SetFieldInfo(FieldInfo, Boolean)

Legt den FieldInfo für das zugrunde liegende CLR-Feld fest, das von dieser Eigenschaft verwendet werden soll.

(Geerbt von IConventionPropertyBase)
SetInverse(MemberInfo, Boolean)

Legt die umgekehrte Navigation fest.

SetInverse(String, Boolean)

Legt die umgekehrte Navigation fest.

SetIsEagerLoaded(Nullable<Boolean>, Boolean)

Legt einen Wert fest, der angibt, ob diese Navigation standardmäßig eifrig geladen werden soll.

(Geerbt von IConventionNavigationBase)
SetIsLoadedWhenNoTracking(Object)

Ruft SetLoaded(Object, String, Boolean) auf, INavigationBase um ihn als geladen zu markieren, wenn eine Abfrage ohne Nachverfolgung diese Beziehung eifrig geladen hat.

(Geerbt von INavigationBase)
SetLazyLoadingEnabled(Nullable<Boolean>, Boolean)

Legt einen Wert fest, der angibt, ob diese Navigation verzögert geladen werden soll, wenn das verzögerte Laden aktiviert und aktiviert ist.

(Geerbt von IConventionNavigationBase)
SetOrRemoveAnnotation(String, Object, Boolean)

Legt die unter dem angegebenen Namen gespeicherte Anmerkung fest. Überschreibt die vorhandene Anmerkung, wenn bereits eine Anmerkung mit dem angegebenen Namen vorhanden ist. Entfernt die vorhandene Anmerkung, wenn null angegeben wird.

(Geerbt von IConventionAnnotatable)
SetPropertyAccessMode(Nullable<PropertyAccessMode>, Boolean)

Legt die fest, die PropertyAccessMode für diese Eigenschaft verwendet werden soll.

(Geerbt von IConventionPropertyBase)
SetRuntimeAnnotation(String, Object)

Legt die Unter dem angegebenen Schlüssel gespeicherte Laufzeitanmerkung fest. Überschreibt die vorhandene Anmerkung, wenn bereits eine Anmerkung mit dem angegebenen Namen vorhanden ist.

(Geerbt von IAnnotatable)
ToDebugString(MetadataDebugStringOptions, Int32)

Erstellt eine lesbare Darstellung der angegebenen Metadaten.

Warnung: Verlassen Sie sich nicht auf das Format der zurückgegebenen Zeichenfolge. Es ist nur für das Debuggen konzipiert und kann sich zwischen Releases beliebig ändern.

(Geerbt von IReadOnlyNavigation)

Explizite Schnittstellenimplementierungen

IConventionPropertyBase.GetConfigurationSource()

Gibt die Konfigurationsquelle für diese Navigationseigenschaft zurück.

INavigationBase.DeclaringEntityType

Ruft den Entitätstyp ab, zu dem diese Navigationseigenschaft gehört.

(Geerbt von INavigation)
INavigationBase.GetCollectionAccessor()

Ruft die IClrCollectionAccessor für diese Navigationseigenschaft ab, wenn es sich um eine Sammlungsnavigation handelt.

(Geerbt von INavigation)
INavigationBase.Inverse

Ruft die umgekehrte Navigation ab.

(Geerbt von INavigation)
INavigationBase.IsCollection

Ruft einen Wert ab, der angibt, ob die Navigationseigenschaft eine Auflistungseigenschaft ist.

(Geerbt von INavigation)
INavigationBase.TargetEntityType

Ruft den Entitätstyp ab, von dem diese Navigationseigenschaft eine instance enthält.

(Geerbt von INavigation)
IPropertyBase.GetPropertyAccessMode()

Ruft die ab, die PropertyAccessMode für diese Eigenschaft verwendet wird. null gibt an, dass der Standardzugriffsmodus für Eigenschaften verwendet wird.

(Geerbt von INavigationBase)
IReadOnlyNavigationBase.DeclaringEntityType

Ruft den Entitätstyp ab, zu dem diese Navigationseigenschaft gehört.

(Geerbt von IReadOnlyNavigation)
IReadOnlyNavigationBase.Inverse

Ruft die umgekehrte Navigation ab.

(Geerbt von IReadOnlyNavigation)
IReadOnlyNavigationBase.IsCollection

Ruft einen Wert ab, der angibt, ob die Navigationseigenschaft eine Auflistungseigenschaft ist.

(Geerbt von IReadOnlyNavigation)
IReadOnlyNavigationBase.TargetEntityType

Ruft den Entitätstyp ab, von dem diese Navigationseigenschaft eine instance enthält.

(Geerbt von IReadOnlyNavigation)
IReadOnlyPropertyBase.IsShadowProperty()

Ruft einen Wert ab, der angibt, ob es sich um eine Schatteneigenschaft handelt. Eine Schatteneigenschaft ist eine Eigenschaft, die keine entsprechende Eigenschaft in der Entitätsklasse aufweist. Der aktuelle Wert für die -Eigenschaft wird in der ChangeTracker gespeichert und nicht in Instanzen der Entitätsklasse gespeichert.

(Geerbt von IReadOnlyNavigationBase)

Erweiterungsmethoden

AddAnnotations(IConventionAnnotatable, IEnumerable<IConventionAnnotation>, Boolean)

Fügt einem -Objekt Anmerkungen hinzu.

GetAnnotation(IConventionAnnotatable, String)

Ruft die Anmerkung mit dem angegebenen Namen ab und löst aus, wenn sie nicht vorhanden ist.

SetOrRemoveAnnotation(IConventionAnnotatable, String, Object, Boolean)

Legt die unter dem angegebenen Namen gespeicherte Anmerkung fest. Überschreibt die vorhandene Anmerkung, wenn bereits eine Anmerkung mit dem angegebenen Namen vorhanden ist. Entfernt die vorhandene Anmerkung, wenn null angegeben wird.

FindInverse(IConventionNavigation)
Veraltet.

Ruft die Navigationseigenschaft am anderen Ende der Beziehung ab. Gibt NULL zurück, wenn keine Navigationseigenschaft am anderen Ende der Beziehung definiert ist.

GetIsEagerLoadedConfigurationSource(IConventionNavigation)

Gibt die Konfigurationsquelle für IsEagerLoaded(INavigation)zurück.

GetTargetType(IConventionNavigation)
Veraltet.

Ruft den Entitätstyp ab, von dem eine angegebene Navigationseigenschaft eine instance enthält (oder Instanzen von enthält, wenn es sich um eine Sammlungsnavigation handelt).

SetIsEagerLoaded(IConventionNavigation, Nullable<Boolean>, Boolean)

Legt einen Wert fest, der angibt, ob diese Navigation standardmäßig eifrig geladen werden soll.

GetPropertyAccessModeConfigurationSource(IConventionPropertyBase)

Gibt die Konfigurationsquelle für GetPropertyAccessMode()zurück.

SetField(IConventionPropertyBase, String, Boolean)

Legt das zugrunde liegende CLR-Feld fest, das von dieser Eigenschaft verwendet werden soll. Dies kann null für Schatteneigenschaften oder wenn das Hintergrundfeld für die Eigenschaft nicht bekannt ist.

Unterstützungsfelder werden normalerweise gemäß Konvention gefunden, wie hier beschrieben: http://go.microsoft.com/fwlink/?LinkId=723277. Diese Methode eignet sich für das explizite Festlegen von Unterstützungsfeldern in Fällen, in denen das richtige Feld nicht durch Konvention gefunden wird.

Standardmäßig wird das Sicherungsfeld verwendet, wenn eines gefunden oder angegeben wurde, wenn neue Objekte erstellt werden, in der Regel, wenn Entitäten aus der Datenbank abgefragt werden. Eigenschaften werden für alle anderen Zugriffe verwendet. Dies kann durch Aufrufen SetPropertyAccessMode(IConventionPropertyBase, Nullable<PropertyAccessMode>, Boolean)von geändert werden.

SetPropertyAccessMode(IConventionPropertyBase, Nullable<PropertyAccessMode>, Boolean)

Legt die fest, die PropertyAccessMode für diese Eigenschaft verwendet werden soll.

AnnotationsToDebugString(IAnnotatable, Int32)

Ruft die Debugzeichenfolge für alle Im -Objekt deklarierten Anmerkungen ab.

GetAnnotation(IAnnotatable, String)

Ruft die Anmerkung mit dem angegebenen Namen ab und löst aus, wenn sie nicht vorhanden ist.

SetIsLoadedWhenNoTracking(INavigationBase, Object)

Ruft SetLoaded(Object, String, Boolean) auf, INavigationBase um ihn als geladen zu markieren, wenn eine Abfrage ohne Nachverfolgung diese Beziehung eifrig geladen hat.

FindInverse(INavigation)
Veraltet.
Veraltet.

Ruft die Navigationseigenschaft am anderen Ende der Beziehung ab. Gibt NULL zurück, wenn keine Navigationseigenschaft am anderen Ende der Beziehung definiert ist.

GetCollectionAccessor(INavigation)

Ruft für diese Navigationseigenschaft ab, bei der IClrCollectionAccessor es sich um eine Sammlungsnavigation handelt.

GetTargetType(INavigation)
Veraltet.
Veraltet.

Ruft den Entitätstyp ab, von dem eine bestimmte Navigationseigenschaft eine instance enthält (oder Instanzen von enthält, wenn es sich um eine Sammlungsnavigation handelt).

IsCollection(INavigation)
Veraltet.
Veraltet.

Ruft einen Wert ab, der angibt, ob die angegebene Navigationseigenschaft eine Auflistungseigenschaft ist.

IsDependentToPrincipal(INavigation)
Veraltet.
Veraltet.

Ruft einen Wert ab, der angibt, ob die angegebene Navigationseigenschaft die Navigationseigenschaft für den abhängigen Entitätstyp ist, der auf die Prinzipalentität verweist.

IsEagerLoaded(INavigation)
Veraltet.
Veraltet.

Ruft einen Wert ab, der angibt, ob diese Navigation standardmäßig geladen werden soll.

ToDebugString(INavigation, MetadataDebugStringOptions, Int32)

Erstellt eine lesbare Darstellung der angegebenen Metadaten.

Warnung: Verlassen Sie sich nicht auf das Format der zurückgegebenen Zeichenfolge. Es ist nur für das Debuggen konzipiert und kann sich zwischen Releases beliebig ändern.

GetCurrentValueComparer(IPropertyBase)

Ruft einen IComparer<T> zum Vergleichen von Werten in nachverfolgten Einträgen ab IUpdateEntry .

GetFieldName(IPropertyBase)

Ruft den Namen des Sicherungsfelds für diese Eigenschaft ab, oder null , wenn das Sicherungsfeld nicht bekannt ist.

GetGetter(IPropertyBase)

Ruft einen zum Lesen des Werts dieser Eigenschaft ab IClrPropertyGetter .

Beachten Sie, dass es ein Fehler ist, diese Methode für eine Schatteneigenschaft (IsShadowProperty(IPropertyBase)) aufzurufen, da für eine solche Eigenschaft keine zugeordnet MemberInfoist.

GetIndex(IPropertyBase)

Ruft den Eigenschaftenindex für diese Eigenschaft ab.

GetMemberInfo(IPropertyBase, Boolean, Boolean)

Ruft den oder FieldInfo ab, der PropertyInfo zum Abrufen oder Festlegen eines Werts für die angegebene Eigenschaft verwendet werden soll.

Beachten Sie, dass es ein Fehler ist, diese Methode für eine Schatteneigenschaft (IsShadowProperty(IPropertyBase)) aufzurufen, da für eine solche Eigenschaft keine zugeordnet MemberInfoist.

GetPropertyAccessMode(IPropertyBase)

Ruft das ab, das PropertyAccessMode für diese Eigenschaft verwendet wird. null gibt an, dass der Standardmodus für den Eigenschaftenzugriff verwendet wird.

IsIndexerProperty(IPropertyBase)

Ruft einen Wert ab, der angibt, ob es sich um eine Indexereigenschaft handelt. Eine Indexereigenschaft ist eine Eigenschaft, auf die über einen Indexer für die Entitätsklasse zugegriffen wird.

IsShadowProperty(IPropertyBase)
Veraltet.

Ruft einen Wert ab, der angibt, ob es sich um eine Schatteneigenschaft handelt. Eine Schatteneigenschaft ist eine Eigenschaft, die keine entsprechende Eigenschaft in der Entitätsklasse aufweist. Der aktuelle Wert für die -Eigenschaft wird in der ChangeTracker gespeichert und nicht in Instanzen der Entitätsklasse gespeichert.

Gilt für: