MaskedTextProvider.Replace メソッド

定義

名前空間:

System.ComponentModel

アセンブリ:

System.ComponentModel.TypeConverter.dll

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

オーバーロード

Replace(String, Int32, Int32, Int32, MaskedTextResultHint)	指定した開始位置と終了位置の間にある編集可能な文字の範囲を指定した文字列に置き換え、削除位置と説明の情報を出力します。
Replace(Char, Int32, Int32, Int32, MaskedTextResultHint)	指定した開始位置と終了位置の間にある単一の文字を指定した文字値に置き換え、削除位置と説明の情報を出力します。
Replace(String, Int32, Int32, MaskedTextResultHint)	指定した位置から始まる編集可能な文字の範囲を指定した文字列に置き換え、削除位置と説明の情報を出力します。
Replace(Char, Int32, Int32, MaskedTextResultHint)	指定した位置以降にある単一の文字を指定した文字値に置き換え、削除位置と説明の情報を出力します。
Replace(String, Int32)	指定した位置から始まる編集可能な文字の範囲を、指定した文字列に置き換えます。
Replace(Char, Int32)	指定した位置以降にある単一の文字を指定した文字値に置き換えます。

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

ソース:

MaskedTextProvider.cs

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

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。 出力パラメーター。

戻り値

Boolean

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

注釈

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

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

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

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

• 置換文字値の 1 つは、印刷可能でないか、対応するマスク要素と一致しないため、無効です。

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

こちらもご覧ください

• IsValidInputChar(Char)
• Add
• Clear
• InsertAt
• Remove
• RemoveAt
• Set

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

ソース:

MaskedTextProvider.cs

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

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。 出力パラメーター。

戻り値

Boolean

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

注釈

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

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

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

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

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

こちらもご覧ください

• IsValidInputChar(Char)
• Add
• Clear
• InsertAt
• Remove
• RemoveAt
• Set

Replace(String, Int32, Int32, MaskedTextResultHint)

ソース:

MaskedTextProvider.cs

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

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。 出力パラメーター。

戻り値

Boolean

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

注釈

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

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

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

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

• 置換文字値の 1 つは、印刷可能でないか、対応するマスク要素と一致しないため、無効です。

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

こちらもご覧ください

• IsValidInputChar(Char)
• Add
• Clear
• InsertAt
• Remove
• RemoveAt
• Set

Replace(Char, Int32, Int32, MaskedTextResultHint)

ソース:

MaskedTextProvider.cs

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

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。 出力パラメーター。

戻り値

Boolean

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

注釈

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

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

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

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

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

こちらもご覧ください

• IsValidInputChar(Char)
• Add
• Clear
• InsertAt
• Remove
• RemoveAt
• Set

Replace(String, Int32)

ソース:

MaskedTextProvider.cs

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

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 から始まる位置。

戻り値

Boolean

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

例外

ArgumentNullException

input パラメーターが null です。

注釈

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

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

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

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

• 置換文字値の 1 つは、印刷可能でないか、対応するマスク要素と一致しないため、無効です。

こちらもご覧ください

• IsValidInputChar(Char)
• Add
• Clear
• InsertAt
• Remove
• RemoveAt
• Set

Replace(Char, Int32)

ソース:

MaskedTextProvider.cs

指定した位置以降にある単一の文字を指定した文字値に置き換えます。

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 から始まる位置。

戻り値

Boolean

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

注釈

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

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

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

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

こちらもご覧ください

• IsValidInputChar(Char)
• FindEditPositionFrom(Int32, Boolean)
• Add
• Clear
• InsertAt
• Remove
• RemoveAt
• Set