Partager via


IConventionNavigation Interface

Définition

Représente une propriété de navigation qui peut être utilisée pour naviguer dans une relation.

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
Implémente

Remarques

Cette interface est utilisée lors de la création du modèle et permet de modifier les métadonnées. Une fois le modèle généré, INavigation représente une vue en lecture seule des mêmes métadonnées.

Pour plus d’informations et d’exemples, consultez Conventions de génération de modèles.

Propriétés

Builder

Obtient le générateur qui peut être utilisé pour configurer cette navigation.

ClrType

Obtient le type de valeur que cet objet de type propriété contient.

(Hérité de IReadOnlyPropertyBase)
DeclaringEntityType

Obtient le type auquel cette propriété de navigation appartient.

DeclaringType

Obtient le type auquel cet objet de type propriété appartient.

(Hérité de IReadOnlyPropertyBase)
FieldInfo

Obtient le FieldInfo pour le champ CLR sous-jacent pour cet objet de type propriété. Il peut s’agir null de propriétés d’ombre ou si le champ de stockage n’est pas connu.

(Hérité de IReadOnlyPropertyBase)
ForeignKey

Obtient la clé étrangère qui définit la relation que cette propriété de navigation naviguera.

Inverse

Obtient la navigation inverse.

IsCollection

Obtient une valeur indiquant si la propriété de navigation est une propriété de collection.

(Hérité de IReadOnlyNavigationBase)
IsEagerLoaded

Obtient une valeur indiquant si cette navigation doit être chargée avec impatience par défaut.

(Hérité de IReadOnlyNavigationBase)
IsInModel

Indique si cet objet se trouve dans un modèle, c’est-à-dire s’il n’en a pas été supprimé.

(Hérité de IConventionAnnotatable)
IsOnDependent

Obtient une valeur indiquant si la propriété de navigation est définie sur le côté dépendant de la clé étrangère sous-jacente.

(Hérité de IReadOnlyNavigation)
Item[String]

Obtient la valeur de l’annotation avec le nom donné, en retournant null si elle n’existe pas.

(Hérité de IReadOnlyAnnotatable)
LazyLoadingEnabled

Détermine si cette navigation doit être lazy-load si le chargement différé est activé et qu’un mécanisme de chargement différé a été configuré dans le modèle.

(Hérité de IReadOnlyNavigationBase)
Name

Obtient le nom de cet objet de type propriété.

(Hérité de IReadOnlyPropertyBase)
PropertyInfo

Obtient le PropertyInfo pour la propriété CLR sous-jacente pour cet objet de type propriété. Il peut s’agir null de propriétés d’ombre ou s’ils sont mappés directement à un champ.

(Hérité de IReadOnlyPropertyBase)
Sentinel

Obtient la valeur sentinelle qui indique que cette propriété n’est pas définie.

(Hérité de IReadOnlyPropertyBase)
TargetEntityType

Obtient le type d’entité dont cette propriété de navigation contiendra une ou plusieurs instance.

Méthodes

AddAnnotation(String, Object, Boolean)

Ajoute une annotation à cet objet. Lève si une annotation portant le nom spécifié existe déjà.

(Hérité de IConventionAnnotatable)
AddAnnotations(IEnumerable<IConventionAnnotation>, Boolean)

Ajoute des annotations à un objet.

(Hérité de IConventionAnnotatable)
AddRuntimeAnnotation(String, Object)

Ajoute une annotation d’exécution à cet objet. Lève si une annotation portant le nom spécifié existe déjà.

(Hérité de IAnnotatable)
AnnotationsToDebugString(Int32)

Obtient la chaîne de débogage pour toutes les annotations déclarées sur l’objet.

(Hérité de IReadOnlyAnnotatable)
FindAnnotation(String)

Obtient l’annotation avec le nom donné, retournée null si elle n’existe pas.

(Hérité de IReadOnlyAnnotatable)
FindRuntimeAnnotation(String)

