Idioma

IConventionNavigation Interface

Definição

Representa uma propriedade de navegação que pode ser usada para navegar em uma relação.

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
Implementações

Comentários

Essa interface é usada durante a criação do modelo e permite que os metadados sejam modificados. Depois que o modelo é criado, INavigation representa uma exibição somente leitura dos mesmos metadados.

Consulte as convenções de criação de modelos para obter mais informações e exemplos.

Propriedades

Nome Descrição
Builder

Obtém o construtor que pode ser usado para configurar essa navegação.

ClrType

Obtém o tipo de valor que esse objeto semelhante à propriedade contém.

(Herdado de IPropertyBase)
DeclaringEntityType

Obtém o tipo ao qual essa propriedade de navegação pertence.

DeclaringType

Obtém o tipo ao qual esse objeto semelhante à propriedade pertence.

(Herdado de IPropertyBase)
FieldInfo

Obtém o FieldInfo campo CLR subjacente para esse objeto semelhante a uma propriedade. Isso pode ser null para propriedades de sombra ou se o campo de backup não for conhecido.

(Herdado de IPropertyBase)
ForeignKey

Obtém a chave estrangeira que define a relação que essa propriedade de navegação navegará.

Inverse

Obtém a navegação inversa.

IsCollection

Obtém um valor que indica se a propriedade de navegação é uma propriedade de coleção.

(Herdado de INavigationBase)
IsEagerLoaded

Obtém um valor que indica se essa navegação deve ser carregada por padrão.

(Herdado de INavigationBase)
IsInModel

Indica se esse objeto está em um modelo, ou seja, não foi removido de um.

(Herdado de IConventionAnnotatable)
IsOnDependent

Obtém um valor que indica se a propriedade de navegação é definida no lado dependente da chave estrangeira subjacente.

(Herdado de INavigation)
IsShadowProperty

Obtém um valor que indica se essa é uma propriedade de sombra. Uma propriedade de sombra é aquela que não tem uma propriedade correspondente na classe de entidade. O valor atual da propriedade é armazenado em ChangeTracker vez de ser armazenado em instâncias da classe de entidade.

(Herdado de IPropertyBase)
Item[String]

Obtém a anotação de valor com o nome fornecido, retornando null se ela não existir.

(Herdado de IAnnotatable)
LazyLoadingEnabled

Determina se essa navegação deve ser carregada lentamente se o carregamento lento estiver habilitado e um mecanismo para carregamento lento tiver sido configurado no modelo.

(Herdado de IReadOnlyNavigationBase)
Name

Obtém o nome desse objeto semelhante a uma propriedade.

(Herdado de IPropertyBase)
PropertyInfo

Obtém a PropertyInfo propriedade CLR subjacente para esse objeto semelhante a uma propriedade. Isso pode ser null para propriedades de sombra ou se mapeados diretamente para um campo.

(Herdado de IPropertyBase)
Sentinel

Obtém o valor sentinela que indica que essa propriedade não está definida.

(Herdado de IReadOnlyPropertyBase)
TargetEntityType

Obtém o tipo de entidade do qual essa propriedade de navegação conterá uma instância.

Métodos

Nome Descrição
AddAnnotation(String, Object, Boolean)

Adiciona uma anotação a esse objeto. Gerará se já existir uma anotação com o nome especificado.

(Herdado de IConventionAnnotatable)
AddAnnotations(IEnumerable<IConventionAnnotation>, Boolean)

Adiciona anotações a um objeto.

(Herdado de IConventionAnnotatable)
AddRuntimeAnnotation(String, Object)

Adiciona uma anotação de runtime a esse objeto. Gerará se já existir uma anotação com o nome especificado.

(Herdado de IAnnotatable)
AnnotationsToDebugString(Int32)

Obtém a cadeia de caracteres de depuração para todas as anotações declaradas no objeto.

(Herdado de IReadOnlyAnnotatable)
FindAnnotation(String)

Obtém a anotação com o nome fornecido, retornando null se ela não existir.

(Herdado de IAnnotatable)
FindRuntimeAnnotation(String)

Obtém a anotação de runtime com o nome fornecido, retornando null se ela não existir.

(Herdado de IAnnotatable)
FindRuntimeAnnotationValue(String)

Obtém o valor da anotação de runtime com o nome fornecido, retornando null se ela não existir.

(Herdado de IAnnotatable)
GetAnnotation(String)

Obtém a anotação com o nome fornecido, lançando se ela não existir.

(Herdado de IConventionAnnotatable)
GetAnnotations()

Obtém todas as anotações no objeto atual.

(Herdado de IAnnotatable)
GetCollectionAccessor()

Obtém a IClrCollectionAccessor propriedade de navegação para essa, se for uma navegação de coleção.

