MaskedTextProvider.InsertAt Metodo

Definizione

Spazio dei nomi:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Inserisce un carattere o una stringa nella posizione indicata della stringa formattata.

Overload

InsertAt(Char, Int32)	Inserisce il carattere specificato nella posizione indicata della stringa formattata.
InsertAt(String, Int32)	Inserisce la stringa specificata nella posizione indicata della stringa formattata.
InsertAt(Char, Int32, Int32, MaskedTextResultHint)	Inserisce il carattere specificato nella posizione indicata della stringa formattata, restituendo l'ultima posizione di inserimento e lo stato dell'operazione.
InsertAt(String, Int32, Int32, MaskedTextResultHint)	Inserisce la stringa specificata nella posizione indicata della stringa formattata, restituendo l'ultima posizione di inserimento e lo stato dell'operazione.

InsertAt(Char, Int32)

Source:

MaskedTextProvider.cs

Inserisce il carattere specificato nella posizione indicata della stringa formattata.

public:
 bool InsertAt(char input, int position);

public bool InsertAt (char input, int position);

member this.InsertAt : char * int -> bool

Public Function InsertAt (input As Char, position As Integer) As Boolean

Parametri

input

Char

Elemento Char da inserire.

position

Int32

Posizione in base zero della stringa formattata nella quale inserire il carattere.

Restituisce

Boolean

true se l'inserimento è stato effettuato correttamente; in caso contrario, false.

Commenti

Il InsertAt metodo inserisce un carattere nella prima posizione di modifica in corrispondenza o successiva a quella specificata dal pos parametro . Questo metodo sposta tutti i caratteri esistenti dopo il punto di inserimento di una posizione per fare spazio per il carattere inserito input . Se si verifica uno degli errori seguenti, l'inserimento non viene eseguito e il metodo restituisce false.

• Il pos parametro è minore di zero o maggiore di quello Length della stringa formattata.

• Non è stato trovato un carattere modificabile nella stringa formattata in corrispondenza o oltre la posizione specificata, pos.

• Il carattere di inserimento, input, non è un carattere di input valido perché non è stampabile o non corrisponde all'elemento mask corrispondente.

• Nessuna posizione disponibile a destra del punto di inserimento, in modo che i caratteri esistenti non possano essere spostati.

• Lo spostamento dei caratteri esistenti genera una violazione della maschera.

Una stringa vuota input non causerà alcuna modifica nella stringa formattata, ma restituirà true.

Vedi anche

• Add
• AvailableEditPositionCount
• Mask
• Remove
• Replace
• Set
• ToDisplayString()
• VerifyString

InsertAt(String, Int32)

Source:

MaskedTextProvider.cs

Inserisce la stringa specificata nella posizione indicata della stringa formattata.

public:
 bool InsertAt(System::String ^ input, int position);

public bool InsertAt (string input, int position);

member this.InsertAt : string * int -> bool

Public Function InsertAt (input As String, position As Integer) As Boolean

Parametri

input

String

Elemento String da inserire.

position

Int32

Posizione in base zero della stringa formattata nella quale inserire la stringa di input.

Restituisce

Boolean

true se l'inserimento è stato effettuato correttamente; in caso contrario, false.

Eccezioni

ArgumentNullException

Il valore del parametro input è null.

Commenti

Il InsertAt metodo inserisce ogni carattere dalla input stringa nelle posizioni di modifica posizionate in posizione pos e oltre. Questo metodo sposta tutti i caratteri esistenti dopo il punto di inserimento di una posizione per ogni carattere inserito. Se si verifica uno degli errori seguenti, non viene eseguito alcun inserimento e il metodo restituisce false.

• Il pos parametro è minore di zero o maggiore di quello Length della stringa formattata.

• Nella stringa formattata o oltre la posizione posspecificata esistono caratteri modificabili sufficienti per inserire tutti i caratteri della input stringa.

• Uno o più caratteri di inserimento non sono un carattere di input valido perché non sono stampabili o non corrispondono all'elemento mask corrispondente.

• Non sono disponibili posizioni sufficienti a destra del punto di inserimento, in modo che i caratteri esistenti non possano essere spostati.

• Lo spostamento dei caratteri esistenti genera una violazione della maschera. Si noti che questo cambiamento si verifica durante l'inserimento di ogni singolo carattere.

Una stringa vuota input non causerà alcuna modifica nella stringa formattata, ma restituirà true.

Vedi anche

