Partilhar via


CollectionOwnershipBuilder<TEntity,TDependentEntity> Classe

Definição

Fornece uma API simples para configurar uma propriedade um-para-um.

public class CollectionOwnershipBuilder<TEntity,TDependentEntity> : Microsoft.EntityFrameworkCore.Metadata.Builders.CollectionOwnershipBuilder where TEntity : class where TDependentEntity : class
type CollectionOwnershipBuilder<'Entity, 'DependentEntity (requires 'Entity : null and 'DependentEntity : null)> = class
    inherit CollectionOwnershipBuilder
Public Class CollectionOwnershipBuilder(Of TEntity, TDependentEntity)
Inherits CollectionOwnershipBuilder

Parâmetros de tipo

TEntity
TDependentEntity
Herança
CollectionOwnershipBuilder<TEntity,TDependentEntity>

Construtores

CollectionOwnershipBuilder<TEntity,TDependentEntity>(EntityType, EntityType, InternalRelationshipBuilder)

Essa API dá suporte à infraestrutura do Entity Framework Core e não se destina a ser usada diretamente do seu código. Essa API pode ser alterada ou removida em versões futuras.

CollectionOwnershipBuilder<TEntity,TDependentEntity>(InternalRelationshipBuilder, CollectionOwnershipBuilder<TEntity,TDependentEntity>, Boolean, Boolean, Boolean)

Essa API dá suporte à infraestrutura do Entity Framework Core e não se destina a ser usada diretamente do seu código. Essa API pode ser alterada ou removida em versões futuras.

Propriedades

Builder

Essa API dá suporte à infraestrutura do Entity Framework Core e não se destina a ser usada diretamente do seu código. Essa API pode ser alterada ou removida em versões futuras.

(Herdado de ReferenceCollectionBuilderBase)
DependentEntityType

Obtém o tipo de entidade dependente usado para configurar essa relação.

(Herdado de ReferenceCollectionBuilderBase)
Metadata

A chave estrangeira que representa essa relação.

(Herdado de ReferenceCollectionBuilderBase)
OwnedEntityType

O tipo de entidade de propriedade que está sendo configurado.

(Herdado de CollectionOwnershipBuilder)
PrincipalEntityType

Obtém o tipo de entidade principal usado para configurar essa relação.

(Herdado de ReferenceCollectionBuilderBase)

Métodos

FindRelatedEntityType(String, String)

Essa API dá suporte à infraestrutura do Entity Framework Core e não se destina a ser usada diretamente do seu código. Essa API pode ser alterada ou removida em versões futuras.

(Herdado de CollectionOwnershipBuilder)
FindRelatedEntityType(Type, String)

Essa API dá suporte à infraestrutura do Entity Framework Core e não se destina a ser usada diretamente do seu código. Essa API pode ser alterada ou removida em versões futuras.

(Herdado de CollectionOwnershipBuilder)
HasChangeTrackingStrategy(ChangeTrackingStrategy)

Configura o ChangeTrackingStrategy a ser usado para esse tipo de entidade. Essa estratégia indica como o contexto detecta alterações nas propriedades de uma instância do tipo de entidade.

HasData(Object[])

Configura essa entidade para ter dados de semente. Ele é usado para gerar migrações de movimento de dados.

HasData(TDependentEntity[])

Configura essa entidade para ter dados de semente. Ele é usado para gerar migrações de movimento de dados.

HasEntityTypeAnnotation(String, Object)

Adiciona ou atualiza uma anotação no tipo de entidade de propriedade. Se uma anotação com a chave especificada em annotation já existir, seu valor será atualizado.

HasForeignKey(Expression<Func<TDependentEntity,Object>>)

Configura as propriedades a serem usadas como chave estrangeira para essa relação.

Se os nomes de propriedade especificados não existirem no tipo de entidade, uma nova(s) propriedade(s) de estado de sombra será adicionada para servir como a chave estrangeira. Uma propriedade de estado de sombra é aquela que não tem uma propriedade correspondente na classe de entidade. O valor atual da propriedade é armazenado no em ChangeTracker vez de ser armazenado em instâncias da classe de entidade.