(Herdado de INavigationBase)
GetConfigurationSource()

Retorna a fonte de configuração dessa propriedade.

(Herdado de IConventionPropertyBase)
GetCurrentValueComparer()

Obtém um IComparer<T> para comparar valores em entradas controladas IUpdateEntry .

(Herdado de IPropertyBase)
GetFieldInfoConfigurationSource()

Retorna a fonte de configuração para FieldInfo.

(Herdado de IConventionPropertyBase)
GetFieldName()

Obtém o nome do campo de backup dessa propriedade ou null se o campo de backup não é conhecido.

(Herdado de IReadOnlyPropertyBase)
GetGetter()

Obtém um IClrPropertyGetter para ler o valor dessa propriedade.

(Herdado de IPropertyBase)
GetIndex()

Obtém o índice de propriedade dessa propriedade.

(Herdado de IPropertyBase)
GetInverseConfigurationSource()

Retorna a fonte de configuração para Inverse.

GetIsEagerLoadedConfigurationSource()

Retorna a fonte de configuração para IsEagerLoaded.

(Herdado de IConventionNavigationBase)
GetLazyLoadingEnabledConfigurationSource()

Retorna a fonte de configuração para LazyLoadingEnabled.

(Herdado de IConventionNavigationBase)
GetMemberInfo(Boolean, Boolean)

Obtém o PropertyInfo ou FieldInfo que deve ser usado para obter ou definir um valor para a propriedade fornecida.

(Herdado de IPropertyBase)
GetOrAddRuntimeAnnotationValue<TValue,TArg>(String, Func<TArg,TValue>, TArg)

Obtém o valor da anotação de runtime com o nome fornecido, adicionando-o se um não existir.

(Herdado de IAnnotatable)
GetPropertyAccessMode()

Obtém o PropertyAccessMode que está sendo usado para essa propriedade. null indica que o modo de acesso à propriedade padrão está sendo usado.

(Herdado de IPropertyBase)
GetPropertyAccessModeConfigurationSource()

Retorna a fonte de configuração para GetPropertyAccessMode().

(Herdado de IConventionPropertyBase)
GetRuntimeAnnotations()

Obtém todas as anotações de runtime no objeto atual.

(Herdado de IAnnotatable)
IsIndexerProperty()

Obtém um valor que indica se essa é uma propriedade de indexador. Uma propriedade do indexador é aquela que é acessada por meio de um indexador na classe de entidade.

(Herdado de IReadOnlyPropertyBase)
RemoveAnnotation(String)

Remove a anotação com o nome fornecido desse objeto.

(Herdado de IConventionAnnotatable)
RemoveRuntimeAnnotation(String)

Remove a anotação de runtime fornecida desse objeto.

(Herdado de IAnnotatable)
SetAnnotation(String, Object, Boolean)

Define a anotação armazenada sob o nome fornecido. Substituirá a anotação existente se já existir uma anotação com o nome especificado.

(Herdado de IConventionAnnotatable)
SetField(FieldInfo, Boolean)
Obsoleto.

Define o FieldInfo campo CLR subjacente que essa propriedade deve usar.

Por padrão, o campo de backup, se for encontrado ou especificado, é usado quando novos objetos são construídos, normalmente quando entidades são consultadas do banco de dados. As propriedades são usadas para todos os outros acessos. Isso pode ser alterado chamando SetPropertyAccessMode(Nullable<PropertyAccessMode>, Boolean).

(Herdado de IConventionPropertyBase)
SetField(String, Boolean)

Define o campo CLR subjacente que essa propriedade deve usar. Isso pode ser null para propriedades de sombra ou se o campo de backup da propriedade não for conhecido.

(Herdado de IConventionPropertyBase)
SetFieldInfo(FieldInfo, Boolean)

Define o FieldInfo campo CLR subjacente que essa propriedade deve usar.

(Herdado de IConventionPropertyBase)
SetInverse(MemberInfo, Boolean)

Define a navegação inversa.

SetInverse(String, Boolean)

Define a navegação inversa.

SetIsEagerLoaded(Nullable<Boolean>, Boolean)

Define um valor que indica se essa navegação deve ser carregada por padrão.

(Herdado de IConventionNavigationBase)
SetIsLoadedWhenNoTracking(Object)

Solicita SetLoaded(Object, String, Boolean) uma INavigationBase marcação como carregada quando uma consulta sem acompanhamento tiver carregado ansiosamente essa relação.

(Herdado de INavigationBase)
SetLazyLoadingEnabled(Nullable<Boolean>, Boolean)

Define um valor que indica se essa navegação deve ser carregada lentamente, se o carregamento lento estiver habilitado e em vigor.

(Herdado de IConventionNavigationBase)
SetOrRemoveAnnotation(String, Object, Boolean)

