Поделиться через

NamedRange.Replace Метод (2007 System)

  • Статья

Обновлен: Ноябрь 2007

Заменяет указанные символы в элементе управления NamedRange на новую строку.

Пространство имен:  Microsoft.Office.Tools.Excel
Сборка:  Microsoft.Office.Tools.Excel.v9.0 (в Microsoft.Office.Tools.Excel.v9.0.dll)

Синтаксис

'Декларация
Public 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
'Применение
Dim instance As NamedRange
Dim What As Object
Dim Replacement As Object
Dim LookAt As Object
Dim SearchOrder As Object
Dim MatchCase As Object
Dim MatchByte As Object
Dim SearchFormat As Object
Dim ReplaceFormat As Object
Dim returnValue As Boolean

returnValue = instance.Replace(What, Replacement, _
    LookAt, SearchOrder, MatchCase, MatchByte, _
    SearchFormat, ReplaceFormat)

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

Параметры

  • What
    Тип: System.Object
    Строка, которую должно искать приложение Microsoft Office Excel.
  • Replacement
    Тип: System.Object
    Замещаемая строка.
  • MatchCase
    Тип: System.Object
    Значение true, чтобы при поиске учитывался регистр.
  • MatchByte
    Тип: System.Object
    Этот аргумент можно использовать, если только в Excel выбрана или установлена поддержка двухбайтовых символов языка. Значение true, чтобы соответствие двухбайтных символов определялось только на двухбайтовых символах; значение false, чтобы двухбайтовые символы соответствовали своим однобайтовым эквивалентам.
  • SearchFormat
    Тип: System.Object
    Формат поиска для метода.
  • ReplaceFormat
    Тип: System.Object
    Формат замены для метода.

Возвращаемое значение

Тип: System.Boolean
Значение true, если указанные символы находятся в ячейках внутри элемента управления NamedRange; в противном случае — значение false.

Заметки

Использование этого метода не изменяет выделенный фрагмент или активную ячейку.

Параметры для LookAt, SearchOrder, MatchCase и MatchByte сохраняются каждый раз при использовании этого метода. Если не задать значения этих аргументов, при следующем вызове данного метода будут использоваться сохраненные значения. Задание этих аргументов изменяет параметры в диалоговом окне Найти, а изменение параметров в диалоговом окне Найти изменяет сохраненные значения, которые используются, если аргументы не указываются. Во избежание проблем при каждом использовании данного метода задавайте эти аргументы явно.

Необязательные параметры

Сведения о необязательных параметрах см. в разделе Общие сведения о необязательных параметрах в решениях Office.

Примеры

В следующем примере кода для ячеек в элементе управления NamedRange задается значение "This is a sentence.", после чего используется метод Replace для замены подстроки "a" на "my".

В этом примере демонстрируется настройка уровня документа.

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

Разрешения

См. также

Ссылки

NamedRange Класс

NamedRange - члены

Microsoft.Office.Tools.Excel - пространство имен