EditContext Sınıf

Tanım

Hangi alanların değiştirildiğini ve geçerli doğrulama iletileri kümesini gösteren bayraklar gibi bir veri düzenleme işlemiyle ilgili meta verileri tutar.

public ref class EditContext sealed
public sealed class EditContext
type EditContext = class
Public NotInheritable Class EditContext
Devralma
EditContext

Oluşturucular

Name Description
EditContext(Object)

örneğini EditContextoluşturur.

Özellikler

Name Description
Model

Bu EditContextiçin model nesnesini alır.

Properties

Bu örnekle ilişkili rastgele özelliklerden oluşan bir koleksiyon alır.

ShouldUseFieldIdentifiers

Giriş> öğeleri için <alan tanımlayıcılarının oluşturulup oluşturulmayacağını alır.

Yöntemler

Name Description
AddValidationTask(FieldIdentifier, Task, CancellationTokenSource)

Belirli bir alan için zaman uyumsuz doğrulama görevini kaydeder. Görev ve IsValidationFaulted(FieldIdentifier)aracılığıyla IsValidationPending(FieldIdentifier) bekleyen/hatalı durum sorguları için izlenir. Bu alan için bir görev zaten izleniyorsa, daha önce kaydedilen CancellationTokenSource görev iptal edilir ve yeni görev onun yerini alır. sağlanan EditContextctsöğesinin sahipliğini alır: sonraki bir doğrulama bu doğrulamanın yerini alır ve tamamlandıktan sonra task atılırsa iptal edilir.

Field(String)

Bu EditContext'nin Modelüzerinde belirtilen alan adına karşılık gelen bir FieldIdentifier sağlar.

GetValidationMessages()

Tüm alanlarda geçerli doğrulama iletilerini alır.

Bu yöntem doğrulama gerçekleştirmez. Yalnızca önceki doğrulama eylemleri tarafından belirlenen iletileri döndürür.

GetValidationMessages(Expression<Func<Object>>)

Belirtilen alan için geçerli doğrulama iletilerini alır.

Bu yöntem doğrulama gerçekleştirmez. Yalnızca önceki doğrulama eylemleri tarafından belirlenen iletileri döndürür.

GetValidationMessages(FieldIdentifier)

Belirtilen alan için geçerli doğrulama iletilerini alır.

Bu yöntem doğrulama gerçekleştirmez. Yalnızca önceki doğrulama eylemleri tarafından belirlenen iletileri döndürür.

IsModified()

Bu EditContext alandaki alanlardan herhangi birinin değiştirilip değiştirilmediğini belirler.

IsModified(Expression<Func<Object>>)

Burada EditContext belirtilen alanların değiştirilip değiştirilmediğini belirler.

IsModified(FieldIdentifier)

Burada EditContext belirtilen alanların değiştirilip değiştirilmediğini belirler.

IsValid(Expression<Func<Object>>)

Bu EditContext içindeki belirtilen alanların ilişkili doğrulama iletisi olup olmadığını belirler.

IsValid(FieldIdentifier)

Bu EditContext içindeki belirtilen alanların ilişkili doğrulama iletisi olup olmadığını belirler.

IsValidationFaulted()

En son ValidateAsync(CancellationToken) geçişin herhangi OnValidationRequestedAsync bir işleyiciden işlenmeyen bir özel durum gözlemlediğini döndürürtrue. Sonraki başarılı ValidateAsync(CancellationToken) bir geçiş bayrağı temizler; çağıran tarafından iptal edilen bir geçiş bunu korur. Doğrulamanın başarısız olduğunu algılamak için bunu kullanın (yalnızca oluşturulan doğrulama iletileri değil). 'den AddValidationTask(FieldIdentifier, Task, CancellationTokenSource)alan başına doğrulayıcı hataları için aşırı yüklemeyi kullanın IsValidationFaulted(FieldIdentifier) .

IsValidationFaulted(FieldIdentifier)

Belirtilen alanın son zaman uyumsuz doğrulamasının hatalı olup olmadığını döndürür true (iptal dışı özel durum oluşturdu).

IsValidationFaulted<TField>(Expression<Func<TField>>)

İfadenin son zaman uyumsuz doğrulaması tarafından accessor tanımlanan alanın hatalı olup olmadığını döndürür true (iptal edilemeyen bir özel durum oluşturdu).

IsValidationPending()

Form düzeyi ValidateAsync(CancellationToken) geçiş şu anda uçuştaysa döndürürtrue. Gönder düğmesini devre dışı bırakma veya "doğrulayıcı..." gösterme gibi form genelinde kullanıcı arabirimi oluşturmak için uygundur geçerli gönderimin göstergesi. Alan düzeyinde bekleyen görevleri dikkate almaz (bir sonraki form düzeyi geçiş başladığında bunların yerine geçer); IsValidationPending(FieldIdentifier) alan başına durum için aşırı yüklemeyi kullanın.

