Compartilhar via


Método NamedRange.Replace

Substitui os caracteres especificados no controle de NamedRange com uma nova cadeia de caracteres.

Namespace:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel (em Microsoft.Office.Tools.Excel.dll)

Sintaxe

'Declaração
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
    A cadeia de caracteres você deseja Microsoft Office Excel para procurar por.
  • Replacement
    Tipo: System.Object
    A cadeia de caracteres de substituição.
  • MatchCase
    Tipo: System.Object
    true para fazer a pesquisa maiúsculas de minúsculas.
  • MatchByte
    Tipo: System.Object
    Você pode usar esse argumento somente se você selecionou instalado ou suporte de linguagem de dois bytes do excel.true para ter caracteres de byte duplo corresponde apenas caracteres de byte duplo; false para que caracteres de byte duplo corresponder seus equivalentes de byte único.
  • SearchFormat
    Tipo: System.Object
    O formato de pesquisa para o método.
  • ReplaceFormat
    Tipo: System.Object
    O formato para substituir o método.

Valor de retorno

Tipo: System.Boolean
true se os caracteres especificados estão nas células dentro do controle de NamedRange ; caso contrário, false.

Comentários

Usar este método não altera a seleção ou célula ativo.

As configurações para LookAt, SearchOrder, MatchCase, e MatchByte são salvas cada vez que você usa esse método. Se você não especificar valores para esses argumentos na próxima vez que você chama o método, os valores salvos é usado. Definir esses argumentos altera as configurações na caixa de diálogo Localizar , e modificar as configurações na caixa de diálogo Localizar altera os valores salvos que são usados se você omitir argumentos. Para evitar problemas, definir esses argumentos explicitamente cada vez que você usa esse método.

Parâmetros Opcionais

Para obter informações sobre parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

Exemplos

O exemplo de código a seguir define o valor das células em um controle de NamedRange a cadeia de caracteres “Esta é uma sentença.”, e usa o método de Replace para substituir a subcadeia de caracteres “a” com “meu”.

Este exemplo é para uma personalização de um documento nível.

    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);
}

Segurança do .NET Framework

Consulte também

Referência

NamedRange Interface

Namespace Microsoft.Office.Tools.Excel