MaskedTextProvider.Replace メソッド

定義

書式設定された文字列内の 1 つ以上の編集可能な文字を、指定した文字に置き換えます。

オーバーロード

名前 説明
Replace(String, Int32, Int32, Int32, MaskedTextResultHint)

指定した開始位置と終了位置の間の編集可能な文字の範囲を指定した文字列に置き換え、削除位置と説明情報を出力します。

Replace(Char, Int32, Int32, Int32, MaskedTextResultHint)

指定した開始位置と終了位置の間の 1 文字を指定した文字値に置き換え、削除位置と説明情報を出力します。

Replace(String, Int32, Int32, MaskedTextResultHint)

指定した位置から始まる編集可能な文字の範囲を指定した文字列に置き換え、削除位置と説明情報を出力します。

Replace(Char, Int32, Int32, MaskedTextResultHint)

指定した位置以降の 1 文字を指定した文字値に置き換え、削除位置と説明情報を出力します。

Replace(String, Int32)

指定した位置から始まる編集可能な文字の範囲を、指定した文字列に置き換えます。

Replace(Char, Int32)

指定した位置以降の 1 文字を、指定した文字値に置き換えます。

Replace(String, Int32, Int32, Int32, MaskedTextResultHint)

指定した開始位置と終了位置の間の編集可能な文字の範囲を指定した文字列に置き換え、削除位置と説明情報を出力します。

public:
 bool Replace(System::String ^ input, int startPosition, int endPosition, [Runtime::InteropServices::Out] int % testPosition, [Runtime::InteropServices::Out] System::ComponentModel::MaskedTextResultHint % resultHint);
