MaskedTextProvider.InsertAt Método

Definición

Espacio de nombres:

System.ComponentModel

Ensamblado:

System.ComponentModel.TypeConverter.dll

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

Sobrecargas

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

InsertAt(Char, Int32)

Source:

MaskedTextProvider.cs

Inserta el carácter especificado en la posición indicada 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

Char que se va a insertar.

position

Int32

Posición de base cero de la cadena con formato donde debe insertarse el carácter.

Devoluciones

Boolean

Es true si el carácter se ha insertado correctamente; en caso contrario, es 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 dejar espacio para el carácter insertado input . Si se produce uno de los errores siguientes, 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, por lo que no se pueden cambiar los caracteres existentes.

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

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

Consulte también

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

InsertAt(String, Int32)

Source:

MaskedTextProvider.cs

Inserta la cadena especificada en la posición indicada 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

String que se va a insertar.

position

Int32

Posición de base cero de la cadena con formato donde debe insertarse la cadena de entrada.

Devoluciones

Boolean

Es true si el carácter se ha insertado correctamente; en caso contrario, es false.

Excepciones

ArgumentNullException

El parámetro input es null.

Comentarios

El InsertAt método inserta cada carácter de la input cadena en las posiciones de edición situadas 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.

• Cambiar 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 producirá ningún cambio en la cadena con formato, pero devolverá true.

Consulte también

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

InsertAt(Char, Int32, Int32, MaskedTextResultHint)

Source:

MaskedTextProvider.cs

Inserta el carácter especificado en la posición indicada de la cadena con formato y devuelve 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

Char que se va a insertar.

position

Int32

Posición de base cero de la cadena con formato donde debe insertarse el carácter.

testPosition

Int32

Última posición donde se haya insertado un carácter, en caso de que el método se haya llevado a cabo correctamente; de lo contrario, primera posición donde no se haya podido efectuar la inserción. Parámetro de salida.

resultHint

MaskedTextResultHint

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

Devoluciones

Boolean

Es true si el carácter se ha insertado correctamente; en caso contrario, es 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 dejar espacio para el carácter insertado input . Si se produce uno de los errores siguientes, 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, por lo que no se pueden cambiar los caracteres existentes.

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

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

Consulte también

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

InsertAt(String, Int32, Int32, MaskedTextResultHint)

Source:

MaskedTextProvider.cs

Inserta la cadena especificada en la posición indicada de la cadena con formato y devuelve 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

String que se va a insertar.

position

Int32

Posición de base cero de la cadena con formato donde debe insertarse la cadena de entrada.

testPosition

Int32

Última posición donde se haya insertado un carácter, en caso de que el método se haya llevado a cabo correctamente; de lo contrario, primera posición donde no se haya podido efectuar la inserción. Parámetro de salida.

resultHint

MaskedTextResultHint

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

Devoluciones

Boolean

Es true si el carácter se ha insertado correctamente; en caso contrario, es false.

Excepciones

ArgumentNullException

El parámetro input es null.

Comentarios

El InsertAt método inserta cada carácter de la input cadena en las posiciones de edición situadas 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.

• Cambiar 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 producirá ningún cambio en la cadena con formato, pero devolverá true.

Consulte también

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