MaskedTextBox.RejectInputOnFirstFailure Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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ż
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla