MaskedTextProvider.Replace Método

Definición

Espacio de nombres:

System.ComponentModel

Ensamblado:

System.ComponentModel.TypeConverter.dll

Reemplaza uno o varios caracteres modificables de la cadena con formato por los caracteres especificados.

Sobrecargas

Replace(String, Int32, Int32, Int32, MaskedTextResultHint)	Reemplaza un intervalo de caracteres modificables por la cadena especificada entre las posiciones inicial y final indicadas, y, a continuación, genera información sobre la posición de eliminación e información descriptiva.
Replace(Char, Int32, Int32, Int32, MaskedTextResultHint)	Reemplaza un carácter individual situado entre las posiciones inicial y final especificadas por el valor de carácter especificado y, a continuación, genera información sobre la posición de eliminación e información descriptiva.
Replace(String, Int32, Int32, MaskedTextResultHint)	Reemplaza un intervalo de caracteres modificables por la cadena especificada comenzando en la posición indicada y, a continuación, genera información sobre la posición de eliminación e información descriptiva.
Replace(Char, Int32, Int32, MaskedTextResultHint)	Reemplaza un único carácter situado en la posición especificada o más allá de la misma por el valor de carácter especificado y, a continuación, genera información sobre la posición de eliminación e información descriptiva.
Replace(String, Int32)	Reemplaza un intervalo de caracteres modificables por la cadena especificada comenzando en la posición indicada.
Replace(Char, Int32)	Reemplaza un carácter individual por el valor de carácter especificado en la posición indicada o más allá de la misma.

Replace(String, Int32, Int32, Int32, MaskedTextResultHint)

Source:

MaskedTextProvider.cs

Reemplaza un intervalo de caracteres modificables por la cadena especificada entre las posiciones inicial y final indicadas, y, a continuación, genera información sobre la posición de eliminación e información descriptiva.

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

public bool Replace (string input, int startPosition, int endPosition, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);

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