Obtient l’annotation du runtime avec le nom donné, en retournant null si elle n’existe pas.

(Hérité de IAnnotatable)
FindRuntimeAnnotationValue(String)

Obtient la valeur de l’annotation runtime avec le nom donné, en retournant null si elle n’existe pas.

(Hérité de IAnnotatable)
GetAnnotation(String)

Obtient l’annotation avec le nom donné, en lisant si elle n’existe pas.

(Hérité de IReadOnlyAnnotatable)
GetAnnotations()

Obtient toutes les annotations sur l’objet actif.

(Hérité de IReadOnlyAnnotatable)
GetCollectionAccessor()

Obtient le IClrCollectionAccessor pour cette propriété de navigation, s’il s’agit d’une navigation de collection.

(Hérité de INavigationBase)
GetConfigurationSource()

Retourne la source de configuration de cette propriété.

(Hérité de IConventionPropertyBase)
GetCurrentValueComparer()

Obtient un IComparer<T> pour comparer les valeurs dans les entrées suivies IUpdateEntry .

(Hérité de IPropertyBase)
GetFieldInfoConfigurationSource()

Retourne la source de configuration pour FieldInfo.

(Hérité de IConventionPropertyBase)
GetFieldName()

Obtient le nom du champ de stockage pour cette propriété, ou null si le champ de sauvegarde n’est pas connu.

(Hérité de IReadOnlyPropertyBase)
GetGetter()

Obtient un IClrPropertyGetter pour lire la valeur de cette propriété.

(Hérité de IPropertyBase)
GetIndex()

Obtient l’index de propriété pour cette propriété.

(Hérité de IPropertyBase)
GetInverseConfigurationSource()

Retourne la source de configuration pour Inverse.

GetIsEagerLoadedConfigurationSource()

Retourne la source de configuration pour IsEagerLoaded.

(Hérité de IConventionNavigationBase)
GetLazyLoadingEnabledConfigurationSource()

Retourne la source de configuration pour LazyLoadingEnabled.

(Hérité de IConventionNavigationBase)
GetMemberInfo(Boolean, Boolean)

Obtient le PropertyInfo ou FieldInfo qui doit être utilisé pour obtenir ou définir une valeur pour la propriété donnée.

(Hérité de IPropertyBase)
GetOrAddRuntimeAnnotationValue<TValue,TArg>(String, Func<TArg,TValue>, TArg)

Obtient la valeur de l’annotation runtime avec le nom donné, en l’ajoutant si elle n’en existe pas.

(Hérité de IAnnotatable)
GetPropertyAccessMode()

Obtient le PropertyAccessMode qui est utilisé pour cet objet de type propriété.

(Hérité de IReadOnlyPropertyBase)
GetPropertyAccessModeConfigurationSource()

Retourne la source de configuration pour GetPropertyAccessMode().

(Hérité de IConventionPropertyBase)
GetRuntimeAnnotations()

Obtient toutes les annotations d’exécution sur l’objet actif.

(Hérité de IAnnotatable)
IsIndexerProperty()

Obtient une valeur indiquant s’il s’agit d’une propriété d’indexeur. Une propriété d’indexeur est accessible via un indexeur sur la classe d’entité.

(Hérité de IReadOnlyPropertyBase)
IsShadowProperty()

Obtient une valeur indiquant s’il s’agit d’une propriété d’ombre. Une propriété d’ombre est une propriété qui n’a pas de propriété correspondante dans la classe d’entité. La valeur actuelle de la propriété est stockée dans plutôt que dans les ChangeTracker instances de la classe d’entité.

(Hérité de IReadOnlyPropertyBase)
RemoveAnnotation(String)

Supprime l’annotation portant le nom donné de cet objet.

(Hérité de IConventionAnnotatable)
RemoveRuntimeAnnotation(String)

Supprime l’annotation d’exécution donnée de cet objet.