Se HasPrincipalKey(Expression<Func<TEntity,Object>>) não for especificado, será feita uma tentativa de corresponder o tipo de dados e a ordem das propriedades de chave estrangeira com a chave primária do tipo de entidade principal. Se elas não corresponderem, novas propriedades de estado de sombra que formam um índice exclusivo serão adicionadas ao tipo de entidade principal para servir como a chave de referência.

HasForeignKey(String[])

Configura as propriedades a serem usadas como chave estrangeira para essa relação.

Se os nomes de propriedade especificados não existirem no tipo de entidade, uma nova(s) propriedade(s) de estado de sombra será adicionada para servir como a chave estrangeira. Uma propriedade de estado de sombra é aquela que não tem uma propriedade correspondente na classe de entidade. O valor atual da propriedade é armazenado no em ChangeTracker vez de ser armazenado em instâncias da classe de entidade.

Se HasPrincipalKey(String[]) não for especificado, será feita uma tentativa de corresponder o tipo de dados e a ordem das propriedades de chave estrangeira com a chave primária do tipo de entidade principal. Se elas não corresponderem, novas propriedades de estado de sombra que formam um índice exclusivo serão adicionadas ao tipo de entidade principal para servir como a chave de referência.

HasForeignKeyAnnotation(String, Object)

Adiciona ou atualiza uma anotação na chave estrangeira. Se uma anotação com a chave especificada em annotation já existir, seu valor será atualizado.

HasIndex(Expression<Func<TDependentEntity,Object>>)

Configura um índice nas propriedades especificadas. Se houver um índice existente no conjunto de propriedades fornecido, o índice existente será retornado para configuração.

HasIndex(String[])

Configura um índice nas propriedades especificadas. Se houver um índice existente no conjunto de propriedades fornecido, o índice existente será retornado para configuração.

(Herdado de CollectionOwnershipBuilder)
HasKey(Expression<Func<TDependentEntity,Object>>)

Define as propriedades que compõem a chave primária para esse tipo de entidade de propriedade.

HasKey(String[])

Define as propriedades que compõem a chave primária para esse tipo de entidade de propriedade.

(Herdado de CollectionOwnershipBuilder)
HasOne(String, String)

Configura uma relação em que esse tipo de entidade tem uma referência que aponta para uma única instância do outro tipo na relação.

Observe que chamar esse método sem parâmetros configurará explicitamente esse lado da relação para não usar nenhuma propriedade de navegação, mesmo que essa propriedade exista no tipo de entidade. Se a propriedade de navegação for usada, ela deverá ser especificada.

Depois de chamar esse método, você deve encadear uma chamada para WithMany(String) ou WithOne(String) para configurar totalmente a relação. Chamar apenas esse método sem a chamada encadeada não produzirá uma relação válida.

(Herdado de CollectionOwnershipBuilder)
HasOne(Type, String)

Configura uma relação em que esse tipo de entidade tem uma referência que aponta para uma única instância do outro tipo na relação.

Observe que chamar esse método sem parâmetros configurará explicitamente esse lado da relação para não usar nenhuma propriedade de navegação, mesmo que essa propriedade exista no tipo de entidade. Se a propriedade de navegação for usada, ela deverá ser especificada.

Depois de chamar esse método, você deve encadear uma chamada para WithMany(String) ou WithOne(String) para configurar totalmente a relação. Chamar apenas esse método sem a chamada encadeada não produzirá uma relação válida.

(Herdado de CollectionOwnershipBuilder)
HasOne<TNewRelatedEntity>(Expression<Func<TDependentEntity,TNewRelatedEntity>>)

Configura uma relação em que esse tipo de entidade tem uma referência que aponta para uma única instância do outro tipo na relação.

Observe que chamar esse método sem parâmetros configurará explicitamente esse lado da relação para não usar nenhuma propriedade de navegação, mesmo que essa propriedade exista no tipo de entidade. Se a propriedade de navegação for usada, ela deverá ser especificada.

Depois de chamar esse método, você deve encadear uma chamada para WithMany(Expression<Func<TRelatedEntity,IEnumerable<TEntity>>>) ou WithOne(Expression<Func<TRelatedEntity,TEntity>>) para configurar totalmente a relação. Chamar apenas esse método sem a chamada encadeada não produzirá uma relação válida.

HasOne<TNewRelatedEntity>(String)

Configura uma relação em que esse tipo de entidade tem uma referência que aponta para uma única instância do outro tipo na relação.

