Udostępnij za pośrednictwem


MaskedTextBox.RejectInputOnFirstFailure Właściwość

Definicja

Pobiera lub ustawia wartość wskazującą, czy analizowanie danych wejściowych użytkownika powinno zostać zatrzymane po osiągnięciu pierwszego nieprawidłowego znaku.

public:
 property bool RejectInputOnFirstFailure { bool get(); void set(bool value); };
public bool RejectInputOnFirstFailure { get; set; }
member this.RejectInputOnFirstFailure : bool with get, set
Public Property RejectInputOnFirstFailure As Boolean

Wartość właściwości

true jeśli przetwarzanie ciągu wejściowego powinno zostać zakończone przy pierwszym błędzie analizy; w przeciwnym razie, false jeśli przetwarzanie powinno ignorować wszystkie błędy. Wartość domyślna to false.

Uwagi

Czasami użytkownik wprowadzi kilka znaków w MaskedTextBox jednej operacji wejściowej, zazwyczaj kopiując i wklejając ciąg. Jeśli cały ciąg zawiera tylko prawidłowe znaki, zgodnie z ich położeniem wklejania w masce wejściowej, cała operacja powiedzie się. Jednak w przypadku wystąpienia błędu analizy zachowanie MaskedTextBox zależy od wartości RejectInputOnFirstFailure, w następujący sposób:

  • Jeśli ta właściwość to true, przetwarzanie ciągu wejściowego zatrzymuje się na nieprawidłowym znaku. Wszystkie kolejne znaki są ignorowane. Wywoływane jest pojedyncze MaskInputRejected zdarzenie.

  • Jeśli ta właściwość to false, nieprawidłowy znak zostanie odrzucony, ale analizowanie będzie kontynuowane przy użyciu następnego znaku w ciągu wejściowym. Zdarzenie MaskInputRejected jest wywoływane dla każdego nieprawidłowego znaku w ciągu wejściowym.

ResetOnSpace Właściwości ResetOnPrompti SkipLiterals mogą również wpływać na interpretację danych wejściowych użytkownika.

IsOverwriteMode Jeśli właściwość to false, wszystkie znaki już w masce wejściowej po prawej stronie punktu wstawiania zostaną przesiedlone przez zaakceptowaną liczbę znaków. To przesunięcie może spowodować dodatkowe błędy analizy.

Operację wklejania można naśladować programowo, ustawiając SelectedText właściwość.

Dotyczy

Zobacz też