MaskedTextProvider.InsertAt Metodo

Definizione

Inserisce un carattere o una stringa in una posizione specifica all'interno della stringa formattata.

Overload

Nome Descrizione
InsertAt(Char, Int32)

Inserisce il carattere specificato nella posizione specificata all'interno della stringa formattata.

InsertAt(String, Int32)

Inserisce la stringa specificata in una posizione specificata all'interno della stringa formattata.

InsertAt(Char, Int32, Int32, MaskedTextResultHint)

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

InsertAt(String, Int32, Int32, MaskedTextResultHint)

Inserisce la stringa specificata in una posizione specificata all'interno della stringa formattata, restituendo l'ultima posizione di inserimento e lo stato dell'operazione.

InsertAt(Char, Int32)

Inserisce il carattere specificato nella posizione specificata all'interno 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

Oggetto Char da inserire.

position
Int32

Posizione in base zero nella stringa formattata per inserire il carattere.

Valori restituiti

true se l'inserimento ha avuto esito positivo; 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 liberare 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 al corrispondente elemento mask.

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

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

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

Vedi anche

Si applica a

InsertAt(String, Int32)

Inserisce la stringa specificata in una posizione specificata all'interno 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

Oggetto String da inserire.

position
Int32

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

Valori restituiti

true se l'inserimento ha avuto esito positivo; in caso contrario, false.

Eccezioni

Il input parametro è null.

Commenti

Il InsertAt metodo inserisce ogni carattere dalla input stringa nelle posizioni di modifica che si trovano 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 non sono presenti caratteri modificabili sufficienti in corrispondenza o oltre la posizione specificata, pos, 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 genererebbe una violazione della maschera. Si noti che questo spostamento 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

Si applica a

InsertAt(Char, Int32, Int32, MaskedTextResultHint)

Inserisce il carattere specificato nella posizione specificata all'interno 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

Oggetto Char da inserire.

position
Int32

Posizione in base zero nella stringa formattata per inserire il carattere.

testPosition
Int32

Se il metodo ha esito positivo, l'ultima posizione in cui è stato inserito un carattere; in caso contrario, la prima posizione in cui l'inserimento non è riuscito. Parametro di output.

resultHint
MaskedTextResultHint

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

Valori restituiti

true se l'inserimento ha avuto esito positivo; 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 liberare 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 al corrispondente elemento mask.

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

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

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

Vedi anche

Si applica a

InsertAt(String, Int32, Int32, MaskedTextResultHint)

Inserisce la stringa specificata in una posizione specificata all'interno 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

Oggetto String da inserire.

position
Int32

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

testPosition
Int32

Se il metodo ha esito positivo, l'ultima posizione in cui è stato inserito un carattere; in caso contrario, la prima posizione in cui l'inserimento non è riuscito. Parametro di output.

resultHint
MaskedTextResultHint

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

Valori restituiti

true se l'inserimento ha avuto esito positivo; in caso contrario, false.

Eccezioni

Il input parametro è null.

Commenti

Il InsertAt metodo inserisce ogni carattere dalla input stringa nelle posizioni di modifica che si trovano 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 non sono presenti caratteri modificabili sufficienti in corrispondenza o oltre la posizione specificata, pos, 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 genererebbe una violazione della maschera. Si noti che questo spostamento 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

Si applica a