Langue

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.IConventionNavigationBase, Microsoft.EntityFrameworkCore.Metadata.IReadOnlyNavigation
public interface IConventionNavigation : Microsoft.EntityFrameworkCore.Metadata.IConventionPropertyBase, Microsoft.EntityFrameworkCore.Metadata.INavigation
public interface IConventionNavigation : Microsoft.EntityFrameworkCore.Metadata.IConventionNavigationBase, Microsoft.EntityFrameworkCore.Metadata.INavigation
type IConventionNavigation = interface
    interface IReadOnlyNavigation
    interface IReadOnlyNavigationBase
    interface IReadOnlyPropertyBase
    interface IReadOnlyAnnotatable
    interface IConventionNavigationBase
    interface IConventionPropertyBase
    interface IConventionAnnotatable
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
Public Interface IConventionNavigation
Implements IConventionNavigationBase, IReadOnlyNavigation
Public Interface IConventionNavigation
Implements IConventionPropertyBase, INavigation
Public Interface IConventionNavigation
Implements IConventionNavigationBase, INavigation
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 les conventions de génération de modèles.

Propriétés

Nom Description
Builder

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

ClrType

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

(Hérité de IPropertyBase)
DeclaringEntityType

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

DeclaringType

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

(Hérité de IPropertyBase)
FieldInfo

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

(Hérité de IPropertyBase)
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 INavigationBase)
IsEagerLoaded

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

(Hérité de INavigationBase)
IsInModel

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

(Hérité de IConventionAnnotatable)
IsOnDependent

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

(Hérité de INavigation)
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 au ChangeTracker lieu d’être stockée dans les instances de la classe d’entité.

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

Obtient l’annotation de valeur avec le nom donné, en retournant null s’il n’existe pas.

(Hérité de IAnnotatable)
LazyLoadingEnabled

Détermine si cette navigation doit être différée 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 IPropertyBase)
PropertyInfo

Obtient la PropertyInfo propriété CLR sous-jacente pour cet objet de type propriété. Cela peut être null destiné aux propriétés d’ombre ou s’ils sont mappés directement à un champ.

(Hérité de IPropertyBase)
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 instances.

Méthodes

Nom Description
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 runtime à 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 portant le nom donné, en retournant null s’il n’existe pas.

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

Obtient l’annotation runtime avec le nom donné, en retournant null s’il n’existe pas.

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

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

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

Obtient l’annotation portant le nom donné, levée s’il n’existe pas.

(Hérité de IConventionAnnotatable)
GetAnnotations()

Obtient toutes les annotations sur l’objet actuel.

(Hérité de IAnnotatable)
GetCollectionAccessor()

Obtient la IClrCollectionAccessor propriété de navigation 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 une IComparer<T> valeur permettant de 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 de cette propriété ou null si le champ de stockage n’est pas connu.

(Hérité de IReadOnlyPropertyBase)
GetGetter()

Obtient une IClrPropertyGetter valeur permettant de lire la valeur de cette propriété.

(Hérité de IPropertyBase)
GetIndex()

Obtient l’index de propriété de 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 celui 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’existe pas.

(Hérité de IAnnotatable)
GetPropertyAccessMode()

Obtient l’objet PropertyAccessMode utilisé pour cette propriété. null indique que le mode d’accès aux propriétés par défaut est utilisé.

(Hérité de IPropertyBase)
GetPropertyAccessModeConfigurationSource()

Retourne la source de configuration pour GetPropertyAccessMode().

(Hérité de IConventionPropertyBase)
GetRuntimeAnnotations()

Obtient toutes les annotations runtime sur l’objet actuel.

(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 une propriété accessible via un indexeur sur 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 runtime 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 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 les 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. Cela peut être null destiné aux 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 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 impatience par défaut.

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

Appelle SetLoaded(Object, String, Boolean) un INavigationBase élément pour le marquer comme chargé lorsqu’une requête sans 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 différée, si le chargement différé 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 elle est fournie.

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

Définit la PropertyAccessMode valeur à utiliser pour cette propriété.

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

Définit l’annotation runtime 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 entre les versions.

(Hérité de IReadOnlyNavigation)

Implémentations d’interfaces explicites

Nom Description
IConventionPropertyBase.GetConfigurationSource()

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

INavigationBase.DeclaringEntityType

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

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

Obtient la IClrCollectionAccessor propriété de navigation 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 instances.

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

Obtient l’objet PropertyAccessMode utilisé pour cette propriété. null indique que le mode d’accès aux propriétés par défaut est utilisé.

(Hérité de INavigationBase)
IReadOnlyNavigationBase.DeclaringEntityType

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

(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 instances.

(Hérité de IReadOnlyNavigation)
IReadOnlyPropertyBase.IsCollection

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

(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 au ChangeTracker lieu d’être stockée dans les instances de la classe d’entité.

(Hérité de IReadOnlyNavigationBase)

Méthodes d’extension

Nom Description
AddAnnotations(IConventionAnnotatable, IEnumerable<IConventionAnnotation>, Boolean)

Ajoute des annotations à un objet.

AnnotationsToDebugString(IAnnotatable, Int32)

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

FindInverse(IConventionNavigation)
Obsolète.

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

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

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

GetAnnotation(IAnnotatable, String)

Obtient l’annotation portant le nom donné, levée s’il n’existe pas.

GetAnnotation(IConventionAnnotatable, String)

Obtient l’annotation portant le nom donné, levée s’il n’existe pas.

GetCollectionAccessor(INavigation)

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

GetCurrentValueComparer(IPropertyBase)

Obtient une IComparer<T> valeur permettant de comparer les valeurs dans les entrées suivies IUpdateEntry .

GetFieldName(IPropertyBase)

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

GetGetter(IPropertyBase)

Obtient une IClrPropertyGetter valeur permettant de 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 une telle propriété n’a pas d’associé MemberInfo.

GetIndex(IPropertyBase)

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

GetIsEagerLoadedConfigurationSource(IConventionNavigation)

Retourne la source de configuration pour IsEagerLoaded(INavigation).

GetMemberInfo(IPropertyBase, Boolean, Boolean)

Obtient le PropertyInfo ou FieldInfo celui 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 une telle propriété n’a pas d’associé MemberInfo.

GetPropertyAccessMode(IPropertyBase)

Obtient l’objet PropertyAccessMode utilisé pour cette propriété. null indique que le mode d’accès aux propriétés par défaut est utilisé.

GetPropertyAccessModeConfigurationSource(IConventionPropertyBase)

Retourne la source de configuration pour GetPropertyAccessMode().

GetTargetType(IConventionNavigation)
Obsolète.

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

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

Obtient le type d’entité dont une propriété de navigation donnée contiendra une instance de (ou d’instances de conservation 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.

IsIndexerProperty(IPropertyBase)

Obtient une valeur indiquant s’il s’agit d’une propriété d’indexeur. Une propriété d’indexeur est une propriété 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 au ChangeTracker lieu d’être stockée dans les instances de la classe d’entité.

SetField(IConventionPropertyBase, String, Boolean)

Définit le champ CLR sous-jacent que cette propriété doit utiliser. Cela peut être null destiné aux 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 explicitement des champs de stockage 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 les 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).

SetIsEagerLoaded(IConventionNavigation, Nullable<Boolean>, Boolean)

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

SetIsLoadedWhenNoTracking(INavigationBase, Object)

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

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 elle est fournie.

SetPropertyAccessMode(IConventionPropertyBase, Nullable<PropertyAccessMode>, Boolean)

Définit la PropertyAccessMode valeur à utiliser pour cette propriété.

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 entre les versions.

S’applique à