Observe que chamar esse método sem parâmetros configurará explicitamente esse lado da relação para não usar nenhuma propriedade de navegação, mesmo que essa propriedade exista no tipo de entidade. Se a propriedade de navegação for usada, ela deverá ser especificada.

Depois de chamar esse método, você deve encadear uma chamada para WithMany(String) ou WithOne(String) para configurar totalmente a relação. Chamar apenas esse método sem a chamada encadeada não produzirá uma relação válida.

HasPrincipalKey(Expression<Func<TEntity,Object>>)

Configura as propriedades exclusivas direcionadas a essa relação. Normalmente, você só chamaria esse método se quisesse usar uma(s) propriedade(s) diferente da chave primária como as propriedades principais. Se as propriedades especificadas ainda não forem uma restrição exclusiva (ou a chave primária), uma nova restrição exclusiva será introduzida.

HasPrincipalKey(String[])

Configura as propriedades exclusivas direcionadas a essa relação. Normalmente, você só chamaria esse método se quisesse usar uma(s) propriedade(s) diferente da chave primária como as propriedades principais. Se as propriedades especificadas ainda não forem uma restrição exclusiva (ou a chave primária), uma nova restrição exclusiva será introduzida.

Ignore(Expression<Func<TDependentEntity,Object>>)

Exclui a propriedade fornecida do tipo de entidade. Esse método normalmente é usado para remover propriedades do tipo de entidade de propriedade que foram adicionadas por convenção.

Ignore(String)

Exclui a propriedade fornecida do tipo de entidade. Esse método normalmente é usado para remover propriedades do tipo de entidade de propriedade que foram adicionadas por convenção.

OnDelete(DeleteBehavior)

Configura como uma operação de exclusão é aplicada a entidades dependentes na relação quando a entidade de segurança é excluída ou a relação é cortada.

OwnsMany(String, String)

Configura uma relação em que a entidade de destino pertence a (ou parte) dessa entidade.

O tipo de entidade de destino para cada relação de propriedade é tratado como um tipo de entidade diferente, mesmo que a navegação seja do mesmo tipo. A configuração do tipo de entidade de destino não é aplicada ao tipo de entidade de destino de outras relações de propriedade.

A maioria das operações em uma entidade de propriedade exige acessá-la por meio da entidade de proprietário usando a navegação correspondente.

(Herdado de CollectionOwnershipBuilder)
OwnsMany(String, String, Action<CollectionOwnershipBuilder>)

Configura uma relação em que esse tipo de entidade fornece identidade para o outro tipo na relação.

(Herdado de CollectionOwnershipBuilder)
OwnsMany(Type, String)

Configura uma relação em que a entidade de destino pertence a (ou parte) dessa entidade.

O tipo de entidade de destino para cada relação de propriedade é tratado como um tipo de entidade diferente, mesmo que a navegação seja do mesmo tipo. A configuração do tipo de entidade de destino não é aplicada ao tipo de entidade de destino de outras relações de propriedade.

A maioria das operações em uma entidade de propriedade exige acessá-la por meio da entidade de proprietário usando a navegação correspondente.

(Herdado de CollectionOwnershipBuilder)
OwnsMany(Type, String, Action<CollectionOwnershipBuilder>)

Configura uma relação em que esse tipo de entidade fornece identidade para o outro tipo na relação.

(Herdado de CollectionOwnershipBuilder)
OwnsMany<TNewDependentEntity>(Expression<Func<TDependentEntity,IEnumerable<TNewDependentEntity>>>)

Configura uma relação em que a entidade de destino pertence a (ou parte) dessa entidade.

O tipo de entidade de destino para cada relação de propriedade é tratado como um tipo de entidade diferente, mesmo que a navegação seja do mesmo tipo. A configuração do tipo de entidade de destino não é aplicada ao tipo de entidade de destino de outras relações de propriedade.

A maioria das operações em uma entidade de propriedade requer acessá-la por meio da entidade de proprietário usando a navegação correspondente.

OwnsMany<TNewDependentEntity>(Expression<Func<TDependentEntity, IEnumerable<TNewDependentEntity>>>, Action<CollectionOwnershipBuilder<TDependentEntity, TNewDependentEntity>>)

Configura uma relação em que a entidade de destino pertence a (ou parte) dessa entidade.

