NamedRange.Replace (Método)

  • Artículo

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.
  • MatchCase
    Tipo: System.Object
    Es true para que en la búsqueda se distinga mayúsculas de 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", missing],
        "namedRange1");

    namedRange1.Value2 = "This is a sentence.";
    namedRange1.Replace("a", "my", Excel.XlLookAt.xlPart,
        Excel.XlSearchOrder.xlByColumns, false, missing,
        missing, missing);
}

Seguridad de .NET Framework

Vea también

Referencia

NamedRange Interfaz

Microsoft.Office.Tools.Excel (Espacio de nombres)