Método XmlMappedRange.Replace

Artigo
08/01/2011

Substitui os caracteres especificados no XmlMappedRange 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.

LookAt
Tipo: System.Object
Pode ser uma das seguintes XlLookAt constantes: xlWhole or xlPart.

SearchOrder
Tipo: System.Object
Pode ser uma das seguintes XlSearchOrder constantes: xlByRows or xlByColumns.

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 no XmlMappedRange 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 seguinte exemplo de código usa a Replace método para substituir a seqüência de caracteres "Smith" com a seqüência de caracteres "Jorge" dentro de um XmlMappedRange. Este exemplo de código pressupõe que a planilha atual contém um XmlMappedRange chamado CustomerLastNameCell.

Private Sub ReplaceSmith()
    Me.CustomerLastNameCell.Value2 = "Walker, Smith, James"
    Me.CustomerLastNameCell.Replace("Smith", "Jones")
End Sub

private void ReplaceSmith()
{
    this.CustomerLastNameCell.Value2 = "Walker, Smith, James";
    this.CustomerLastNameCell.Replace("Smith", "Jones", missing,
        missing, missing, missing, missing, missing);
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

XmlMappedRange Interface

Namespace Microsoft.Office.Tools.Excel

Partilhar via