DbSet<TEntity>.Attach(TEntity) 方法

定义

命名空间:

Microsoft.EntityFrameworkCore

程序集:

Microsoft.EntityFrameworkCore.dll

包:

Microsoft.EntityFrameworkCore v8.0.0

默认使用 Unchanged 状态开始跟踪给定实体和可从给定实体访问的条目，但有关将使用不同的状态的情况，请参阅下文。

public virtual Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<TEntity> Attach (TEntity entity);

abstract member Attach : 'Entity -> Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity (requires 'Entity : null)>
override this.Attach : 'Entity -> Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry<'Entity (requires 'Entity : null)>

Public Overridable Function Attach (entity As TEntity) As EntityEntry(Of TEntity)

参数

entity

TEntity

要附加的实体。

返回

EntityEntry<TEntity>

EntityEntry实体的 。 条目提供对实体的更改跟踪信息和操作的访问。

注解

通常，在调用 之前 SaveChanges() 不会执行数据库交互。

将执行导航属性的递归搜索，以查找上下文尚未跟踪的可访问实体。 上下文将跟踪找到的所有实体。

对于具有生成键的实体类型，如果实体设置了其主键值，则将在 状态中 Unchanged 跟踪它。 如果未设置主键值，则将在 状态中 Added 跟踪它。 这有助于确保仅插入新实体。 如果主键属性设置为属性类型的 CLR 默认值以外的任何值，则认为实体设置了主键值。

对于没有生成键的实体类型，状态集始终 Unchanged为 。

使用 State 仅设置单个实体的状态。

有关详细信息和示例，请参阅 EF Core 更改跟踪 。