O tipo de entidade de destino para cada relação de propriedade é tratado como um tipo de entidade diferente, mesmo que a navegação seja do mesmo tipo. A configuração do tipo de entidade de destino não é aplicada ao tipo de entidade de destino de outras relações de propriedade.

A maioria das operações em uma entidade de propriedade requer acessá-la por meio da entidade de proprietário usando a navegação correspondente.

OwnsMany<TNewDependentEntity>(String)

Configura uma relação em que a entidade de destino pertence a (ou parte) dessa entidade.

O tipo de entidade de destino para cada relação de propriedade é tratado como um tipo de entidade diferente, mesmo que a navegação seja do mesmo tipo. A configuração do tipo de entidade de destino não é aplicada ao tipo de entidade de destino de outras relações de propriedade.

A maioria das operações em uma entidade de propriedade requer acessá-la por meio da entidade de proprietário usando a navegação correspondente.

OwnsMany<TNewDependentEntity>(String, Action<CollectionOwnershipBuilder<TDependentEntity,TNewDependentEntity>>)

Configura uma relação em que a entidade de destino pertence a (ou parte) dessa entidade.

O tipo de entidade de destino para cada relação de propriedade é tratado como um tipo de entidade diferente, mesmo que a navegação seja do mesmo tipo. A configuração do tipo de entidade de destino não é aplicada ao tipo de entidade de destino de outras relações de propriedade.

A maioria das operações em uma entidade de propriedade requer acessá-la por meio da entidade de proprietário usando a navegação correspondente.

OwnsOne(String, String)

Configura uma relação em que a entidade de destino pertence a (ou parte) dessa entidade. O valor da chave de entidade de destino é sempre propagado da entidade à qual ele pertence.

O tipo de entidade de destino para cada relação de propriedade é tratado como um tipo de entidade diferente, mesmo que a navegação seja do mesmo tipo. A configuração do tipo de entidade de destino não é aplicada ao tipo de entidade de destino de outras relações de propriedade.

A maioria das operações em uma entidade de propriedade exige acessá-la por meio da entidade de proprietário usando a navegação correspondente.

(Herdado de CollectionOwnershipBuilder)
OwnsOne(String, String, Action<ReferenceOwnershipBuilder>)

Configura uma relação em que a entidade de destino pertence a (ou parte) dessa entidade. O valor da chave de entidade de destino é sempre propagado da entidade à qual ele pertence.

O tipo de entidade de destino para cada relação de propriedade é tratado como um tipo de entidade diferente, mesmo que a navegação seja do mesmo tipo. A configuração do tipo de entidade de destino não é aplicada ao tipo de entidade de destino de outras relações de propriedade.

A maioria das operações em uma entidade de propriedade exige acessá-la por meio da entidade de proprietário usando a navegação correspondente.

(Herdado de CollectionOwnershipBuilder)
OwnsOne(Type, String)

Configura uma relação em que a entidade de destino pertence a (ou parte) dessa entidade. O valor da chave de entidade de destino é sempre propagado da entidade à qual ele pertence.

O tipo de entidade de destino para cada relação de propriedade é tratado como um tipo de entidade diferente, mesmo que a navegação seja do mesmo tipo. A configuração do tipo de entidade de destino não é aplicada ao tipo de entidade de destino de outras relações de propriedade.

A maioria das operações em uma entidade de propriedade exige acessá-la por meio da entidade de proprietário usando a navegação correspondente.

(Herdado de CollectionOwnershipBuilder)
OwnsOne(Type, String, Action<ReferenceOwnershipBuilder>)

Configura uma relação em que a entidade de destino pertence a (ou parte) dessa entidade. O valor da chave de entidade de destino é sempre propagado da entidade à qual ele pertence.

O tipo de entidade de destino para cada relação de propriedade é tratado como um tipo de entidade diferente, mesmo que a navegação seja do mesmo tipo. A configuração do tipo de entidade de destino não é aplicada ao tipo de entidade de destino de outras relações de propriedade.

A maioria das operações em uma entidade de propriedade exige acessá-la por meio da entidade de proprietário usando a navegação correspondente.

(Herdado de CollectionOwnershipBuilder)
OwnsOne<TNewRelatedEntity>(String)