IsValidationPending(FieldIdentifier)

Belirtilen alanda bekleyen bir zaman uyumsuz doğrulama görevi varsa döndürür true . Çerçevenin gözlemcisi sonucunu verene ve yuvayı (görev tamamlanana kadar değil) temizleyene kadar bir görev "beklemede" olur, böylece olmayı false bekleyen IsValidationPending(FieldIdentifier) bir tüketicinin son IsValidationFaulted(FieldIdentifier) değeri de görmesi garanti edilir.

IsValidationPending<TField>(Expression<Func<TField>>)

İfade tarafından accessor tanımlanan alanın bekleyen bir zaman uyumsuz doğrulama görevi varsa döndürürtrue.

MarkAsUnmodified()

Bu EditContextiçindeki tüm değişiklik bayraklarını temizler.

MarkAsUnmodified(FieldIdentifier)

Belirtilen alan için izlenebilen tüm değişiklik bayraklarını temizler.

NotifyFieldChanged(FieldIdentifier)

Belirtilen alanın değerinin değiştiğini bildirir.

NotifyValidationStateChanged()

Doğrulama durumunun bazı yönlerinin değiştiğine dair sinyaller.

Validate()

Bunu EditContextdoğrular.

ValidateAsync(CancellationToken)

Bunu EditContext zaman uyumsuz olarak doğrular. Bekleyen tüm alan düzeyinde zaman uyumsuz doğrulama görevlerini iptal eder, zaman uyumlu OnValidationRequested işleyicileri çağırır, ardından zaman uyumsuz OnValidationRequestedAsync işleyicileri eşzamanlı olarak çağırır ve bekler. Zaman uyumlu işleyicilerden gelen özel durumlar, eşleşen Validate()çağırana yayılır. Zaman uyumsuz bir işleyici tarafından oluşturulan iptal edilemeyen özel durumlar bulunur: form hatalı olarak işaretlenir (parametresiz IsValidationFaulted()aracılığıyla gözlemlenebilir) ve yöntemi döndürür false. Zaman uyumsuz bölüm uçuş halindeyken, uygulamaların genel bir "doğrulayıcı..." gösterebilmesi için parametresiz IsValidationPending() döndürür true göstergesini seçin. Form düzeyi IsValidationFaulted() sonucu yalnızca bir geçiş tamamlandığında güncelleştirilir; çağıran tarafından iptal edilen geçişlerde korunur.

Ekinlikler

Name Description
OnFieldChanged

Bir alan değeri değiştiğinde tetiklenen olay.

OnValidationRequested

Doğrulama istendiğinde tetiklenen bir olay. Doğrulayıcı bileşenleri, zaman uyumlu doğrulama gerçekleştirmek için bu olaya abone olur.

OnValidationRequestedAsync

Doğrulama istendiğinde tetiklenen zaman uyumsuz bir olay. Doğrulayıcı bileşenleri zaman uyumsuz doğrulama (örneğin, veritabanı aramaları, uzak API çağrıları) gerçekleştirmek için bu olaya abone olur. İşleyiciler tarafından ValidateAsync(CancellationToken)beklenir. Validate() ayrıca bu işleyicileri çağırır ancak her birinin zaman uyumlu bir şekilde tamamlanmasını gerektirir; eksik Taskbir değer döndürürse, Validate() oluşturur InvalidOperationException.

OnValidationStateChanged

Doğrulama durumu değiştiğinde tetiklenen bir olay.

Uzantı Metotları

Name Description
AddDataAnnotationsValidation(EditContext)
Geçersiz.

DataAnnotations doğrulama desteğini öğesine EditContextekler.

EnableDataAnnotationsValidation(EditContext, IServiceProvider)

için EditContextDataAnnotations doğrulama desteğini etkinleştirir.

EnableDataAnnotationsValidation(EditContext)
Geçersiz.

için EditContextDataAnnotations doğrulama desteğini etkinleştirir.

FieldCssClass(EditContext, FieldIdentifier)

Belirtilen alanın durumunu CSS sınıfı olarak gösteren bir dize alır.

FieldCssClass<TField>(EditContext, Expression<Func<TField>>)

Belirtilen alanın durumunu CSS sınıfı olarak gösteren bir dize alır. Bu, alanın durumuna bağlı olarak "değiştirilmiş", "geçerli" veya "geçersiz" birleşimini içerir.

SetFieldCssClassProvider(EditContext, FieldCssClassProvider)

Sağlanan FieldCssClassProvider öğesini sağlanan ile ilişkilendirir EditContext. Bu, içinde kullanılan CSS sınıf adlarını özelleştirmektedir EditContext.

Şunlara uygulanır