• Add
• AvailableEditPositionCount
• Mask
• Remove
• Replace
• Set
• ToDisplayString()
• VerifyString

InsertAt(Char, Int32, Int32, MaskedTextResultHint)

Source:

MaskedTextProvider.cs

Inserisce il carattere specificato nella posizione indicata della stringa formattata, restituendo l'ultima posizione di inserimento e lo stato dell'operazione.

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

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

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

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

Parametri

input

Char

Elemento Char da inserire.

position

Int32

Posizione in base zero della stringa formattata nella quale inserire il carattere.

testPosition

Int32

Se il metodo ha esito positivo, ultima posizione nella quale è stato inserito un carattere; in caso contrario, prima posizione nella quale l'inserimento ha avuto esito negativo. Parametro di output.

resultHint

MaskedTextResultHint

Oggetto MaskedTextResultHint che descrive sinteticamente il risultato dell'operazione di inserimento. Parametro di output.

Restituisce

Boolean

true se l'inserimento è stato effettuato correttamente; in caso contrario, false.

Commenti

Il InsertAt metodo inserisce un carattere nella prima posizione di modifica in corrispondenza o successiva a quella specificata dal pos parametro . Questo metodo sposta tutti i caratteri esistenti dopo il punto di inserimento di una posizione per fare spazio per il carattere inserito input . Se si verifica uno degli errori seguenti, l'inserimento non viene eseguito e il metodo restituisce false.

• Il pos parametro è minore di zero o maggiore di quello Length della stringa formattata.

• Non è stato trovato un carattere modificabile nella stringa formattata in corrispondenza o oltre la posizione specificata, pos.

• Il carattere di inserimento, input, non è un carattere di input valido perché non è stampabile o non corrisponde all'elemento mask corrispondente.

• Nessuna posizione disponibile a destra del punto di inserimento, in modo che i caratteri esistenti non possano essere spostati.

• Lo spostamento dei caratteri esistenti genera una violazione della maschera.

Una stringa vuota input non causerà alcuna modifica nella stringa formattata, ma restituirà true.

Vedi anche

• Add
• AvailableEditPositionCount
• Mask
• Remove
• Replace
• Set
• ToDisplayString()
• VerifyString

InsertAt(String, Int32, Int32, MaskedTextResultHint)

Source:

MaskedTextProvider.cs

Inserisce la stringa specificata nella posizione indicata della stringa formattata, restituendo l'ultima posizione di inserimento e lo stato dell'operazione.

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

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

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

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

Parametri

input

String

Elemento String da inserire.

position

Int32

Posizione in base zero della stringa formattata nella quale inserire la stringa di input.

testPosition

Int32

Se il metodo ha esito positivo, ultima posizione nella quale è stato inserito un carattere; in caso contrario, prima posizione nella quale l'inserimento ha avuto esito negativo. Parametro di output.

resultHint

MaskedTextResultHint

Oggetto MaskedTextResultHint che descrive sinteticamente il risultato dell'operazione di inserimento. Parametro di output.

Restituisce

Boolean

true se l'inserimento è stato effettuato correttamente; in caso contrario, false.

Eccezioni

ArgumentNullException

Il valore del parametro input è null.

Commenti

Il InsertAt metodo inserisce ogni carattere dalla input stringa nelle posizioni di modifica posizionate in posizione pos e oltre. Questo metodo sposta tutti i caratteri esistenti dopo il punto di inserimento di una posizione per ogni carattere inserito. Se si verifica uno degli errori seguenti, non viene eseguito alcun inserimento e il metodo restituisce false.

• Il pos parametro è minore di zero o maggiore di quello Length della stringa formattata.

• Nella stringa formattata o oltre la posizione posspecificata esistono caratteri modificabili sufficienti per inserire tutti i caratteri della input stringa.

• Uno o più caratteri di inserimento non sono un carattere di input valido perché non sono stampabili o non corrispondono all'elemento mask corrispondente.

• Non sono disponibili posizioni sufficienti a destra del punto di inserimento, in modo che i caratteri esistenti non possano essere spostati.

• Lo spostamento dei caratteri esistenti genera una violazione della maschera. Si noti che questo cambiamento si verifica durante l'inserimento di ogni singolo carattere.

Una stringa vuota input non causerà alcuna modifica nella stringa formattata, ma restituirà true.

Vedi anche

• Add
• AvailableEditPositionCount
• Mask
• Remove
• Replace
• Set
• ToDisplayString()
• VerifyString