Configura uma relação em que a entidade de destino pertence a (ou parte) dessa entidade. O valor da chave de entidade de destino sempre é propagado da entidade à qual pertence.

O tipo de entidade de destino para cada relação de propriedade é tratado como um tipo de entidade diferente, mesmo que a navegação seja do mesmo tipo. A configuração do tipo de entidade de destino não é aplicada ao tipo de entidade de destino de outras relações de propriedade.

A maioria das operações em uma entidade de propriedade requer acessá-la por meio da entidade de proprietário usando a navegação correspondente.

OwnsOne<TRelatedEntity>(Expression<Func<TDependentEntity,TRelatedEntity>>)

Configura uma relação em que a entidade de destino pertence a (ou parte) dessa entidade. O valor da chave de entidade de destino sempre é propagado da entidade à qual pertence.

O tipo de entidade de destino para cada relação de propriedade é tratado como um tipo de entidade diferente, mesmo que a navegação seja do mesmo tipo. A configuração do tipo de entidade de destino não é aplicada ao tipo de entidade de destino de outras relações de propriedade.

A maioria das operações em uma entidade de propriedade requer acessá-la por meio da entidade de proprietário usando a navegação correspondente.

OwnsOne<TRelatedEntity>(Expression<Func<TDependentEntity,TRelatedEntity>>, Action<ReferenceOwnershipBuilder<TDependentEntity,TRelatedEntity>>)

Configura uma relação em que a entidade de destino pertence a (ou parte) dessa entidade. O valor da chave de entidade de destino sempre é propagado da entidade à qual pertence.

O tipo de entidade de destino para cada relação de propriedade é tratado como um tipo de entidade diferente, mesmo que a navegação seja do mesmo tipo. A configuração do tipo de entidade de destino não é aplicada ao tipo de entidade de destino de outras relações de propriedade.

A maioria das operações em uma entidade de propriedade requer acessá-la por meio da entidade de proprietário usando a navegação correspondente.

OwnsOne<TRelatedEntity>(String, Action<ReferenceOwnershipBuilder<TDependentEntity,TRelatedEntity>>)

Configura uma relação em que a entidade de destino pertence a (ou parte) dessa entidade. O valor da chave de entidade de destino sempre é propagado da entidade à qual pertence.

O tipo de entidade de destino para cada relação de propriedade é tratado como um tipo de entidade diferente, mesmo que a navegação seja do mesmo tipo. A configuração do tipo de entidade de destino não é aplicada ao tipo de entidade de destino de outras relações de propriedade.

A maioria das operações em uma entidade de propriedade requer acessá-la por meio da entidade de proprietário usando a navegação correspondente.

Property(String)

Retorna um objeto que pode ser usado para configurar uma propriedade do tipo de entidade de propriedade. Se nenhuma propriedade com o nome fornecido existir, uma nova propriedade será adicionada.

Ao adicionar uma nova propriedade com essa sobrecarga, o nome da propriedade deve corresponder ao nome de uma propriedade OU campo CLR no tipo de entidade. Essa sobrecarga não pode ser usada para adicionar uma nova propriedade de estado de sombra.

(Herdado de CollectionOwnershipBuilder)
Property(Type, String)

Retorna um objeto que pode ser usado para configurar uma propriedade do tipo de entidade de propriedade. Se nenhuma propriedade com o nome fornecido existir, uma nova propriedade será adicionada.

Ao adicionar uma nova propriedade, se existir uma propriedade com o mesmo nome na classe de entidade, ela será adicionada ao modelo. Se nenhuma propriedade existir na classe de entidade, uma nova propriedade de estado de sombra será adicionada. Uma propriedade de estado de sombra é aquela que não tem uma propriedade correspondente na classe de entidade. O valor atual da propriedade é armazenado no em ChangeTracker vez de ser armazenado em instâncias da classe de entidade.

(Herdado de CollectionOwnershipBuilder)
Property<TProperty>(Expression<Func<TDependentEntity,TProperty>>)

Retorna um objeto que pode ser usado para configurar uma propriedade do tipo de entidade de propriedade. Se nenhuma propriedade com o nome fornecido existir, uma nova propriedade será adicionada.

