ChangeTracker Sınıf

Tanım

Ad Alanı:

Microsoft.EntityFrameworkCore.ChangeTracking

Bütünleştirilmiş Kod:

Microsoft.EntityFrameworkCore.dll

Paket:

Microsoft.EntityFrameworkCore v8.0.0

Bağlamın izlediği varlık örnekleri için değişiklik izleme bilgilerine ve işlemlerine erişim sağlar. Bu sınıfın örnekleri genellikle öğesinden ChangeTracker alınır ve uygulama kodunuzda doğrudan oluşturulacak şekilde tasarlanmamıştır.

public class ChangeTracker : Microsoft.EntityFrameworkCore.Infrastructure.IResettableService

type ChangeTracker = class
    interface IResettableService

Public Class ChangeTracker
Implements IResettableService

Devralma

Object

ChangeTracker

Uygulamalar

IResettableService

Açıklamalar

Daha fazla bilgi ve örnek için bkz. EF Core değişiklik izleme .

Oluşturucular

ChangeTracker(DbContext, IStateManager, IChangeDetector, IModel, IEntityEntryGraphIterator)

Bu, Entity Framework Core altyapısını destekleyen ve genel API'ler ile aynı uyumluluk standartlarına tabi olmayan bir iç API'dir. Herhangi bir sürümde bildirimde bulunmaksızın değiştirilebilir veya kaldırılabilir. Bunu yalnızca kodunuzda son derece dikkatli bir şekilde kullanmanız ve bunu yapmanın yeni bir Entity Framework Core sürümüne güncelleştirirken uygulama hatalarına neden olabileceğini bilmeniz gerekir.

Özellikler

AutoDetectChangesEnabled	yönteminin ve ilgili sınıfların DetectChanges() yöntemleri DbContext tarafından otomatik olarak çağrılıp çağrılmadığını belirten bir değer alır veya ayarlar.
CascadeDeleteTiming	Bağımlı/alt varlığın üst/asıl varlığı olarak Deletedişaretlendikten sonra durumunun ne zaman olarak ayarlandığını Deleted belirten bir değer alır veya ayarlar. Varsayılan değer şudurImmediate:
Context	Bu değişiklik izleyicisinin ait olduğu bağlamı alır.
DebugView	İzlenen varlıkların insanlar tarafından okunabilir bir görünümü için hata ayıklayıcıda bu özelliği genişletin. Uyarı: Hata ayıklama dizelerinin biçimine güvenmeyin. Bunlar yalnızca hata ayıklama için tasarlanmıştır ve yayınlar arasında rastgele değiştirilebilir. Daha fazla bilgi ve örnek için bkz. EF Core değişiklik izleme .
DeleteOrphansTiming	Bağımlı/alt varlığın durumunun Deleted bir üst/asıl varlıktan bir kez ayrılmış durumda olacağını belirten bir gezinti veya yabancı anahtar özelliğinin null olarak ayarlandığını belirten bir değer alır veya ayarlar. Immediate varsayılan değerdir.
LazyLoadingEnabled	İzlenen varlıklar için gezinti özelliklerinin ilk erişimde yüklenip yüklenmeyeceğini belirten bir değer alır veya ayarlar.
QueryTrackingBehavior	Bağlama göre çalıştırılacak LINQ sorguları için izleme davranışını alır veya ayarlar. Değişiklik izlemenin devre dışı bırakılması, her varlık örneği için değişiklik izleme ayarlama ek yükünü önlediğinden salt okunur senaryolar için kullanışlıdır. Varlık örneklerini işlemek ve kullanarak SaveChanges()bu değişiklikleri veritabanında kalıcı hale getirmek istiyorsanız değişiklik izlemeyi devre dışı bırakmamalısınız.

Yöntemler

