MaskedTextProvider.Add Metoda

Definicja

Przestrzeń nazw:

System.ComponentModel

Zestaw:

System.ComponentModel.TypeConverter.dll

Dodaje znak wejściowy lub ciąg wejściowy do sformatowanego ciągu.

Przeciążenia

Add(String, Int32, MaskedTextResultHint)	Dodaje znaki w określonym ciągu wejściowym na końcu sformatowanego ciągu, a następnie wyprowadza pozycje i informacje opisowe.
Add(Char, Int32, MaskedTextResultHint)	Dodaje określony znak wejściowy na końcu sformatowanego ciągu, a następnie zwraca położenie i opisowe informacje.
Add(Char)	Dodaje określony znak wejściowy na końcu sformatowanego ciągu.
Add(String)	Dodaje znaki w określonym ciągu wejściowym na końcu sformatowanego ciągu.

Add(String, Int32, MaskedTextResultHint)

Źródło:

MaskedTextProvider.cs

Dodaje znaki w określonym ciągu wejściowym na końcu sformatowanego ciągu, a następnie wyprowadza pozycje i informacje opisowe.

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

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

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

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

Parametry

input

String

Do String sformatowanego ciągu należy dołączyć zawierające wartości znaków.

testPosition

Int32

Pozycja oparta na zera w sformatowanym ciągu, w którym podjęto próbę dodania znaku. Parametr wyjściowy.

resultHint

MaskedTextResultHint

Ten MaskedTextResultHint zwięzły opis wyniku operacji. Parametr wyjściowy.

Zwraca

Boolean

true jeśli wszystkie znaki z ciągu wejściowego zostały pomyślnie dodane; w przeciwnym razie false , aby wskazać, że nie dodano żadnych znaków.

Uwagi

Metoda Add(String, Int32, MaskedTextResultHint) dodaje znaki z input ciągu do sformatowanego ciągu, począwszy od pierwszej dostępnej pozycji po LastAssignedPosition. Ta metoda zakończy się niepowodzeniem z następujących powodów:

• Dowolny z znaków w wartości wejściowej , inputnie można wydrukować lub wartość wejściowa nie jest zgodna z odpowiednim elementem maski.

• Za mało dostępnych pozycji edycji w sformatowanych ciągach po ostatnim przypisanym położeniu.

Jeśli ta metoda nie powiedzie się, żadne dodatki nie zostaną wykonane, a metoda zwróci falsewartość .

Ta metoda działa tak samo jak wersja przesłoniętą, która przyjmuje pojedynczy String parametr , z wyjątkiem tego, Add(String)że generuje dodatkowe informacje.

Zobacz też

• Replace
• Remove
• InsertAt
• Clear
• Set
• AvailableEditPositionCount
• LastAssignedPosition
• IsValidInputChar(Char)
• VerifyString

Add(Char, Int32, MaskedTextResultHint)

Źródło:

MaskedTextProvider.cs

Dodaje określony znak wejściowy na końcu sformatowanego ciągu, a następnie zwraca położenie i opisowe informacje.

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

public bool Add (char input, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);

member this.Add : char * int * MaskedTextResultHint -> bool

Public Function Add (input As Char, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean

Parametry

input

Char

Char Wartość, która ma zostać dołączona do sformatowanego ciągu.

testPosition

Int32

Pozycja oparta na zera w sformatowanym ciągu, w którym podjęto próbę dodania znaku. Parametr wyjściowy.

resultHint

MaskedTextResultHint

Ten MaskedTextResultHint zwięzły opis wyniku operacji. Parametr wyjściowy.

Zwraca

Boolean

true jeśli znak wejściowy został dodany pomyślnie; w przeciwnym razie false.

Uwagi

Metoda Add(Char, Int32, MaskedTextResultHint) próbuje dodać input wartość znaku do pierwszej dostępnej pozycji w sformatowany ciąg po ustawieniu, które zostało ostatnio przypisane, co jest reprezentowane przez LastAssignedPosition właściwość. Ta metoda zakończy się niepowodzeniem, jeśli wszystkie dostępne pozycje znajdują się przed ostatnim przypisanym położeniem. Ta metoda zakończy się niepowodzeniem z następujących powodów:

• Wartość wejściowa , inputnie jest drukowalna lub nie jest zgodna z odpowiednim elementem maski.

• Brak dostępnych pozycji edycji w sformatowanych ciągach lub brak dostępnych pozycji edycji po ostatniej przypisanej pozycji.

Ta metoda działa tak samo jak wersja przesłoniętą, która przyjmuje pojedynczy Char parametr , z wyjątkiem tego, Add(Char)że generuje dodatkowe informacje.

Zobacz też

• Replace
• Remove
• InsertAt
• Clear
• Set
• AvailableEditPositionCount
• LastAssignedPosition
• IsValidInputChar(Char)
• VerifyChar(Char, Int32, MaskedTextResultHint)

Add(Char)

Źródło:

MaskedTextProvider.cs

Dodaje określony znak wejściowy na końcu sformatowanego ciągu.

public:
 bool Add(char input);

public bool Add (char input);

member this.Add : char -> bool

Public Function Add (input As Char) As Boolean

Parametry

input

Char

Char Wartość, która ma zostać dołączona do sformatowanego ciągu.

Zwraca

Boolean

true jeśli znak wejściowy został dodany pomyślnie; w przeciwnym razie false.

Uwagi

Metoda Add(Char) dodaje input wartość znaku do pierwszej dostępnej pozycji w sformatowanych ciągach po ustawieniu, które zostało ostatnio przypisane, co jest reprezentowane przez LastAssignedPosition właściwość. Ta metoda zakończy się niepowodzeniem z następujących powodów:

• Wartość wejściowa , inputnie jest drukowalna lub nie jest zgodna z odpowiednim elementem maski.

• Brak dostępnych pozycji edycji w sformatowanych ciągach lub brak dostępnych pozycji edycji po ostatniej przypisanej pozycji.

Zobacz też

• Replace
• Remove
• InsertAt
• Clear
• Set
• AvailableEditPositionCount
• LastAssignedPosition
• IsValidInputChar(Char)
• VerifyChar(Char, Int32, MaskedTextResultHint)

Add(String)

Źródło:

MaskedTextProvider.cs

Dodaje znaki w określonym ciągu wejściowym na końcu sformatowanego ciągu.

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

public bool Add (string input);

member this.Add : string -> bool

Public Function Add (input As String) As Boolean

Parametry

input

String

Do String sformatowanego ciągu należy dołączyć zawierające wartości znaków.

Zwraca

Boolean

true jeśli wszystkie znaki z ciągu wejściowego zostały pomyślnie dodane; w przeciwnym razie false , aby wskazać, że nie dodano żadnych znaków.

Wyjątki

ArgumentNullException

Parametr input to null.

Uwagi

Metoda Add(String) dodaje znaki z input ciągu do sformatowanego ciągu, począwszy od pierwszej dostępnej pozycji po LastAssignedPosition. Ta metoda zakończy się niepowodzeniem z następujących powodów:

• Dowolny z znaków w wartości wejściowej , inputnie można wydrukować lub wartość wejściowa nie jest zgodna z odpowiednim elementem maski.

• Za mało dostępnych pozycji edycji w sformatowanych ciągach po ostatnim przypisanym położeniu.

Jeśli ta metoda nie powiedzie się, żadne dodatki nie zostaną wykonane, a metoda zwróci falsewartość .

Zobacz też

• Replace
• Remove
• InsertAt
• Clear
• Set
• AvailableEditPositionCount
• LastAssignedPosition
• IsValidInputChar(Char)
• VerifyString