MaskedTextProvider.Add Método

Definición

Espacio de nombres:

System.ComponentModel

Ensamblado:

System.ComponentModel.TypeConverter.dll

Agrega un carácter de entrada o una cadena de entrada a la cadena con formato.

Sobrecargas

Add(String, Int32, MaskedTextResultHint)	Agrega los caracteres de la cadena de entrada especificada al final de la cadena con formato y, a continuación, genera información sobre la posición e información descriptiva.
Add(Char, Int32, MaskedTextResultHint)	Agrega el carácter de entrada especificado al final de la cadena con formato y, a continuación, genera información sobre la posición e información descriptiva.
Add(Char)	Agrega el carácter de entrada especificado al final de la cadena con formato.
Add(String)	Agrega los caracteres de la cadena de entrada especificada al final de la cadena con formato.

Add(String, Int32, MaskedTextResultHint)

Source:

MaskedTextProvider.cs

Agrega los caracteres de la cadena de entrada especificada al final de la cadena con formato y, a continuación, genera información sobre la posición e información descriptiva.

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

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

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

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

Parámetros

input

String

Objeto String que contiene los valores de caracteres que se van a anexar a la cadena con formato.

testPosition

Int32

Posición de base cero de la cadena con formato a la que se intentó agregar el carácter. Parámetro de salida.

resultHint

MaskedTextResultHint

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

Devoluciones

Boolean

Es true si todos los caracteres de la cadena de entrada se han agregado correctamente; de lo contrario, es false para indicar que no se ha agregado ningún carácter.

Comentarios

El Add(String, Int32, MaskedTextResultHint) método agrega los caracteres de la input cadena a la cadena con formato, empezando por la primera posición disponible después LastAssignedPositionde . Este método producirá un error por cualquiera de los siguientes motivos:

• Cualquiera de los caracteres del valor de entrada, input, no son imprimibles o el valor de entrada no coincide con su elemento mask correspondiente.

• No hay suficientes posiciones de edición disponibles en la cadena con formato después de la última posición asignada.

Si se produce un error en este método, no se realizan adiciones y el método devuelve false.

Este método funciona igual que la versión invalidada que toma un único String parámetro, Add(String), salvo que genera información adicional.

Consulte también

• Replace
• Remove
• InsertAt
• Clear
• Set
• AvailableEditPositionCount
• LastAssignedPosition
• IsValidInputChar(Char)
• VerifyString

Add(Char, Int32, MaskedTextResultHint)

Source:

MaskedTextProvider.cs

Agrega el carácter de entrada especificado al final de la cadena con formato y, a continuación, genera información sobre la posición e información descriptiva.

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

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

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

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

Parámetros

input

Char

Valor Char que se va a anexar a la cadena con formato.

testPosition

Int32

Posición de base cero de la cadena con formato a la que se intentó agregar el carácter. Parámetro de salida.

resultHint

MaskedTextResultHint

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

Devoluciones

Boolean

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

Comentarios

El Add(Char, Int32, MaskedTextResultHint) método intenta agregar el valor de input carácter a la primera posición disponible en la cadena con formato después de la posición asignada por última vez, representada por la LastAssignedPosition propiedad . Este método producirá un error si todas las posiciones disponibles están antes de la última posición asignada. Este método producirá un error por cualquiera de los siguientes motivos:

• El valor de entrada, input, no se puede imprimir o no coincide con su elemento mask correspondiente.

• Hay cero posiciones de edición disponibles en la cadena con formato o no hay posiciones de edición disponibles después de la última posición asignada.

Este método funciona igual que la versión invalidada que toma un único Char parámetro, Add(Char), salvo que genera información adicional.

Consulte también

• Replace
• Remove
• InsertAt
• Clear
• Set
• AvailableEditPositionCount
• LastAssignedPosition
• IsValidInputChar(Char)
• VerifyChar(Char, Int32, MaskedTextResultHint)

Add(Char)

Source:

MaskedTextProvider.cs

Agrega el carácter de entrada especificado al final de la cadena con formato.

public:
 bool Add(char input);

public bool Add (char input);

member this.Add : char -> bool

Public Function Add (input As Char) As Boolean

Parámetros

input

Char

Valor Char que se va a anexar a la cadena con formato.

Devoluciones

Boolean

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

Comentarios

El Add(Char) método agrega el valor de input carácter a la primera posición disponible en la cadena con formato después de la posición asignada por última vez, representada por la LastAssignedPosition propiedad . Este método producirá un error por cualquiera de los siguientes motivos:

• El valor de entrada, input, no se puede imprimir o no coincide con su elemento mask correspondiente.

• Hay cero posiciones de edición disponibles en la cadena con formato o no hay posiciones de edición disponibles después de la última posición asignada.

Consulte también

• Replace
• Remove
• InsertAt
• Clear
• Set
• AvailableEditPositionCount
• LastAssignedPosition
• IsValidInputChar(Char)
• VerifyChar(Char, Int32, MaskedTextResultHint)

Add(String)

Source:

MaskedTextProvider.cs

Agrega los caracteres de la cadena de entrada especificada al final de la cadena con formato.

public:
 bool Add(System::String ^ input);

public bool Add (string input);

member this.Add : string -> bool

Public Function Add (input As String) As Boolean

Parámetros

input

String

Objeto String que contiene los valores de caracteres que se van a anexar a la cadena con formato.

Devoluciones

Boolean

Es true si todos los caracteres de la cadena de entrada se han agregado correctamente; de lo contrario, es false para indicar que no se ha agregado ningún carácter.

Excepciones

ArgumentNullException

El parámetro input es null.

Comentarios

El Add(String) método agrega los caracteres de la input cadena a la cadena con formato, empezando por la primera posición disponible después LastAssignedPositionde . Este método producirá un error por cualquiera de los siguientes motivos:

• Cualquiera de los caracteres del valor de entrada, input, no son imprimibles o el valor de entrada no coincide con su elemento mask correspondiente.

• No hay suficientes posiciones de edición disponibles en la cadena con formato después de la última posición asignada.

Si se produce un error en este método, no se realizan adiciones y el método devuelve false.

Consulte también

• Replace
• Remove
• InsertAt
• Clear
• Set
• AvailableEditPositionCount
• LastAssignedPosition
• IsValidInputChar(Char)
• VerifyString