AcceptAllChanges()	Bağlamda varlıklarda yapılan tüm değişiklikleri kabul eder. İzlenen varlıkların veritabanının geçerli durumunu temsil ettiğini varsayar. Bu yöntem genellikle değişiklikler veritabanına başarıyla kaydedildikten sonra tarafından SaveChanges() çağrılır.
CascadeChanges()	Alt/bağımlı varlıkların gerekli üst/asıl varlıktan ayrılmaları veya gerekli üst/asıl varlığın kendisi silinmesi durumunda hemen art arda silinmesini zorlar. Bkz. DeleteBehavior.
Clear()	İzlenen tüm varlıkları izlemeyi durdurur.
DetectChanges()	Örnek verilerinde yapılan değişiklikleri algılamak için izlenen varlık örneklerini tarar. DetectChanges() , güncel bilgiler gerektiğinde (değişiklik izleme bilgilerini döndürmeden önce SaveChanges() ve döndürürken) genellikle bağlam tarafından otomatik olarak çağrılır. Genellikle yalnızca devre dışı bırakdıysanız AutoDetectChangesEnabledbu yöntemi çağırmanız gerekir. Daha fazla bilgi ve örnek için bkz. EF Core değişiklik izleme .
Entries()	Bağlam tarafından izlenen her varlık için bir EntityEntry döndürür. Girdiler, her varlık için değişiklik izleme bilgilerine ve işlemlerine erişim sağlar.
Entries<TEntity>()	EntityEntry Bağlam tarafından izlenen belirli bir türün tüm varlıkları için bir alır. Girdiler, her varlık için değişiklik izleme bilgilerine ve işlemlerine erişim sağlar.
HasChanges()	Yeni, silinmiş veya değiştirilmiş varlıkların izlenip izlenmediğini denetler, böylece bu değişiklikler çağrılırsa veya SaveChangesAsync(CancellationToken) çağrılırsa SaveChanges() veritabanına gönderilir.
TrackGraph(Object, Action<EntityEntryGraphNode>)	Gezinti özellikleri arasında geçiş yaparak bir varlığı ve erişilebilir varlıkları izlemeye başlar. Dolaşma özyinelemeli olduğundan, bulunan varlıkların gezinti özellikleri de taranır. Belirtilen callback , bulunan her varlık için çağrılır ve her varlığın State izleneceği değeri ayarlamalıdır. Durum ayarlanmamışsa varlık izlenmemiş olarak kalır.
TrackGraph<TState>(Object, TState, Func<EntityEntryGraphNode<TState>,Boolean>)	Gezinti özellikleri arasında geçiş yaparak bir varlığı ve erişilebilir varlıkları izlemeye başlar. Dolaşma özyinelemeli olduğundan, bulunan varlıkların gezinti özellikleri de taranır. Belirtilen callback , bulunan her varlık için çağrılır ve her varlığın State izleneceği değeri ayarlamalıdır. Durum ayarlanmamışsa varlık izlenmemiş olarak kalır.

Ekinlikler

DetectedAllChanges	Varlık grafı için açık bir çağrı DetectChanges()aracılığıyla veya veya yürütmenin SaveChanges()SaveChangesAsync(CancellationToken)bir parçası gibi otomatik olarak herhangi bir değişiklik algılandığında bir olay tetiklendi.
DetectedEntityChanges	Tek bir varlıkta açık bir veya çağrısı DetectChanges()DetectChanges()aracılığıyla ya da veya yürütmenin SaveChanges()SaveChangesAsync(CancellationToken)bir parçası gibi otomatik olarak herhangi bir değişiklik algılandığında bir olay tetiklendi.
DetectingAllChanges	Varlık grafı değişiklikleri algılandığında, açık bir çağrısı DetectChanges()aracılığıyla veya veya yürütmenin SaveChanges()SaveChangesAsync(CancellationToken)bir parçası gibi otomatik olarak bir olay tetiklenir.
DetectingEntityChanges	Tek bir varlığa yapılan değişiklikler algılanırken tetiklenen bir olay, veya DetectChanges()açık bir çağrısı DetectChanges() aracılığıyla ya da veya yürütmenin SaveChanges()SaveChangesAsync(CancellationToken)bir parçası gibi otomatik olarak gerçekleşmek üzeredir.
StateChanged	İlişkili DbContext tarafından izlenen bir varlık bir birinden diğerine EntityState taşındığında bir olay tetiklendi.
StateChanging	İlişkili DbContext tarafından izlenen bir varlık bir birinden diğerine EntityState geçtiğinde bir olay tetiklendi.
Tracked	Bir varlık, bir izleme sorgusundan döndürülürken veya bağlama eklendiğinden veya eklendiğinden bağlam tarafından izlendiğinde bir olay tetiklenir.
Tracking	Bir varlık, bir izleme sorgusundan döndürülür veya bağlama eklendiğinden veya eklendiğinden, bağlam tarafından izlenmek üzere olduğunda bir olay tetiklendi.

Belirtik Arabirim Kullanımları

IResettableService.ResetState()	Havuzdan kullanılabilmesi için hizmeti sıfırlar.
IResettableService.ResetStateAsync(CancellationToken)	Bağlamın izlediği varlık örnekleri için değişiklik izleme bilgilerine ve işlemlerine erişim sağlar. Bu sınıfın örnekleri genellikle öğesinden ChangeTracker alınır ve uygulama kodunuzda doğrudan oluşturulacak şekilde tasarlanmamıştır.

Uzantı Metotları

ToDebugString(ChangeTracker, ChangeTrackerDebugStringOptions, Int32)

Verilen meta verilerin insan tarafından okunabilir bir gösterimini oluşturur. Uyarı: Döndürülen dizenin biçimine güvenmeyin. Yalnızca hata ayıklama için tasarlanmıştır ve yayınlar arasında rastgele değiştirilebilir.