Define a anotação armazenada sob o nome fornecido. Substituirá a anotação existente se já existir uma anotação com o nome especificado. Remove a anotação existente se null for fornecida.

(Herdado de IConventionAnnotatable)
SetPropertyAccessMode(Nullable<PropertyAccessMode>, Boolean)

Define o PropertyAccessMode uso para essa propriedade.

(Herdado de IConventionPropertyBase)
SetRuntimeAnnotation(String, Object)

Define a anotação de runtime armazenada sob a chave fornecida. Substituirá a anotação existente se já existir uma anotação com o nome especificado.

(Herdado de IAnnotatable)
ToDebugString(MetadataDebugStringOptions, Int32)

Cria uma representação legível por humanos dos metadados especificados.

Aviso: não dependa do formato da cadeia de caracteres retornada. Ele foi projetado apenas para depuração e pode mudar arbitrariamente entre versões.

(Herdado de IReadOnlyNavigation)

Implantações explícitas de interface

Nome Descrição
IConventionPropertyBase.GetConfigurationSource()

Retorna a fonte de configuração dessa propriedade de navegação.

INavigationBase.DeclaringEntityType

Obtém o tipo de entidade ao qual essa propriedade de navegação pertence.

(Herdado de INavigation)
INavigationBase.GetCollectionAccessor()

Obtém a IClrCollectionAccessor propriedade de navegação para essa, se for uma navegação de coleção.

(Herdado de INavigation)
INavigationBase.Inverse

Obtém a navegação inversa.

(Herdado de INavigation)
INavigationBase.IsCollection

Obtém um valor que indica se a propriedade de navegação é uma propriedade de coleção.

(Herdado de INavigation)
INavigationBase.TargetEntityType

Obtém o tipo de entidade do qual essa propriedade de navegação conterá uma instância.

(Herdado de INavigation)
IPropertyBase.GetPropertyAccessMode()

Obtém o PropertyAccessMode que está sendo usado para essa propriedade. null indica que o modo de acesso à propriedade padrão está sendo usado.

(Herdado de INavigationBase)
IReadOnlyNavigationBase.DeclaringEntityType

Obtém o tipo de entidade ao qual essa propriedade de navegação pertence.

(Herdado de IReadOnlyNavigation)
IReadOnlyNavigationBase.Inverse

Obtém a navegação inversa.

(Herdado de IReadOnlyNavigation)
IReadOnlyNavigationBase.IsCollection

Obtém um valor que indica se a propriedade de navegação é uma propriedade de coleção.

(Herdado de IReadOnlyNavigation)
IReadOnlyNavigationBase.TargetEntityType

Obtém o tipo de entidade do qual essa propriedade de navegação conterá uma instância.

(Herdado de IReadOnlyNavigation)
IReadOnlyPropertyBase.IsCollection

Obtém um valor que indica se a propriedade de navegação é uma propriedade de coleção.

(Herdado de IReadOnlyNavigation)
IReadOnlyPropertyBase.IsShadowProperty()

Obtém um valor que indica se essa é uma propriedade de sombra. Uma propriedade de sombra é aquela que não tem uma propriedade correspondente na classe de entidade. O valor atual da propriedade é armazenado em ChangeTracker vez de ser armazenado em instâncias da classe de entidade.

(Herdado de IReadOnlyNavigationBase)

Métodos de Extensão

Nome Descrição
AddAnnotations(IConventionAnnotatable, IEnumerable<IConventionAnnotation>, Boolean)

Adiciona anotações a um objeto.

AnnotationsToDebugString(IAnnotatable, Int32)

Obtém a cadeia de caracteres de depuração para todas as anotações declaradas no objeto.

FindInverse(IConventionNavigation)
Obsoleto.

Obtém a propriedade de navegação na outra extremidade da relação. Retornará nulo se não houver nenhuma propriedade de navegação definida na outra extremidade da relação.

FindInverse(INavigation)
Obsoleto.
Obsoleto.

Obtém a propriedade de navegação na outra extremidade da relação. Retornará nulo se não houver nenhuma propriedade de navegação definida na outra extremidade da relação.

GetAnnotation(IAnnotatable, String)

Obtém a anotação com o nome fornecido, lançando se ela não existir.

GetAnnotation(IConventionAnnotatable, String)

Obtém a anotação com o nome fornecido, lançando se ela não existir.

GetCollectionAccessor(INavigation)

Obtém a IClrCollectionAccessor propriedade de navegação para essa, que deve ser uma navegação de coleção.

GetCurrentValueComparer(IPropertyBase)

Obtém um IComparer<T> para comparar valores em entradas controladas IUpdateEntry .

GetFieldName(IPropertyBase)

Obtém o nome do campo de backup dessa propriedade ou null se o campo de backup não é conhecido.