(Hérité de IAnnotatable)
SetAnnotation(String, Object, Boolean)

Définit l’annotation stockée sous le nom donné. Remplace l’annotation existante si une annotation portant le nom spécifié existe déjà.

(Hérité de IConventionAnnotatable)
SetField(FieldInfo, Boolean)
Obsolète..

Définit le FieldInfo pour le champ CLR sous-jacent que cette propriété doit utiliser.

Par défaut, le champ de stockage, s’il est trouvé ou a été spécifié, est utilisé lorsque de nouveaux objets sont construits, généralement lorsque des entités sont interrogées à partir de la base de données. Les propriétés sont utilisées pour tous les autres accès. Cela peut être modifié en appelant SetPropertyAccessMode(Nullable<PropertyAccessMode>, Boolean).

(Hérité de IConventionPropertyBase)
SetField(String, Boolean)

Définit le champ CLR sous-jacent que cette propriété doit utiliser. Il peut s’agir null de propriétés d’ombre ou si le champ de stockage de la propriété n’est pas connu.

(Hérité de IConventionPropertyBase)
SetFieldInfo(FieldInfo, Boolean)

Définit le FieldInfo pour le champ CLR sous-jacent que cette propriété doit utiliser.

(Hérité de IConventionPropertyBase)
SetInverse(MemberInfo, Boolean)

Définit la navigation inverse.

SetInverse(String, Boolean)

Définit la navigation inverse.

SetIsEagerLoaded(Nullable<Boolean>, Boolean)

Définit une valeur indiquant si cette navigation doit être chargée avec hâte par défaut.

(Hérité de IConventionNavigationBase)
SetIsLoadedWhenNoTracking(Object)

Appelle SetLoaded(Object, String, Boolean) un INavigationBase pour le marquer comme chargé lorsqu’une requête de non-suivi a chargé avec impatience cette relation.

(Hérité de INavigationBase)
SetLazyLoadingEnabled(Nullable<Boolean>, Boolean)

Définit une valeur indiquant si cette navigation doit être chargée de manière différée, si le chargement paresseux est activé et en place.

(Hérité de IConventionNavigationBase)
SetOrRemoveAnnotation(String, Object, Boolean)

Définit l’annotation stockée sous le nom donné. Remplace l’annotation existante si une annotation portant le nom spécifié existe déjà. Supprime l’annotation existante si null est fournie.

(Hérité de IConventionAnnotatable)
SetPropertyAccessMode(Nullable<PropertyAccessMode>, Boolean)

Définit le PropertyAccessMode à utiliser pour cette propriété.

(Hérité de IConventionPropertyBase)
SetRuntimeAnnotation(String, Object)

Définit l’annotation d’exécution stockée sous la clé donnée. Remplace l’annotation existante si une annotation portant le nom spécifié existe déjà.

(Hérité de IAnnotatable)
ToDebugString(MetadataDebugStringOptions, Int32)

Crée une représentation lisible par l’homme des métadonnées données.

Avertissement : ne vous appuyez pas sur le format de la chaîne retournée. Il est conçu pour le débogage uniquement et peut changer arbitrairement d’une version à l’autre.

(Hérité de IReadOnlyNavigation)

Implémentations d’interfaces explicites

IConventionPropertyBase.GetConfigurationSource()

Retourne la source de configuration de cette propriété de navigation.

INavigationBase.DeclaringEntityType

Obtient le type d'entité auquel cette propriété de navigation appartient.

(Hérité de INavigation)
INavigationBase.GetCollectionAccessor()

Obtient le IClrCollectionAccessor pour cette propriété de navigation, s’il s’agit d’une navigation de collection.

(Hérité de INavigation)
INavigationBase.Inverse

Obtient la navigation inverse.

(Hérité de INavigation)
INavigationBase.IsCollection

Obtient une valeur indiquant si la propriété de navigation est une propriété de collection.

(Hérité de INavigation)
INavigationBase.TargetEntityType

