EditContext 클래스

정의

수정된 필드와 현재 유효성 검사 메시지 집합을 나타내는 플래그와 같은 데이터 편집 프로세스와 관련된 메타데이터를 보유합니다.

public ref class EditContext sealed
public sealed class EditContext
type EditContext = class
Public NotInheritable Class EditContext
상속
EditContext

생성자

Name Description
EditContext(Object)

의 인스턴스를 생성합니다 EditContext.

속성

Name Description
Model

EditContext에 대한 모델 개체를 가져옵니다.

Properties

이 인스턴스와 연결된 임의의 속성의 컬렉션을 가져옵니다.

ShouldUseFieldIdentifiers

입력> 요소에 대해 <필드 식별자를 생성해야 하는지 여부를 가져옵니다.

메서드

Name Description
AddValidationTask(FieldIdentifier, Task, CancellationTokenSource)

특정 필드에 대한 비동기 유효성 검사 작업을 등록합니다. 작업을 통해 IsValidationPending(FieldIdentifier) 보류 중/오류가 발생한 상태 쿼리에 대해 추적됩니다 IsValidationFaulted(FieldIdentifier). 이 필드에 대해 작업이 이미 추적된 경우 이전에 등록된 CancellationTokenSource 작업이 취소되고 새 작업이 해당 필드를 대체합니다. EditContext 제공된 cts소유권을 가져옵니다. 후속 유효성 검사가 이 유효성 검사를 대체하고 완료되면 삭제되면 task 취소됩니다.

Field(String)

FieldIdentifierEditContext'의 Model지정된 필드 이름에 해당하는 이름을 제공합니다.

GetValidationMessages()

모든 필드에서 현재 유효성 검사 메시지를 가져옵니다.

이 메서드는 유효성 검사 자체를 수행하지 않습니다. 이전 유효성 검사 작업에 의해 결정된 메시지만 반환합니다.

GetValidationMessages(Expression<Func<Object>>)

지정된 필드에 대한 현재 유효성 검사 메시지를 가져옵니다.

이 메서드는 유효성 검사 자체를 수행하지 않습니다. 이전 유효성 검사 작업에 의해 결정된 메시지만 반환합니다.

GetValidationMessages(FieldIdentifier)

지정된 필드에 대한 현재 유효성 검사 메시지를 가져옵니다.

이 메서드는 유효성 검사 자체를 수행하지 않습니다. 이전 유효성 검사 작업에 의해 결정된 메시지만 반환합니다.

IsModified()

EditContext 필드 중 수정된 필드가 있는지 여부를 확인합니다.

IsModified(Expression<Func<Object>>)

EditContext 필드의 지정된 필드가 수정되었는지 여부를 확인합니다.

IsModified(FieldIdentifier)

EditContext 필드의 지정된 필드가 수정되었는지 여부를 확인합니다.

IsValid(Expression<Func<Object>>)

EditContext 필드의 지정된 필드에 연결된 유효성 검사 메시지가 없는지 여부를 확인합니다.

IsValid(FieldIdentifier)

EditContext 필드의 지정된 필드에 연결된 유효성 검사 메시지가 없는지 여부를 확인합니다.

IsValidationFaulted()

가장 최근의 ValidateAsync(CancellationToken) 패스가 처리기에서 OnValidationRequestedAsync 처리되지 않은 예외가 관찰된 경우를 반환 true 합니다. 후속 성공 ValidateAsync(CancellationToken) 패스는 플래그를 지웁니다. 호출자가 취소한 패스는 플래그를 유지합니다. 유효성 검사 자체에 실패했음을 감지하려면 이 방법을 사용합니다(생성된 유효성 검사 메시지뿐만 아니라). 필드별 유효성 검사기 오류의 AddValidationTask(FieldIdentifier, Task, CancellationTokenSource)경우 오버로드를 IsValidationFaulted(FieldIdentifier) 사용합니다.

IsValidationFaulted(FieldIdentifier)

지정된 필드의 마지막 비동기 유효성 검사에 오류가 발생했는지(취소되지 않은 예외를 throw)를 반환 true 합니다.

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

식의 마지막 비동기 유효성 검사로 accessor 식별된 필드가 잘못되었는지(취소되지 않은 예외를 throw)하는 경우를 반환 true 합니다.

IsValidationPending()

양식 수준 ValidateAsync(CancellationToken) 패스가 현재 진행 중인지를 반환 true 합니다. 제출 단추를 사용하지 않도록 설정하거나 "유효성 검사 중..."을 표시하는 등 양식 전체 UI를 구동하는 데 적합합니다. 현재 제출에 대한 표시기입니다. 필드 수준 보류 작업(다음 양식 수준 패스가 시작될 때 대체됨)을 고려하지 않습니다. IsValidationPending(FieldIdentifier) 필드별 상태에 대해 오버로드를 사용합니다.

