XmlMappedRange.Replace(Object, Object, Object, Object, Object, Object, Object, Object) Método

Definição

Substitui os caracteres especificados no controle XmlMappedRange por uma nova cadeia de caracteres.

public bool Replace (object What, object Replacement, object LookAt, object SearchOrder, object MatchCase, object MatchByte, object SearchFormat, object ReplaceFormat);

Parâmetros

What
Object

A cadeia de caracteres que você deseja que o Microsoft Office Excel pesquise.

Replacement
Object

A cadeia de caracteres substituta.

LookAt
Object

Pode ser uma das seguintes constantes XlLookAt: xlWhole ou xlPart.

SearchOrder
Object

Pode ser uma das seguintes constantes XlSearchOrder: xlByRows ou xlByColumns.

MatchCase
Object

true para fazer com que a pesquisa diferencie maiúsculas de minúsculas.

MatchByte
Object

Você poderá usar esse argumento apenas se tiver selecionado ou instalado o suporte ao idioma de byte duplo no Excel. true para ter caracteres de byte duplo correspondentes apenas a caracteres de byte duplo; false para ter caracteres de byte duplo correspondentes a equivalentes de byte único.

SearchFormat
Object

O formato de pesquisa para o método.

ReplaceFormat
Object

O formato de substituição para o método.

Retornos

Boolean

true se os caracteres especificados estiverem no controle XmlMappedRange; caso contrário, false.

Exemplos

O exemplo de código a seguir usa o Replace método para substituir a cadeia de caracteres "Smith" pela cadeia de caracteres "Jones" em um XmlMappedRange . Este exemplo de código pressupõe que a planilha atual contenha um XmlMappedRange chamado CustomerLastNameCell.

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

Comentários

O uso desse método não altera a seleção ou a célula ativa.

As configurações para LookAt , SearchOrder , e MatchCase 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 em que chamar o método, os valores salvos serão usados. Definir esses argumentos altera as configurações na caixa de diálogo Localizar e alterar as configurações na caixa de diálogo Localizar altera os valores salvos que serão usados se você omitir os argumentos. Para evitar problemas, defina estes argumentos explicitamente sempre que usar esse método.

Parâmetros opcionais

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

Aplica-se a