Obtient le type d’entité dont cette propriété de navigation contiendra une ou plusieurs instance.

(Hérité de INavigation)
IPropertyBase.GetPropertyAccessMode()

Obtient le PropertyAccessMode qui est utilisé pour cette propriété. null indique que le mode d’accès à la propriété par défaut est utilisé.

(Hérité de INavigationBase)
IReadOnlyNavigationBase.DeclaringEntityType

Obtient le type d'entité auquel cette propriété de navigation appartient.

(Hérité de IReadOnlyNavigation)
IReadOnlyNavigationBase.Inverse

Obtient la navigation inverse.

(Hérité de IReadOnlyNavigation)
IReadOnlyNavigationBase.IsCollection

Obtient une valeur indiquant si la propriété de navigation est une propriété de collection.

(Hérité de IReadOnlyNavigation)
IReadOnlyNavigationBase.TargetEntityType

Obtient le type d’entité dont cette propriété de navigation contiendra une ou plusieurs instance.

(Hérité de IReadOnlyNavigation)
IReadOnlyPropertyBase.IsShadowProperty()

Obtient une valeur indiquant s’il s’agit d’une propriété d’ombre. Une propriété d’ombre est une propriété qui n’a pas de propriété correspondante dans la classe d’entité. La valeur actuelle de la propriété est stockée dans plutôt que dans les ChangeTracker instances de la classe d’entité.

(Hérité de IReadOnlyNavigationBase)

Méthodes d’extension

AddAnnotations(IConventionAnnotatable, IEnumerable<IConventionAnnotation>, Boolean)

Ajoute des annotations à un objet.

GetAnnotation(IConventionAnnotatable, String)

Obtient l’annotation avec le nom donné, en lisant si elle n’existe pas.

SetOrRemoveAnnotation(IConventionAnnotatable, String, Object, Boolean)

Définit l’annotation stockée sous le nom donné. Remplace l’annotation existante si une annotation portant le nom spécifié existe déjà. Supprime l’annotation existante si null est fournie.

FindInverse(IConventionNavigation)
Obsolète..

Obtient la propriété de navigation à l’autre extrémité de la relation. Retourne null si aucune propriété de navigation n’est définie à l’autre extrémité de la relation.

GetIsEagerLoadedConfigurationSource(IConventionNavigation)

Retourne la source de configuration pour IsEagerLoaded(INavigation).

GetTargetType(IConventionNavigation)
Obsolète..

Obtient le type d’entité qu’une propriété de navigation donnée contiendra un instance (ou conserver les instances de s’il s’agit d’une navigation de collection).

SetIsEagerLoaded(IConventionNavigation, Nullable<Boolean>, Boolean)

Définit une valeur indiquant si cette navigation doit être chargée avec hâte par défaut.

GetPropertyAccessModeConfigurationSource(IConventionPropertyBase)

Retourne la source de configuration pour GetPropertyAccessMode().

SetField(IConventionPropertyBase, String, Boolean)

Définit le champ CLR sous-jacent que cette propriété doit utiliser. Il peut s’agir null de propriétés d’ombre ou si le champ de stockage de la propriété n’est pas connu.

Les champs de stockage sont normalement trouvés par convention, comme décrit ici : http://go.microsoft.com/fwlink/?LinkId=723277. Cette méthode est utile pour définir des champs de stockage explicitement dans les cas où le champ correct est introuvable par convention.

Par défaut, le champ de stockage, s’il est trouvé ou a été spécifié, est utilisé lorsque de nouveaux objets sont construits, généralement lorsque des entités sont interrogées à partir de la base de données. Les propriétés sont utilisées pour tous les autres accès. Cela peut être modifié en appelant SetPropertyAccessMode(IConventionPropertyBase, Nullable<PropertyAccessMode>, Boolean).

SetPropertyAccessMode(IConventionPropertyBase, Nullable<PropertyAccessMode>, Boolean)

