NamedRange.Replace (Método)
Reemplaza los caracteres especificados en el control NamedRange con una nueva cadena.
Espacio de nombres: Microsoft.Office.Tools.Excel
Ensamblado: Microsoft.Office.Tools.Excel (en Microsoft.Office.Tools.Excel.dll)
Sintaxis
'Declaración
Function Replace ( _
What As Object, _
Replacement As Object, _
LookAt As Object, _
SearchOrder As Object, _
MatchCase As Object, _
MatchByte As Object, _
SearchFormat As Object, _
ReplaceFormat As Object _
) As Boolean
bool Replace(
Object What,
Object Replacement,
Object LookAt,
Object SearchOrder,
Object MatchCase,
Object MatchByte,
Object SearchFormat,
Object ReplaceFormat
)
Parámetros
- What
Tipo: System.Object
Cadena que desea que busque Microsoft Office Excel.
- Replacement
Tipo: System.Object
Cadena de reemplazo.
- LookAt
Tipo: System.Object
Puede ser una de las constantes XlLookAt siguientes: xlWhole o xlPart.
- SearchOrder
Tipo: System.Object
Puede ser una de las constantes XlSearchOrder siguientes: xlByRows o xlByColumns.
- MatchCase
Tipo: System.Object
true para que en la búsqueda se distinga entre mayúsculas y minúsculas.
- MatchByte
Tipo: System.Object
Solo puede utilizar este argumento si ha seleccionado o ha instalado la compatibilidad con idiomas de doble byte en Excel. true si las coincidencias con caracteres de doble byte sólo deben ser con caracteres de doble byte; false si las coincidencias con caracteres de doble byte van a ser con equivalentes de un solo byte.
- SearchFormat
Tipo: System.Object
Formato de búsqueda para el método.
- ReplaceFormat
Tipo: System.Object
Formato de reemplazo para el método.
Valor devuelto
Tipo: System.Boolean
Es true si los caracteres especificados están en las celdas del control NamedRange; en caso contrario, es false.
Comentarios
El uso de este método no implica ningún cambio en la selección ni en la celda activa.
La configuración para LookAt, SearchOrder, MatchCase y MatchByte se guarda cada vez que se utiliza este método.Si no especifica valores para estos argumentos, la próxima vez que realice una llamada al método se utilizarán los valores guardados.Al establecer estos argumentos, se cambia la configuración en el cuadro de diálogo Buscar y, al cambiar la configuración de este cuadro de diálogo, se cambian los valores guardados que se utilizan si omite los argumentos.Para evitar problemas, establezca explícitamente estos argumentos cada vez que utilice este método.
Parámetros opcionales
Para obtener información sobre parámetros opcionales, vea Parámetros opcionales en las soluciones de Office.
Ejemplos
En el siguiente ejemplo de código se establece el valor de las celdas de un control NamedRange en la cadena "This is a sentence." y, a continuación, se usa el método Replace para reemplazar la subcadena "a" por "my".
Se trata de un ejemplo para una personalización en el nivel del documento.
Private Sub ReplaceValue()
Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
= Me.Controls.AddNamedRange(Me.Range("A1"), _
"namedRange1")
namedRange1.Value2 = "This is a sentence."
namedRange1.Replace("a", "my", Excel.XlLookAt.xlPart, _
Excel.XlSearchOrder.xlByColumns, False, , , )
End Sub
private void ReplaceValue()
{
Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
this.Controls.AddNamedRange(this.Range["A1"],
"namedRange1");
namedRange1.Value2 = "This is a sentence.";
namedRange1.Replace("a", "my", Excel.XlLookAt.xlPart,
Excel.XlSearchOrder.xlByColumns, false);
}
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.