DbContext.Attach 方法

定义

命名空间:

Microsoft.EntityFrameworkCore

程序集:

Microsoft.EntityFrameworkCore.dll

程序包:

Microsoft.EntityFrameworkCore v10.0.0

重载

名称	说明
Attach(Object)	开始跟踪给定实体和默认情况下可以使用状态 Unchanged 从给定实体访问的条目，但有关使用不同状态的情况，请参阅下文。
Attach<TEntity>(TEntity)	开始跟踪给定实体和默认情况下可以使用状态 Unchanged 从给定实体访问的条目，但有关使用不同状态的情况，请参阅下文。

Attach(Object)

Source:

DbContext.cs

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

public virtual Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry Attach(object entity);

abstract member Attach : obj -> Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry
override this.Attach : obj -> Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry

Public Overridable Function Attach (entity As Object) As EntityEntry

参数

entity

Object

要附加的实体。

返回

EntityEntry

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

注解

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

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

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

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

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

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

Attach<TEntity>(TEntity)

Source:

DbContext.cs

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

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

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

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

类型参数

TEntity

实体的类型。

参数

entity

TEntity

要附加的实体。

返回

EntityEntry<TEntity>

实体 EntityEntry<TEntity> 。 该条目提供对实体的更改跟踪信息和操作的访问权限。

注解

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

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

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

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

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

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