MaskedTextProvider.Set Metoda

Definicja

Przestrzeń nazw:

System.ComponentModel

Zestaw:

System.ComponentModel.TypeConverter.dll

Ustawia sformatowany ciąg na określony ciąg wejściowy.

Przeciążenia

Set(String)	Ustawia sformatowany ciąg na określony ciąg wejściowy.
Set(String, Int32, MaskedTextResultHint)	Ustawia sformatowany ciąg na określony ciąg wejściowy, a następnie generuje pozycję usuwania i informacje opisowe.

Set(String)

Źródło:

MaskedTextProvider.cs

Ustawia sformatowany ciąg na określony ciąg wejściowy.

public:
 bool Set(System::String ^ input);

public bool Set (string input);

member this.Set : string -> bool

Public Function Set (input As String) As Boolean

Parametry

input

String

Wartość String używana do ustawiania sformatowanego ciągu.

Zwraca

Boolean

true jeśli wszystkie znaki zostały pomyślnie ustawione; w przeciwnym razie , false.

Wyjątki

ArgumentNullException

Parametr input ma wartość null.

Uwagi

Metoda Set czyści istniejącą zawartość sformatowanego ciągu, a następnie stosuje maskę względem input ciągu w celu zaktualizowania zawartości sformatowanego ciągu.

Poniższe warunki są uznawane za błędy. Gdy wystąpi błąd, sformatowany ciąg pozostaje niezmieniony i Set zwraca wartość false.

• W sformatowanym ciągu nie ma wystarczającej liczby pozycji edytowalnych do przechowywania zawartości ciągu zastępczego.

• Jedna z wartości znaków zastępczych jest nieprawidłowa, ponieważ nie jest drukowalna lub nie pasuje do odpowiadającego jej elementu maski.

Zobacz też

• IsValidInputChar(Char)
• Add
• Clear
• InsertAt
• Remove
• RemoveAt
• Replace

Set(String, Int32, MaskedTextResultHint)

Źródło:

MaskedTextProvider.cs

Ustawia sformatowany ciąg na określony ciąg wejściowy, a następnie generuje pozycję usuwania i informacje opisowe.

public:
 bool Set(System::String ^ input, [Runtime::InteropServices::Out] int % testPosition, [Runtime::InteropServices::Out] System::ComponentModel::MaskedTextResultHint % resultHint);

public bool Set (string input, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);

member this.Set : string * int * MaskedTextResultHint -> bool

Public Function Set (input As String, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean

Parametry

input

String

Wartość String używana do ustawiania sformatowanego ciągu.

testPosition

Int32

Jeśli to się powiedzie, pozycja oparta na zerze w sformatowanym ciągu, w którym ostatni znak został rzeczywiście ustawiony; w przeciwnym razie pierwsza pozycja, w której operacja nie powiodła się. Parametr wyjściowy.

resultHint

MaskedTextResultHint

Element MaskedTextResultHint , który zwięźle opisuje wynik operacji zestawu. Parametr wyjściowy.

Zwraca

Boolean

true jeśli wszystkie znaki zostały pomyślnie ustawione; w przeciwnym razie , false.

Wyjątki

ArgumentNullException

Parametr input ma wartość null.

Uwagi

Metoda Set czyści istniejącą zawartość sformatowanego ciągu, a następnie stosuje maskę względem input ciągu w celu zaktualizowania zawartości sformatowanego ciągu.

Poniższe warunki są uznawane za błędy. Gdy wystąpi błąd, sformatowany ciąg pozostaje niezmieniony i Set zwraca wartość false.

• W sformatowanym ciągu nie ma wystarczającej liczby pozycji edytowalnych do przechowywania zawartości ciągu zastępczego.

• Jedna z wartości znaków zastępczych jest nieprawidłowa, ponieważ nie jest drukowalna lub nie pasuje do odpowiadającego jej elementu maski.

Ta wersja programu Set udostępnia dwa dodatkowe parametry wyjściowe, aby przekazać więcej informacji na temat działania metody.

Zobacz też

• IsValidInputChar(Char)
• Add
• Clear
• InsertAt
• Remove
• RemoveAt
• Replace