MaskedTextProvider.Add Metodo

Definizione

Spazio dei nomi:

System.ComponentModel

Assembly:

netstandard.dll, System.ComponentModel.TypeConverter.dll

Aggiunge un carattere di input o una stringa di input alla stringa formattata.

Overload

Nome	Descrizione
Add(String, Int32, MaskedTextResultHint)	Aggiunge i caratteri nella stringa di input specificata alla fine della stringa formattata e quindi restituisce informazioni descrittive e sulla posizione.
Add(Char, Int32, MaskedTextResultHint)	Aggiunge il carattere di input specificato alla fine della stringa formattata e quindi restituisce informazioni descrittive e sulla posizione.
Add(Char)	Aggiunge il carattere di input specificato alla fine della stringa formattata.
Add(String)	Aggiunge i caratteri nella stringa di input specificata alla fine della stringa formattata.

Add(String, Int32, MaskedTextResultHint)

Origine:

MaskedTextProvider.cs

Aggiunge i caratteri nella stringa di input specificata alla fine della stringa formattata e quindi restituisce informazioni descrittive e sulla posizione.

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

Parametri

input

String

Oggetto String contenente i valori di carattere da aggiungere alla stringa formattata.

testPosition

Int32

Posizione in base zero nella stringa formattata in cui è stato effettuato il tentativo di aggiungere il carattere. Parametro di output.

resultHint

MaskedTextResultHint

Oggetto MaskedTextResultHint che descrive in modo conciso il risultato dell'operazione. Parametro di output.

Restituisce

Boolean

true se tutti i caratteri della stringa di input sono stati aggiunti correttamente; in caso contrario false , per indicare che non sono stati aggiunti caratteri.

Commenti

Il Add(String, Int32, MaskedTextResultHint) metodo aggiunge i caratteri dalla input stringa alla stringa formattata, a partire dalla prima posizione disponibile dopo LastAssignedPosition. Questo metodo avrà esito negativo per uno dei motivi seguenti:

• Uno qualsiasi dei caratteri nel valore di input, input, non è stampabile o il valore di input non corrisponde al corrispondente elemento mask.

• Non sono disponibili posizioni di modifica sufficienti nella stringa formattata dopo l'ultima posizione assegnata.

Se questo metodo non riesce, non vengono effettuate aggiunte e il metodo restituisce false.

Questo metodo funziona come la versione sottoposta a override che accetta un singolo String parametro, , Add(String)ad eccezione del fatto che restituisce informazioni aggiuntive.

Vedi anche

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

Add(Char, Int32, MaskedTextResultHint)

Origine:

MaskedTextProvider.cs

Aggiunge il carattere di input specificato alla fine della stringa formattata e quindi restituisce informazioni descrittive e sulla posizione.

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

Parametri

input

Char

Valore Char da aggiungere alla stringa formattata.

testPosition

Int32

Posizione in base zero nella stringa formattata in cui è stato effettuato il tentativo di aggiungere il carattere. Parametro di output.

resultHint

MaskedTextResultHint

Oggetto MaskedTextResultHint che descrive in modo conciso il risultato dell'operazione. Parametro di output.

Restituisce

Boolean

true se il carattere di input è stato aggiunto correttamente; in caso contrario false, .

Commenti

Il Add(Char, Int32, MaskedTextResultHint) metodo tenta di aggiungere il valore del input carattere alla prima posizione disponibile nella stringa formattata dopo l'ultima posizione assegnata, rappresentata dalla LastAssignedPosition proprietà . Questo metodo avrà esito negativo se tutte le posizioni disponibili sono prima dell'ultima posizione assegnata. Questo metodo avrà esito negativo per uno dei motivi seguenti:

• Il valore di input, input, non è stampabile o non corrisponde all'elemento mask corrispondente.

• Nessuna posizione di modifica disponibile nella stringa formattata o nessuna posizione di modifica disponibile dopo l'ultima posizione assegnata.

Questo metodo funziona come la versione sottoposta a override che accetta un singolo Char parametro, , Add(Char)ad eccezione del fatto che restituisce informazioni aggiuntive.

Vedi anche

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

Add(Char)

Origine:

MaskedTextProvider.cs

Aggiunge il carattere di input specificato alla fine della stringa formattata.

public:
 bool Add(char input);

public bool Add(char input);

member this.Add : char -> bool

Public Function Add (input As Char) As Boolean

Parametri

input

Char

Valore Char da aggiungere alla stringa formattata.

Restituisce

Boolean

true se il carattere di input è stato aggiunto correttamente; in caso contrario false, .

Commenti

Il Add(Char) metodo aggiunge il valore del input carattere alla prima posizione disponibile nella stringa formattata dopo l'ultima posizione assegnata, rappresentata dalla LastAssignedPosition proprietà . Questo metodo avrà esito negativo per uno dei motivi seguenti:

• Il valore di input, input, non è stampabile o non corrisponde all'elemento mask corrispondente.

• Nessuna posizione di modifica disponibile nella stringa formattata o nessuna posizione di modifica disponibile dopo l'ultima posizione assegnata.

Vedi anche

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

Add(String)

Origine:

MaskedTextProvider.cs

Aggiunge i caratteri nella stringa di input specificata alla fine della stringa formattata.

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

public bool Add(string input);

member this.Add : string -> bool

Public Function Add (input As String) As Boolean

Parametri

input

String

Oggetto String contenente i valori di carattere da aggiungere alla stringa formattata.

Restituisce

Boolean

true se tutti i caratteri della stringa di input sono stati aggiunti correttamente; in caso contrario false , per indicare che non sono stati aggiunti caratteri.

Eccezioni

ArgumentNullException

Il input parametro è null.

Commenti

Il Add(String) metodo aggiunge i caratteri dalla input stringa alla stringa formattata, a partire dalla prima posizione disponibile dopo LastAssignedPosition. Questo metodo avrà esito negativo per uno dei motivi seguenti:

• Uno qualsiasi dei caratteri nel valore di input, input, non è stampabile o il valore di input non corrisponde al corrispondente elemento mask.

• Non sono disponibili posizioni di modifica sufficienti nella stringa formattata dopo l'ultima posizione assegnata.

Se questo metodo non riesce, non vengono effettuate aggiunte e il metodo restituisce false.

Vedi anche

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