次の方法で共有


NamedRange.Replace メソッド

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 に検索させる文字列です。
  • MatchCase
    型: System.Object
    検索で大文字と小文字を区別する場合は true です。
  • MatchByte
    型: System.Object
    この引数は、Excel で 2 バイト言語サポートを選択またはインストールした場合のみ使用できます。2 バイト文字を 2 バイト文字にのみ一致させる場合は true。2 バイト文字を、等価な 1 バイト文字に一致させる場合は false。
  • SearchFormat
    型: System.Object
    メソッドの検索形式です。
  • ReplaceFormat
    型: System.Object
    メソッドの置換形式です。

戻り値

型: System.Boolean
指定した文字列が NamedRange コントロール内のセルに含まれている場合は true を返します。それ以外の場合は 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 名前空間