Ao adicionar uma nova propriedade, se houver uma propriedade com o mesmo nome na classe de entidade, ela será adicionada ao modelo. Se nenhuma propriedade existir na classe de entidade, uma nova propriedade de estado de sombra será adicionada. Uma propriedade de estado de sombra é aquela que não tem uma propriedade correspondente na classe de entidade. O valor atual da propriedade é armazenado no ChangeTracker em vez de ser armazenado em instâncias da classe de entidade.

Property<TProperty>(String)

Retorna um objeto que pode ser usado para configurar uma propriedade do tipo de entidade de propriedade. Se nenhuma propriedade com o nome fornecido existir, uma nova propriedade será adicionada.

Ao adicionar uma nova propriedade, se existir uma propriedade com o mesmo nome na classe de entidade, ela será adicionada ao modelo. Se nenhuma propriedade existir na classe de entidade, uma nova propriedade de estado de sombra será adicionada. Uma propriedade de estado de sombra é aquela que não tem uma propriedade correspondente na classe de entidade. O valor atual da propriedade é armazenado no em ChangeTracker vez de ser armazenado em instâncias da classe de entidade.

(Herdado de CollectionOwnershipBuilder)
UsePropertyAccessMode(PropertyAccessMode)

Define o PropertyAccessMode a ser usado para todas as propriedades desse tipo de entidade.

Por padrão, o campo de suporte, se for encontrado por convenção ou tiver sido especificado, será usado quando novos objetos forem construídos, normalmente quando entidades são consultadas do banco de dados. As propriedades são usadas para todos os outros acessos. Chamar esse método alterará esse comportamento para todas as propriedades desse tipo de entidade, conforme descrito na PropertyAccessMode enumeração .

Chamar esse método substitui todas as propriedades dessa entidade, digite qualquer modo de acesso que tenha sido definido no modelo.

Implantações explícitas de interface

IInfrastructure<IMutableModel>.Instance

O modelo ao qual essa relação pertence.

(Herdado de ReferenceCollectionBuilderBase)
IInfrastructure<InternalEntityTypeBuilder>.Instance

Obtém o construtor interno que está sendo usado para configurar o tipo de entidade de propriedade.

(Herdado de CollectionOwnershipBuilder)
IInfrastructure<InternalRelationshipBuilder>.Instance

Obtém o construtor interno que está sendo usado para configurar essa relação.

(Herdado de ReferenceCollectionBuilderBase)

Métodos de Extensão

GetInfrastructure<T>(IInfrastructure<T>)

Obtém o valor de uma propriedade que está sendo ocultada usando IInfrastructure<T>.

Esse método normalmente é usado por provedores de banco de dados (e outras extensões). Geralmente, ele não é usado no código do aplicativo.

HasConstraintName(CollectionOwnershipBuilder, String)

Configura o nome da restrição de chave estrangeira para essa relação ao direcionar um banco de dados relacional.

HasConstraintName<TEntity,TDependentEntity>(CollectionOwnershipBuilder<TEntity,TDependentEntity>, String)

Configura o nome da restrição de chave estrangeira para essa relação ao direcionar um banco de dados relacional.

ToTable(CollectionOwnershipBuilder, String)

Configura a exibição ou tabela para a qual a entidade mapeia ao direcionar um banco de dados relacional.

ToTable(CollectionOwnershipBuilder, String, String)

Configura a exibição ou tabela para a qual a entidade mapeia ao direcionar um banco de dados relacional.

ToTable<TEntity,TDependentEntity>(CollectionOwnershipBuilder<TEntity,TDependentEntity>, String)

Configura a exibição ou tabela para a qual a entidade mapeia ao direcionar um banco de dados relacional.

ToTable<TEntity,TDependentEntity>(CollectionOwnershipBuilder<TEntity,TDependentEntity>, String, String)

Configura a exibição ou tabela para a qual a entidade mapeia ao direcionar um banco de dados relacional.

ForSqlServerIsMemoryOptimized(CollectionOwnershipBuilder, Boolean)

Configura a tabela para a qual a entidade é mapeada ao direcionar SQL Server como otimizada para memória.

ForSqlServerIsMemoryOptimized<TEntity,TRelatedEntity>(CollectionOwnershipBuilder<TEntity,TRelatedEntity>, Boolean)

Configura a tabela para a qual a entidade é mapeada ao direcionar SQL Server como otimizada para memória.

Aplica-se a