Définit le PropertyAccessMode à utiliser pour cette propriété.

AnnotationsToDebugString(IAnnotatable, Int32)

Obtient la chaîne de débogage pour toutes les annotations déclarées sur l’objet.

GetAnnotation(IAnnotatable, String)

Obtient l’annotation avec le nom donné, en lisant si elle n’existe pas.

SetIsLoadedWhenNoTracking(INavigationBase, Object)

Appelle SetLoaded(Object, String, Boolean) un INavigationBase pour le marquer comme chargé lorsqu’une requête de non-suivi a chargé avec impatience cette relation.

FindInverse(INavigation)
Obsolète..
Obsolète..

Obtient la propriété de navigation à l’autre extrémité de la relation. Retourne null si aucune propriété de navigation n’est définie à l’autre extrémité de la relation.

GetCollectionAccessor(INavigation)

Obtient le IClrCollectionAccessor pour cette propriété de navigation, qui doit être une navigation de collection.

GetTargetType(INavigation)
Obsolète..
Obsolète..

Obtient le type d’entité qu’une propriété de navigation donnée contiendra un instance (ou conserver les instances de s’il s’agit d’une navigation de collection).

IsCollection(INavigation)
Obsolète..
Obsolète..

Obtient une valeur indiquant si la propriété de navigation donnée est une propriété de collection.

IsDependentToPrincipal(INavigation)
Obsolète..
Obsolète..

Obtient une valeur indiquant si la propriété de navigation donnée est la propriété de navigation sur le type d’entité dépendant qui pointe vers l’entité principale.

IsEagerLoaded(INavigation)
Obsolète..
Obsolète..

Obtient une valeur indiquant si cette navigation doit être chargée avec impatience par défaut.

ToDebugString(INavigation, MetadataDebugStringOptions, Int32)

Crée une représentation lisible par l’homme des métadonnées données.

Avertissement : ne vous appuyez pas sur le format de la chaîne retournée. Il est conçu pour le débogage uniquement et peut changer arbitrairement d’une version à l’autre.

GetCurrentValueComparer(IPropertyBase)

Obtient un IComparer<T> pour comparer les valeurs dans les entrées suivies IUpdateEntry .

GetFieldName(IPropertyBase)

Obtient le nom du champ de stockage pour cette propriété, ou null si le champ de sauvegarde n’est pas connu.

GetGetter(IPropertyBase)

Obtient un IClrPropertyGetter pour lire la valeur de cette propriété.

Notez qu’il s’agit d’une erreur d’appel de cette méthode pour une propriété d’ombre (IsShadowProperty(IPropertyBase)), car aucune propriété n’est associée à MemberInfocette propriété.

GetIndex(IPropertyBase)

Obtient l’index de propriété pour cette propriété.

GetMemberInfo(IPropertyBase, Boolean, Boolean)

Obtient le PropertyInfo ou FieldInfo qui doit être utilisé pour obtenir ou définir une valeur pour la propriété donnée.

Notez qu’il s’agit d’une erreur d’appel de cette méthode pour une propriété d’ombre (IsShadowProperty(IPropertyBase)), car aucune propriété n’est associée à MemberInfocette propriété.

GetPropertyAccessMode(IPropertyBase)

Obtient le PropertyAccessMode qui est utilisé pour cette propriété. null indique que le mode d’accès à la propriété par défaut est utilisé.

IsIndexerProperty(IPropertyBase)

Obtient une valeur indiquant s’il s’agit d’une propriété d’indexeur. Une propriété d’indexeur est accessible via un indexeur sur la classe d’entité.

IsShadowProperty(IPropertyBase)
Obsolète..

Obtient une valeur indiquant s’il s’agit d’une propriété d’ombre. Une propriété d’ombre est une propriété qui n’a pas de propriété correspondante dans la classe d’entité. La valeur actuelle de la propriété est stockée dans plutôt que dans les ChangeTracker instances de la classe d’entité.

S’applique à