Strings.Replace メソッド

.NET Framework クラス ライブラリ リファレンス

Strings.Replace メソッド

文字列内の指定の部分文字列が別の文字列によって指定された回数だけ置換されている文字列を返します。

名前空間: Microsoft.VisualBasic
アセンブリ: Microsoft.VisualBasic (microsoft.visualbasic.dll 内)
構文

Visual Basic (宣言)

Public Shared Function Replace
 ( _
    Expression As String, _
    Find As String, _
    Replacement As String, _
    <OptionalAttribute> Optional Start As
 Integer = 1, _
    <OptionalAttribute> Optional Count As
 Integer = -1, _
    <OptionalAttribute> Optional Compare As
 CompareMethod = CompareMethod.Binary _
) As String

Visual Basic (使用法)

Dim Expression As String
Dim Find As String
Dim Replacement As String
Dim Start As Integer
Dim Count As Integer
Dim Compare As CompareMethod
Dim returnValue As String

returnValue = Strings.Replace(Expression, Find, Replacement, Start, Count, Compare)

C#

public static string Replace
 (
    string Expression,
    string Find,
    string Replacement,
    [OptionalAttribute] int Start,
    [OptionalAttribute] int Count,
    [OptionalAttribute] CompareMethod Compare
)

C++

public:
static String^ Replace (
    String^ Expression, 
    String^ Find, 
    String^ Replacement, 
    [OptionalAttribute] int Start, 
    [OptionalAttribute] int Count, 
    [OptionalAttribute] CompareMethod Compare
)

J#

public static String Replace (
    String Expression, 
    String Find, 
    String Replacement, 
    /** @attribute OptionalAttribute() */ int Start, 
    /** @attribute OptionalAttribute() */ int Count, 
    /** @attribute OptionalAttribute() */ CompareMethod Compare
)

JScript

public static function Replace
 (
    Expression : String, 
    Find : String, 
    Replacement : String, 
    Start : int, 
    Count : int, 
    Compare : CompareMethod
) : String

パラメータ

Expression

必須。置換する部分文字列を含む文字列式。

Find

必須。検索する部分文字列。

Replacement

必須。置換する部分文字列。

Start

省略可能。部分文字列の検索を開始する Expression 内の位置。省略した場合、1 が使用されます。

Count

省略可能。置換する部分文字列の数。省略した場合は、既定値の –1 が使用され、すべての候補が置換されます。

Compare

省略可能。部分文字列を評価する場合に使用する比較の種類を示す数値。値については、「設定」を参照してください。

戻り値
Find が長さ 0 の場合または Nothing の場合は、Expression のコピーが返されます。Replace が長さ 0 の場合は、Find が出現しない Expression のコピーが返されます。Expression が長さ 0 の場合または Nothing の場合、または Start の値が Expression の長さよりも長い場合は、Nothing が返されます。Count が 0 の場合は、Expression のコピーが返されます。

解説

詳細については、Visual Basic のトピック「Replace 関数 (Visual Basic)」を参照してください。

Replace 関数の戻り値は、Start によって指定された位置から Expression 文字列の末尾までの文字列です。Find 値および Replace 値を指定すると置換が行われます。

Compare 引数の設定値は次のとおりです。

定数	説明
Binary	バイナリ比較を実行します。
Text	テキスト比較を実行します。

使用例

Replace 関数の使用例を次に示します。

Dim TestString As String = "Shopping List"
' Returns "Shipping List".
Dim aString As String = Replace(TestString, "o", "i")

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
Strings クラス
Strings メンバ
Microsoft.VisualBasic 名前空間
ArgumentException
その他の技術情報
Replace 関数 (Visual Basic)
文字列操作の概要
Filter 関数 (Visual Basic)