NamedRange.Replace - метод

Статья
08/11/2011

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

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

Синтаксис

'Декларация
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
)

Параметры

What
Тип: System.Object
Строка, которую должно искать приложение Microsoft Office Excel.

Replacement
Тип: System.Object
Строка замены.

LookAt
Тип: System.Object
Может быть одной из следующих констант XlLookAt: xlWhole или xlPart.

SearchOrder
Тип: System.Object
Может быть одной из следующих констант XlSearchOrder: xlByRows или xlByColumns.

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

Безопасность платформы .NET Framework

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

NamedRange Интерфейс

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

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