MaskedTextProvider.Add Metoda

Definicja

Przestrzeń nazw:

System.ComponentModel

Zestawy:

netstandard.dll, System.ComponentModel.TypeConverter.dll

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

Przeciążenia

Nazwa	Opis
Add(String, Int32, MaskedTextResultHint)	Dodaje znaki w określonym ciągu wejściowym na końcu sformatowanego ciągu, a następnie zwraca położenie i opisowe informacje.
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 zwraca położenie i opisowe informacje.

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

Zawierająca String wartości znaków, które mają być dołączane do sformatowanego ciągu.

testPosition

Int32

Położenie na podstawie zera w sformatowanym ciągu, w którym podjęto próbę dodania znaku. Parametr wyjściowy.

resultHint

MaskedTextResultHint

Zwięźle MaskedTextResultHint opisuje wynik 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, zaczynając od pierwszego dostępnego położenia po LastAssignedPosition. Ta metoda zakończy się niepowodzeniem z następujących powodów:

• Każdy z znaków w wartości wejściowej , inputnie jest drukowalny lub wartość wejściowa nie jest zgodna z odpowiadającym mu elementem maski.

• Za mało dostępnych pozycji edycji w sformatowanych ciągach po ostatniej przypisanej pozycji.

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

Ta metoda działa tak samo jak zastąpiona wersja przyjmująca pojedynczy String parametr , z tą różnicą, 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

Położenie na podstawie zera w sformatowanym ciągu, w którym podjęto próbę dodania znaku. Parametr wyjściowy.

resultHint

MaskedTextResultHint

Zwięźle MaskedTextResultHint opisuje wynik 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 sformatowanych ciągach po ostatniej przypisanej pozycji, która jest reprezentowana LastAssignedPosition przez właściwość . Ta metoda zakończy się niepowodzeniem, jeśli wszystkie dostępne pozycje znajdują się przed ostatnią przypisaną pozycją. Ta metoda zakończy się niepowodzeniem z następujących powodów:

• Wartość wejściowa, input, nie jest drukowalna lub nie jest zgodna z odpowiadającym mu 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 zastąpiona wersja przyjmująca pojedynczy Char parametr , z tą różnicą, 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 pozycji, która została ostatnio przypisana, która jest reprezentowana LastAssignedPosition przez właściwość. Ta metoda zakończy się niepowodzeniem z następujących powodów:

• Wartość wejściowa, input, nie jest drukowalna lub nie jest zgodna z odpowiadającym mu 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

Zawierająca String wartości znaków, które mają być dołączane do sformatowanego ciągu.

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 jest null.

Uwagi

Metoda Add(String) dodaje znaki z input ciągu do sformatowanego ciągu, zaczynając od pierwszego dostępnego położenia po LastAssignedPosition. Ta metoda zakończy się niepowodzeniem z następujących powodów:

• Każdy z znaków w wartości wejściowej , inputnie jest drukowalny lub wartość wejściowa nie jest zgodna z odpowiadającym mu elementem maski.

• Za mało dostępnych pozycji edycji w sformatowanych ciągach po ostatniej przypisanej pozycji.

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

Zobacz też

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