IsValidationPending(FieldIdentifier)

지정된 필드에 보류 중인 비동기 유효성 검사 작업이 있는지를 반환 true 합니다. 프레임워크의 관찰자가 결과를 확인하고 슬롯(즉, 작업 자체가 완료될 때까지)을 지울 때까지 작업이 "보류 중"이므로 대기 IsValidationPending(FieldIdentifier)false 하는 소비자도 최종 IsValidationFaulted(FieldIdentifier) 값을 볼 수 있습니다.

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

식으로 식별되는 accessor 필드에 보류 중인 비동기 유효성 검사 작업이 있는지를 반환 true 합니다.

MarkAsUnmodified()

EditContext항목 내의 모든 수정 플래그를 지웁니다.

MarkAsUnmodified(FieldIdentifier)

지정된 필드에 대해 추적할 수 있는 수정 플래그를 지웁니다.

NotifyFieldChanged(FieldIdentifier)

지정된 필드의 값이 변경되었음을 알 수 있습니다.

NotifyValidationStateChanged()

유효성 검사 상태의 일부 측면이 변경되었음을 알 수 있습니다.

Validate()

유효성 EditContext을 검사합니다.

ValidateAsync(CancellationToken)

비동기적으로 유효성 EditContext 을 검사합니다. 보류 중인 필드 수준 비동기 유효성 검사 작업을 취소하고 동기 OnValidationRequested 처리기를 호출한 다음 비동 OnValidationRequestedAsync 기 처리기를 동시에 호출하고 기다립니다. 동기 처리기의 예외가 호출자에게 전파되며 일치 Validate()합니다. 비동기 처리기에서 throw된 취소되지 않은 예외가 포함됩니다. 양식이 오류로 표시되고(매개 변수가 없는 IsValidationFaulted()경우 관찰 가능) 메서드가 반환됩니다 false. 비동기 부분이 실행 중인 동안 애플리케이션에서 전역 "유효성 검사..."를 표시할 수 있도록 매개 변수 없는 IsValidationPending() 반환이 반환 true 됩니다. 호출 자체를 래핑하지 않고 표시기입니다. 양식 수준 IsValidationFaulted() 결과는 패스가 완료될 때만 업데이트되며 호출자가 취소한 패스 간에 유지됩니다.

이벤트

Name Description
OnFieldChanged

필드 값이 변경될 때 발생하는 이벤트입니다.

OnValidationRequested

유효성 검사를 요청할 때 발생하는 이벤트입니다. 유효성 검사기 구성 요소는 이 이벤트를 구독하여 동기 유효성 검사를 수행합니다.

OnValidationRequestedAsync

유효성 검사를 요청할 때 발생하는 비동기 이벤트입니다. 유효성 검사기 구성 요소는 이 이벤트를 구독하여 비동기 유효성 검사(예: 데이터베이스 조회, 원격 API 호출)를 수행합니다. 처리기는 .에서 대기합니다 ValidateAsync(CancellationToken). Validate()또한 이러한 처리기를 호출하지만 각각을 동기적으로 완료해야 합니다. 불완전한 TaskValidate() 항목을 반환하면 throw됩니다.InvalidOperationException

OnValidationStateChanged

유효성 검사 상태가 변경될 때 발생하는 이벤트입니다.

확장명 메서드

Name Description
AddDataAnnotationsValidation(EditContext)
사용되지 않음.

에 DataAnnotations 유효성 검사 지원을 EditContext추가합니다.

EnableDataAnnotationsValidation(EditContext, IServiceProvider)

에 대한 DataAnnotations 유효성 검사 지원을 사용하도록 EditContext설정합니다.

EnableDataAnnotationsValidation(EditContext)
사용되지 않음.

에 대한 DataAnnotations 유효성 검사 지원을 사용하도록 EditContext설정합니다.

FieldCssClass(EditContext, FieldIdentifier)

지정된 필드의 상태를 CSS 클래스로 나타내는 문자열을 가져옵니다.

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

지정된 필드의 상태를 CSS 클래스로 나타내는 문자열을 가져옵니다. 여기에는 필드의 상태에 따라 "modified", "valid" 또는 "invalid"의 일부 조합이 포함됩니다.

SetFieldCssClassProvider(EditContext, FieldCssClassProvider)

제공된 자를 제공된 FieldCssClassProvider 에 연결합니다 EditContext. 그러면 에 사용되는 EditContext필드 CSS 클래스 이름이 사용자 지정됩니다.

적용 대상