Public Function Replace (input As String, startPosition As Integer, endPosition As Integer, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean

Parámetros

input

String

Valor de String que se utiliza para reemplazar los caracteres modificables existentes.

startPosition

Int32

Posición de base cero de la cadena con formato donde se inicia el reemplazo.

endPosition

Int32

Posición de base cero de la cadena con formato donde finaliza el reemplazo.

testPosition

Int32

Posición de base cero de la cadena con formato en la que se haya reemplazado realmente el último carácter, en caso de que se haya realizado correctamente la operación; de lo contrario, primera posición en la que no haya podido realizarse la operación. Parámetro de salida.

resultHint

MaskedTextResultHint

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

Devoluciones

Boolean

Es true si todos los caracteres se han reemplazado correctamente; de lo contrario, es false.

Comentarios

El Replace método busca la primera posición editable en la cadena con formato entre las posiciones inicial y final especificadas. Trabajando en la suposición de que hay suficientes posiciones editables después de este punto, los valores de caracteres existentes se reemplazan uno por uno por el contenido del parámetro de cadena de reemplazo, input.

Las condiciones siguientes se consideran errores. Cuando se produce un error, no se produce ningún reemplazo y Replace devuelve false.

• Los startPos parámetros o endPos apuntan antes del inicio de la cadena con formato o más allá de su fin.

• No hay suficientes posiciones editables en la cadena con formato para contener el contenido de la cadena de reemplazo.

• Uno de los valores de carácter de reemplazo no es válido porque no se puede imprimir o no coincide con su elemento mask correspondiente.

Además del valor devuelto, este método tiene dos parámetros de salida para proporcionar información adicional sobre la operación de reemplazo.

Consulte también

• IsValidInputChar(Char)
• Add
• Clear
• InsertAt
• Remove
• RemoveAt
• Set

Replace(Char, Int32, Int32, Int32, MaskedTextResultHint)

Source:

MaskedTextProvider.cs

Reemplaza un carácter individual situado entre las posiciones inicial y final especificadas por el valor de carácter especificado y, a continuación, genera información sobre la posición de eliminación e información descriptiva.

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

public bool Replace (char input, int startPosition, int endPosition, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);

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

Public Function Replace (input As Char, startPosition As Integer, endPosition As Integer, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean

Parámetros

input

Char

Valor Char por el que se reemplaza el valor existente.

startPosition

Int32

Posición de base cero de la cadena con formato donde se inicia el reemplazo.

endPosition

Int32

Posición de base cero de la cadena con formato donde finaliza el reemplazo.

testPosition

Int32

Posición de base cero de la cadena con formato en la que se haya reemplazado realmente el último carácter, en caso de que se haya realizado correctamente la operación; de lo contrario, primera posición en la que no haya podido realizarse la operación. Parámetro de salida.

resultHint

MaskedTextResultHint

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

Devoluciones

Boolean

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

Comentarios

El Replace(Char, Int32, Int32, Int32, MaskedTextResultHint) método busca la primera posición editable en la cadena con formato entre las posiciones inicial y final especificadas. Si se encuentra uno, el valor de la posición editable se cambia al carácter especificado, input. Cualquiera de las condiciones siguientes dará como resultado una condición de error que no hace que se realice ningún reemplazo y se devuelva un valor de false :

• Los startPos parámetros o endPos apuntan antes del inicio de la cadena con formato o más allá de su fin.

• No se encontró un carácter editable en el intervalo especificado.

• El carácter de reemplazo, input, no es un carácter de entrada válido porque no se puede imprimir o no coincide con su elemento de máscara correspondiente.

Además del valor devuelto, este método tiene dos parámetros de salida para proporcionar información adicional sobre la operación de reemplazo.

Consulte también

• IsValidInputChar(Char)
• Add
• Clear
• InsertAt
• Remove
• RemoveAt
• Set

Replace(String, Int32, Int32, MaskedTextResultHint)

Source:

MaskedTextProvider.cs

Reemplaza un intervalo de caracteres modificables por la cadena especificada comenzando en la posición indicada y, a continuación, genera información sobre la posición de eliminación e información descriptiva.

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

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

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

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

Parámetros

input

String

Valor de String que se utiliza para reemplazar los caracteres modificables existentes.

position

Int32

Posición de base cero en la que buscar el primer carácter modificable que se va a reemplazar.

testPosition

Int32

Posición de base cero de la cadena con formato en la que se haya reemplazado realmente el último carácter, en caso de que se haya realizado correctamente la operación; de lo contrario, primera posición en la que no haya podido realizarse la operación. Parámetro de salida.

resultHint

MaskedTextResultHint

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

Devoluciones

Boolean

Es true si todos los caracteres se han reemplazado correctamente; de lo contrario, es false.

Comentarios

El Replace(String, Int32, Int32, MaskedTextResultHint) método busca la primera posición editable en o más allá de la posición especificada, pos. Trabajando en la suposición de que hay suficientes posiciones editables después de este punto, los valores de caracteres existentes se reemplazan uno por uno por el contenido del parámetro de cadena de reemplazo, input.

Las condiciones siguientes se consideran errores. Cuando se produce un error, no se produce ningún reemplazo y Replace(String, Int32, Int32, MaskedTextResultHint) devuelve false.

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

• No hay suficientes posiciones editables en la cadena con formato para contener el contenido de la cadena de reemplazo.

• Uno de los valores de carácter de reemplazo no es válido porque no se puede imprimir o no coincide con su elemento mask correspondiente.

Además del valor devuelto, este método tiene dos parámetros de salida para proporcionar información adicional sobre la operación de reemplazo.

Consulte también

• IsValidInputChar(Char)
• Add
• Clear
• InsertAt
• Remove
• RemoveAt
• Set

Replace(Char, Int32, Int32, MaskedTextResultHint)

Source:

MaskedTextProvider.cs

Reemplaza un único carácter situado en la posición especificada o más allá de la misma por el valor de carácter especificado y, a continuación, genera información sobre la posición de eliminación e información descriptiva.

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

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

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

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

Parámetros

input

Char

Valor Char por el que se reemplaza el valor existente.

position

Int32

Posición de base cero en la que buscar el primer carácter modificable que se va a reemplazar.

testPosition

Int32

Posición de base cero de la cadena con formato en la que se haya reemplazado realmente el último carácter, en caso de que se haya realizado correctamente la operación; de lo contrario, primera posición en la que no haya podido realizarse la operación. Parámetro de salida.

resultHint

MaskedTextResultHint

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

Devoluciones

Boolean

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

Comentarios

El Replace(Char, Int32, Int32, MaskedTextResultHint) método busca la primera posición editable en la cadena con formato en o más allá de la posición especificada, pos. Si se encuentra uno, el valor de la posición editable se cambia al carácter especificado, input. Cualquiera de las condiciones siguientes dará como resultado una condición de error que no hace que se realice ningún reemplazo y se devuelva un valor de 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 reemplazo, input, no es un carácter de entrada válido porque no se puede imprimir o no coincide con su elemento de máscara correspondiente.

Además del valor devuelto, este método tiene dos parámetros de salida para proporcionar información adicional sobre la operación de reemplazo.

Consulte también

• IsValidInputChar(Char)
• Add
• Clear
• InsertAt
• Remove
• RemoveAt
• Set

Replace(String, Int32)

Source:

MaskedTextProvider.cs

Reemplaza un intervalo de caracteres modificables por la cadena especificada comenzando en la posición indicada.

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

public bool Replace (string input, int position);

member this.Replace : string * int -> bool

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

Parámetros

input

String

Valor de String que se utiliza para reemplazar los caracteres modificables existentes.

position

Int32

Posición de base cero en la que buscar el primer carácter modificable que se va a reemplazar.

Devoluciones

Boolean

Es true si todos los caracteres se han reemplazado correctamente; de lo contrario, es false.

Excepciones

ArgumentNullException

El parámetro input es null.

Comentarios

El Replace(String, Int32) método busca la primera posición editable en o más allá de la posición especificada, pos. Funcionando bajo la suposición de que hay suficientes posiciones editables después de este punto, los valores de caracteres existentes se reemplazan uno por uno por el contenido del parámetro de cadena de reemplazo, input.

Las condiciones siguientes se consideran errores. Cuando se produce un error, no se produce ningún reemplazo y Replace(String, Int32) devuelve false.

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

• No hay suficientes posiciones editables en la cadena con formato para contener el contenido de la cadena de reemplazo.

• Uno de los valores de carácter de reemplazo no es válido porque no se puede imprimir o no coincide con su elemento mask correspondiente.

Consulte también

• IsValidInputChar(Char)
• Add
• Clear
• InsertAt
• Remove
• RemoveAt
• Set

Replace(Char, Int32)

Source:

MaskedTextProvider.cs

Reemplaza un carácter individual por el valor de carácter especificado en la posición indicada o más allá de la misma.

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

public bool Replace (char input, int position);

member this.Replace : char * int -> bool

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

Parámetros

input

Char

Valor Char por el que se reemplaza el valor existente.

position

Int32

Posición de base cero en la que buscar el primer carácter modificable que se va a reemplazar.

Devoluciones

Boolean

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

Comentarios

El Replace(Char, Int32) método busca la primera posición editable en la cadena con formato en o más allá de la posición especificada, pos. Si se encuentra uno, el valor de la posición editable se cambia al carácter especificado, input. Cualquiera de las condiciones siguientes producirá un error que no provoca que se realice ningún reemplazo y se devuelva un valor de 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 reemplazo, input, no es un carácter de entrada válido porque no se puede imprimir o no coincide con su elemento de máscara correspondiente.

Consulte también

• IsValidInputChar(Char)
• FindEditPositionFrom(Int32, Boolean)
• Add
• Clear
• InsertAt
• Remove
• RemoveAt
• Set