MaskedTextProvider.InsertAt Método

Definición

Espacio de nombres:
System.ComponentModel
Ensamblado:
System.dll
Ensamblado:
netstandard.dll

Inserta un carácter o una cadena en una posición específica dentro de la cadena con formato.

Sobrecargas

Nombre Description
InsertAt(Char, Int32)

Inserta el carácter especificado en la posición especificada dentro de la cadena con formato.
InsertAt(String, Int32)

Inserta la cadena especificada en una posición especificada dentro de la cadena con formato.
InsertAt(Char, Int32, Int32, MaskedTextResultHint)

Inserta el carácter especificado en la posición especificada dentro de la cadena con formato, devolviendo la última posición de inserción y el estado de la operación.
InsertAt(String, Int32, Int32, MaskedTextResultHint)

Inserta la cadena especificada en una posición especificada dentro de la cadena con formato, devolviendo la última posición de inserción y el estado de la operación.

InsertAt(Char, Int32)

Inserta el carácter especificado en la posición especificada dentro de la cadena con formato.

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

Parámetros

input
Char

que Char se va a insertar.

position
Int32

Posición de base cero en la cadena con formato para insertar el carácter.

Devoluciones

Boolean

true si la inserción se realizó correctamente; de lo contrario, false.

Comentarios

El InsertAt método inserta un carácter en la primera posición de edición en o más allá de la especificada por el pos parámetro . Este método desplazará todos los caracteres existentes después del punto de inserción por una posición para hacer espacio para el carácter insertado input . Si se produce uno de los siguientes errores, no se realiza la inserción y el método devuelve false.

  • El pos parámetro es menor que cero o mayor que el Length de la cadena con formato.

  • No se encontró un carácter editable en la cadena con formato en o más allá de la posición especificada, pos.

  • El carácter de inserción, input, no es un carácter de entrada válido porque no es imprimible o no coincide con su elemento mask correspondiente.

  • No hay ninguna posición disponible a la derecha del punto de inserción, de modo que no se puedan desplazar los caracteres existentes.

  • El cambio de los caracteres existentes produciría una infracción de la máscara.

Una cadena vacía input no provocará ningún cambio en la cadena con formato, pero devolverá true.

Consulte también

Se aplica a

InsertAt(String, Int32)

Inserta la cadena especificada en una posición especificada dentro de la cadena con formato.

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

Parámetros

input
String

que String se va a insertar.

position
Int32

Posición de base cero en la cadena con formato para insertar la cadena de entrada.

Devoluciones

Boolean

true si la inserción se realizó correctamente; de lo contrario, false.

Excepciones

ArgumentNullException

El input parámetro es null.

Comentarios

El InsertAt método inserta cada carácter de la input cadena en las posiciones de edición ubicadas en la posición pos y más allá. Este método desplazará todos los caracteres existentes después del punto de inserción por una posición para cada carácter insertado. Si se produce uno de los errores siguientes, no se realiza ninguna inserción y el método devuelve false.

  • El pos parámetro es menor que cero o mayor que el Length de la cadena con formato.

  • No existen suficientes caracteres editables en la cadena con formato en o más allá de la posición especificada, pos, para insertar todos los caracteres de la input cadena.

  • Uno o varios de los caracteres de inserción no son un carácter de entrada válido porque no son imprimibles o no coinciden con su elemento de máscara correspondiente.

  • No hay suficientes posiciones disponibles a la derecha del punto de inserción, por lo que no se pueden desplazar los caracteres existentes.

  • El cambio de los caracteres existentes produciría una infracción de la máscara. Tenga en cuenta que este cambio se produce durante la inserción de cada carácter individual.

Una cadena vacía input no provocará ningún cambio en la cadena con formato, pero devolverá true.

Consulte también

Se aplica a

InsertAt(Char, Int32, Int32, MaskedTextResultHint)

Inserta el carácter especificado en la posición especificada dentro de la cadena con formato, devolviendo la última posición de inserción y el estado de la operación.

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

Parámetros

input
Char

que Char se va a insertar.

position
Int32

Posición de base cero en la cadena con formato para insertar el carácter.

testPosition
Int32

Si el método se ejecuta correctamente, la última posición donde se insertó un carácter; de lo contrario, la primera posición en la que se produjo un error en la inserción. Parámetro de salida.

resultHint
MaskedTextResultHint

que MaskedTextResultHint describe concisamente el resultado de la operación de inserción. Parámetro de salida.

Devoluciones

Boolean

true si la inserción se realizó correctamente; de lo contrario, false.

Comentarios

El InsertAt método inserta un carácter en la primera posición de edición en o más allá de la especificada por el pos parámetro . Este método desplazará todos los caracteres existentes después del punto de inserción por una posición para hacer espacio para el carácter insertado input . Si se produce uno de los siguientes errores, no se realiza la inserción y el método devuelve false.

  • El pos parámetro es menor que cero o mayor que el Length de la cadena con formato.

  • No se encontró un carácter editable en la cadena con formato en o más allá de la posición especificada, pos.

  • El carácter de inserción, input, no es un carácter de entrada válido porque no es imprimible o no coincide con su elemento mask correspondiente.

  • No hay ninguna posición disponible a la derecha del punto de inserción, de modo que no se puedan desplazar los caracteres existentes.

  • El cambio de los caracteres existentes produciría una infracción de la máscara.

Una cadena vacía input no provocará ningún cambio en la cadena con formato, pero devolverá true.

Consulte también

Se aplica a

InsertAt(String, Int32, Int32, MaskedTextResultHint)

Inserta la cadena especificada en una posición especificada dentro de la cadena con formato, devolviendo la última posición de inserción y el estado de la operación.

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

Parámetros

input
String

que String se va a insertar.

position
Int32

Posición de base cero en la cadena con formato para insertar la cadena de entrada.

testPosition
Int32

Si el método se ejecuta correctamente, la última posición donde se insertó un carácter; de lo contrario, la primera posición en la que se produjo un error en la inserción. Parámetro de salida.

resultHint
MaskedTextResultHint

que MaskedTextResultHint describe concisamente el resultado de la operación de inserción. Parámetro de salida.

Devoluciones

Boolean

true si la inserción se realizó correctamente; de lo contrario, false.

Excepciones

ArgumentNullException

El input parámetro es null.

Comentarios

El InsertAt método inserta cada carácter de la input cadena en las posiciones de edición ubicadas en la posición pos y más allá. Este método desplazará todos los caracteres existentes después del punto de inserción por una posición para cada carácter insertado. Si se produce uno de los errores siguientes, no se realiza ninguna inserción y el método devuelve false.

  • El pos parámetro es menor que cero o mayor que el Length de la cadena con formato.

  • No existen suficientes caracteres editables en la cadena con formato en o más allá de la posición especificada, pos, para insertar todos los caracteres de la input cadena.

  • Uno o varios de los caracteres de inserción no son un carácter de entrada válido porque no son imprimibles o no coinciden con su elemento de máscara correspondiente.

  • No hay suficientes posiciones disponibles a la derecha del punto de inserción, por lo que no se pueden desplazar los caracteres existentes.

  • El cambio de los caracteres existentes produciría una infracción de la máscara. Tenga en cuenta que este cambio se produce durante la inserción de cada carácter individual.

Una cadena vacía input no provocará ningún cambio en la cadena con formato, pero devolverá true.

Consulte también

Se aplica a