Método NamedRange.Replace

  • Artigo

Substitui os caracteres especificados no NamedRange o controle com uma nova seqüência 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 seqüência de caracteres que você quer que o Excel de Microsoft Office para pesquisar.
  • Replacement
    Tipo: System.Object
    A seqüência de caracteres de substituição.
  • MatchCase
    Tipo: System.Object
    true Para fazer a pesquisa diferencia maiúsculas de minúsculas.
  • MatchByte
    Tipo: System.Object
    Você pode usar esse argumento somente se você selecionou ou instalou o suporte a idiomas de byte duplo no Excel.truepara assegurar que os caracteres de byte duplo coincida somente caracteres de byte duplo; falsepara que os caracteres de dois bytes coincidam com seus equivalentes de byte único.
  • SearchFormat
    Tipo: System.Object
    O formato de pesquisa para o método.
  • ReplaceFormat
    Tipo: System.Object
    O formato de substituição do método.

Valor de retorno

Tipo: System.Boolean
true Se os caracteres especificados estiverem em células dentro do NamedRange controle; Caso contrário, false.

Comentários

Usando esse método não altera a seleção ou a célula ativa.

As configurações de LookAt, SearchOrder, MatchCase, e MatchByte são salvas toda vez que você pode usar este método. Se você não especificar valores para esses argumentos na próxima vez que você chamar o método, os valores salvos são usados. A definição desses argumentos altera as definições a Localizar caixa de diálogo e alterar as configurações na Localizar caixa de diálogo altera os valores salvos que são usados se você omitir os argumentos. Para evitar problemas, defina explicitamente esses argumentos toda vez que você usar esse método.

Optional Parameters

Para obter informações sobre os 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 uma NamedRange controle para a seqüência de caracteres "é uma sentença."e usa o Replace método para substituir a subseqüência"um" with "my".

Este exemplo é para uma personalização em nível de 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);
}

Segurança do .NET Framework

Consulte também

Referência

NamedRange Interface

Namespace Microsoft.Office.Tools.Excel