public bool Replace(string input, int startPosition, int endPosition, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);
member this.Replace : string * int * int * int * MaskedTextResultHint -> bool
Public Function Replace (input As String, startPosition As Integer, endPosition As Integer, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean

パラメーター

input
String

既存の編集可能な文字を置き換えるために使用する String 値。

startPosition
Int32

置換が開始される、書式設定された文字列内の 0 から始まる位置。

endPosition
Int32

置換が終了する書式設定された文字列内の 0 から始まる位置。

testPosition
Int32

成功した場合、最後の文字が実際に置き換えられた書式設定された文字列内の 0 から始まる位置。それ以外の場合は、操作が失敗した最初の位置。 出力パラメーター。

resultHint
MaskedTextResultHint

置換操作の結果を簡潔に記述する MaskedTextResultHint 。 出力パラメーター。

返品

true すべての文字が正常に置き換えられた場合。それ以外の場合は false

注釈

Replaceメソッドは、指定した開始位置と終了位置の間の書式設定された文字列内の最初の編集可能な位置を検索します。 この時点より後に十分な編集可能な位置があることを前提として、既存の文字値は 1 つずつ置換文字列パラメーターの内容に置き換 input

次の条件はエラーと見なされます。 エラーが発生した場合、置換は行われず、 Replacefalseを返します。

  • startPosまたはendPosパラメーターは、書式設定された文字列の先頭の前、またはその末尾を超えています。

  • 書式設定された文字列に、置換文字列の内容を保持するのに十分な編集可能な位置がありません。

  • 代替文字値の 1 つは、印刷できないか、対応する mask 要素と一致しないため、無効です。

戻り値に加えて、このメソッドには、置換操作に関する追加情報を提供する 2 つの出力パラメーターがあります。

こちらもご覧ください

適用対象

Replace(Char, Int32, Int32, Int32, MaskedTextResultHint)

指定した開始位置と終了位置の間の 1 文字を指定した文字値に置き換え、削除位置と説明情報を出力します。

public:
 bool Replace(char input, int startPosition, int endPosition, [Runtime::InteropServices::Out] int % testPosition, [Runtime::InteropServices::Out] System::ComponentModel::MaskedTextResultHint % resultHint);
public bool Replace(char input, int startPosition, int endPosition, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);
member this.Replace : char * int * int * int * MaskedTextResultHint -> bool
Public Function Replace (input As Char, startPosition As Integer, endPosition As Integer, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean

パラメーター

input
Char

既存の値を置き換える Char 値。

startPosition
Int32

置換が開始される、書式設定された文字列内の 0 から始まる位置。

endPosition
Int32

置換が終了する書式設定された文字列内の 0 から始まる位置。

testPosition
Int32

成功した場合、最後の文字が実際に置き換えられた書式設定された文字列内の 0 から始まる位置。それ以外の場合は、操作が失敗した最初の位置。 出力パラメーター。

resultHint
MaskedTextResultHint

置換操作の結果を簡潔に記述する MaskedTextResultHint 。 出力パラメーター。

返品

true 文字が正常に置き換えられた場合。それ以外の場合は false

注釈

Replace(Char, Int32, Int32, Int32, MaskedTextResultHint)メソッドは、指定した開始位置と終了位置の間の書式設定された文字列内の最初の編集可能な位置を検索します。 見つかった場合、編集可能な位置の値は、指定した文字 inputに変更されます。 次の条件のいずれかが発生すると、置換が実行されなくなり、 false の値が返されるエラー条件が発生します。

  • startPosまたはendPosパラメーターは、書式設定された文字列の先頭の前、またはその末尾を超えています。

  • 指定した間隔で編集可能な文字が見つかりませんでした。

  • 置換文字 inputは、印刷できないか、対応する mask 要素と一致しないため、有効な入力文字ではありません。

戻り値に加えて、このメソッドには、置換操作に関する追加情報を提供する 2 つの出力パラメーターがあります。

こちらもご覧ください

適用対象

Replace(String, Int32, Int32, MaskedTextResultHint)

指定した位置から始まる編集可能な文字の範囲を指定した文字列に置き換え、削除位置と説明情報を出力します。

public:
 bool Replace(System::String ^ input, int position, [Runtime::InteropServices::Out] int % testPosition, [Runtime::InteropServices::Out] System::ComponentModel::MaskedTextResultHint % resultHint);
public bool Replace(string input, int position, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);
member this.Replace : string * int * int * MaskedTextResultHint -> bool
Public Function Replace (input As String, position As Integer, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean

パラメーター

input
String

既存の編集可能な文字を置き換えるために使用する String 値。

position
Int32

置換する編集可能な最初の文字を検索する 0 から始まる位置。

testPosition
Int32

成功した場合、最後の文字が実際に置き換えられた書式設定された文字列内の 0 から始まる位置。それ以外の場合は、操作が失敗した最初の位置。 出力パラメーター。

resultHint
MaskedTextResultHint

置換操作の結果を簡潔に記述する MaskedTextResultHint 。 出力パラメーター。

返品

true すべての文字が正常に置き換えられた場合。それ以外の場合は false

注釈

Replace(String, Int32, Int32, MaskedTextResultHint)メソッドは、指定した位置を超える最初の編集可能な位置 (pos) を検索します。 この時点より後に十分な編集可能な位置があることを前提として、既存の文字値は 1 つずつ置換文字列パラメーターの内容に置き換 input

次の条件はエラーと見なされます。 エラーが発生した場合、置換は行われず、 Replace(String, Int32, Int32, MaskedTextResultHint)falseを返します。

  • pos パラメーターが 0 未満であるか、書式設定された文字列のLengthより大きい。

  • 書式設定された文字列に、置換文字列の内容を保持するのに十分な編集可能な位置がありません。

  • 代替文字値の 1 つは、印刷できないか、対応する mask 要素と一致しないため、無効です。

戻り値に加えて、このメソッドには、置換操作に関する追加情報を提供する 2 つの出力パラメーターがあります。

こちらもご覧ください

適用対象

Replace(Char, Int32, Int32, MaskedTextResultHint)

指定した位置以降の 1 文字を指定した文字値に置き換え、削除位置と説明情報を出力します。

public:
 bool Replace(char input, int position, [Runtime::InteropServices::Out] int % testPosition, [Runtime::InteropServices::Out] System::ComponentModel::MaskedTextResultHint % resultHint);
public bool Replace(char input, int position, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);
member this.Replace : char * int * int * MaskedTextResultHint -> bool
Public Function Replace (input As Char, position As Integer, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean

パラメーター

input
Char

既存の値を置き換える Char 値。

position
Int32

置換する編集可能な最初の文字を検索する 0 から始まる位置。

testPosition
Int32

成功した場合、最後の文字が実際に置き換えられた書式設定された文字列内の 0 から始まる位置。それ以外の場合は、操作が失敗した最初の位置。 出力パラメーター。

resultHint
MaskedTextResultHint

置換操作の結果を簡潔に記述する MaskedTextResultHint 。 出力パラメーター。

返品

true 文字が正常に置き換えられた場合。それ以外の場合は false

注釈

Replace(Char, Int32, Int32, MaskedTextResultHint)メソッドは、書式設定された文字列内の、指定した位置を超えた位置 (pos) の最初の編集可能な位置を検索します。 見つかった場合、編集可能な位置の値は、指定した文字 inputに変更されます。 次の条件のいずれかが発生すると、置換が実行されなくなり、 false の値が返されるエラー条件が発生します。

  • pos パラメーターが 0 未満であるか、書式設定された文字列のLengthより大きい。

  • 編集可能な文字が、指定した位置( pos)以降の書式設定された文字列に見つかりませんでした。

  • 置換文字 inputは、印刷できないか、対応する mask 要素と一致しないため、有効な入力文字ではありません。

戻り値に加えて、このメソッドには、置換操作に関する追加情報を提供する 2 つの出力パラメーターがあります。

こちらもご覧ください

適用対象

Replace(String, Int32)

指定した位置から始まる編集可能な文字の範囲を、指定した文字列に置き換えます。

public:
 bool Replace(System::String ^ input, int position);
public bool Replace(string input, int position);
member this.Replace : string * int -> bool
Public Function Replace (input As String, position As Integer) As Boolean

パラメーター

input
String

既存の編集可能な文字を置き換えるために使用する String 値。

position
Int32

置換する編集可能な最初の文字を検索する 0 から始まる位置。

返品

true すべての文字が正常に置き換えられた場合。それ以外の場合は false

例外

input パラメーターはnull

注釈

Replace(String, Int32)メソッドは、指定した位置を超える最初の編集可能な位置 (pos) を検索します。 この時点より後に十分な編集可能な位置があることを前提として動作すると、既存の文字値は、置換文字列パラメーターの内容 ( input) に 1 つずつ置き換えられます。

次の条件はエラーと見なされます。 エラーが発生した場合、置換は行われず、 Replace(String, Int32)falseを返します。

  • pos パラメーターが 0 未満であるか、書式設定された文字列のLengthより大きい。

  • 書式設定された文字列に、置換文字列の内容を保持するのに十分な編集可能な位置がありません。

  • 代替文字値の 1 つは、印刷できないか、対応する mask 要素と一致しないため、無効です。

こちらもご覧ください

適用対象

Replace(Char, Int32)

指定した位置以降の 1 文字を、指定した文字値に置き換えます。

public:
 bool Replace(char input, int position);
public bool Replace(char input, int position);
member this.Replace : char * int -> bool
Public Function Replace (input As Char, position As Integer) As Boolean

パラメーター

input
Char

既存の値を置き換える Char 値。

position
Int32

置換する編集可能な最初の文字を検索する 0 から始まる位置。

返品

true 文字が正常に置き換えられた場合。それ以外の場合は false

注釈

Replace(Char, Int32)メソッドは、書式設定された文字列内の、指定した位置を超えた位置 (pos) の最初の編集可能な位置を検索します。 見つかった場合、編集可能な位置の値は、指定した文字 inputに変更されます。 次のいずれかの条件では、置換が実行されないエラーが発生し、 false の値が返されます。

  • pos パラメーターが 0 未満であるか、書式設定された文字列のLengthより大きい。

  • 編集可能な文字が、指定した位置( pos)以降の書式設定された文字列に見つかりませんでした。

  • 置換文字 inputは、印刷できないか、対応する mask 要素と一致しないため、有効な入力文字ではありません。

こちらもご覧ください

適用対象