GetGetter(IPropertyBase)

Obtém um IClrPropertyGetter para ler o valor dessa propriedade.

Observe que é um erro chamar esse método para uma propriedade de sombra (IsShadowProperty(IPropertyBase)) uma vez que essa propriedade não tem nenhuma associação MemberInfo.

GetIndex(IPropertyBase)

Obtém o índice de propriedade dessa propriedade.

GetIsEagerLoadedConfigurationSource(IConventionNavigation)

Retorna a fonte de configuração para IsEagerLoaded(INavigation).

GetMemberInfo(IPropertyBase, Boolean, Boolean)

Obtém o PropertyInfo ou FieldInfo que deve ser usado para obter ou definir um valor para a propriedade fornecida.

Observe que é um erro chamar esse método para uma propriedade de sombra (IsShadowProperty(IPropertyBase)) uma vez que essa propriedade não tem nenhuma associação MemberInfo.

GetPropertyAccessMode(IPropertyBase)

Obtém o PropertyAccessMode que está sendo usado para essa propriedade. null indica que o modo de acesso à propriedade padrão está sendo usado.

GetPropertyAccessModeConfigurationSource(IConventionPropertyBase)

Retorna a fonte de configuração para GetPropertyAccessMode().

GetTargetType(IConventionNavigation)
Obsoleto.

Obtém o tipo de entidade do qual uma determinada propriedade de navegação conterá uma instância (ou manterá instâncias de se for uma navegação de coleção).

GetTargetType(INavigation)
Obsoleto.
Obsoleto.

Obtém o tipo de entidade do qual uma determinada propriedade de navegação conterá uma instância (ou manterá instâncias de se for uma navegação de coleção).

IsCollection(INavigation)
Obsoleto.
Obsoleto.

Obtém um valor que indica se a propriedade de navegação fornecida é uma propriedade de coleção.

IsDependentToPrincipal(INavigation)
Obsoleto.
Obsoleto.

Obtém um valor que indica se a propriedade de navegação fornecida é a propriedade de navegação no tipo de entidade dependente que aponta para a entidade principal.

IsEagerLoaded(INavigation)
Obsoleto.
Obsoleto.

Obtém um valor que indica se essa navegação deve ser carregada por padrão.

IsIndexerProperty(IPropertyBase)

Obtém um valor que indica se essa é uma propriedade de indexador. Uma propriedade do indexador é aquela que é acessada por meio de um indexador na classe de entidade.

IsShadowProperty(IPropertyBase)
Obsoleto.

Obtém um valor que indica se essa é uma propriedade de sombra. Uma propriedade de sombra é aquela que não tem uma propriedade correspondente na classe de entidade. O valor atual da propriedade é armazenado em ChangeTracker vez de ser armazenado em instâncias da classe de entidade.

SetField(IConventionPropertyBase, String, Boolean)

Define o campo CLR subjacente que essa propriedade deve usar. Isso pode ser null para propriedades de sombra ou se o campo de backup da propriedade não for conhecido.

Os campos de backup normalmente são encontrados por convenção, conforme descrito aqui: http://go.microsoft.com/fwlink/?LinkId=723277. Esse método é útil para definir campos de backup explicitamente em casos em que o campo correto não é encontrado por convenção.

Por padrão, o campo de backup, se for encontrado ou especificado, é usado quando novos objetos são construídos, normalmente quando entidades são consultadas do banco de dados. As propriedades são usadas para todos os outros acessos. Isso pode ser alterado chamando SetPropertyAccessMode(IConventionPropertyBase, Nullable<PropertyAccessMode>, Boolean).

SetIsEagerLoaded(IConventionNavigation, Nullable<Boolean>, Boolean)

Define um valor que indica se essa navegação deve ser carregada por padrão.

SetIsLoadedWhenNoTracking(INavigationBase, Object)

Solicita SetLoaded(Object, String, Boolean) uma INavigationBase marcação como carregada quando uma consulta sem acompanhamento tiver carregado ansiosamente essa relação.

SetOrRemoveAnnotation(IConventionAnnotatable, String, Object, Boolean)

Define a anotação armazenada sob o nome fornecido. Substituirá a anotação existente se já existir uma anotação com o nome especificado. Remove a anotação existente se null for fornecida.

SetPropertyAccessMode(IConventionPropertyBase, Nullable<PropertyAccessMode>, Boolean)

Define o PropertyAccessMode uso para essa propriedade.

ToDebugString(INavigation, MetadataDebugStringOptions, Int32)

Cria uma representação legível por humanos dos metadados especificados.

Aviso: não dependa do formato da cadeia de caracteres retornada. Ele foi projetado apenas para depuração e pode mudar arbitrariamente entre versões.

Aplica-se a