MaskedTextProvider.InsertAt メソッド

定義

名前空間:

System.ComponentModel

アセンブリ:

System.ComponentModel.TypeConverter.dll

書式設定された文字列内の特定の位置に文字または文字列を挿入します。

オーバーロード

InsertAt(Char, Int32)	書式設定された文字列内の指定した位置に指定した文字を挿入します。
InsertAt(String, Int32)	書式設定された文字列内の指定した位置に指定した文字列を挿入します。
InsertAt(Char, Int32, Int32, MaskedTextResultHint)	書式設定された文字列内の指定した位置に指定した文字を挿入し、最後の挿入位置と操作のステータスを返します。
InsertAt(String, Int32, Int32, MaskedTextResultHint)	書式設定された文字列内の指定した位置に指定した文字列を挿入し、最後の挿入位置と操作のステータスを返します。

InsertAt(Char, Int32)

ソース:

MaskedTextProvider.cs

書式設定された文字列内の指定した位置に指定した文字を挿入します。

public:
 bool InsertAt(char input, int position);

public bool InsertAt (char input, int position);

member this.InsertAt : char * int -> bool

Public Function InsertAt (input As Char, position As Integer) As Boolean

パラメーター

input

Char

挿入する Char です。

position

Int32

文字を挿入する、書式設定された文字列内のインデックス番号が 0 から始まる位置。

戻り値

Boolean

挿入が正常に実行された場合は true。それ以外の場合は false。

注釈

メソッドは InsertAt 、 パラメーターで指定された位置以降の最初の編集位置に文字を pos 挿入します。 このメソッドは、挿入ポイントの後にあるすべての既存の文字を 1 つの位置にシフトして、挿入 input された文字のスペースを作ります。 次のいずれかのエラーが発生した場合、挿入は実行されず、 メソッドは を返します false。

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

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

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

• カーソルの右側に使用可能な位置がないため、既存の文字をシフトできません。

• 既存の文字をシフトすると、マスク違反が発生します。

空 input の文字列では、書式設定された文字列は変更されませんが、 が返 trueされます。

こちらもご覧ください

• Add
• AvailableEditPositionCount
• Mask
• Remove
• Replace
• Set
• ToDisplayString()
• VerifyString

InsertAt(String, Int32)

ソース:

MaskedTextProvider.cs

書式設定された文字列内の指定した位置に指定した文字列を挿入します。

public:
 bool InsertAt(System::String ^ input, int position);

public bool InsertAt (string input, int position);

member this.InsertAt : string * int -> bool

Public Function InsertAt (input As String, position As Integer) As Boolean

パラメーター

input

String

挿入する String です。

position

Int32

入力文字列を挿入する、書式設定された文字列内のインデックス番号が 0 から始まる位置。

戻り値

Boolean

挿入が正常に実行された場合は true。それ以外の場合は false。

例外

ArgumentNullException

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

注釈

メソッドは InsertAt 、文字列から位置以降の input 編集位置に各文字を pos 挿入します。 このメソッドは、挿入ポイントの後にあるすべての既存の文字を、挿入された文字ごとに 1 つの位置にシフトします。 次のいずれかのエラーが発生した場合、挿入は実行されません。メソッドは を返します false。

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

• 文字列からすべての文字を挿入するために、 pos書式設定された文字列内に、指定した位置を超える十分な編集可能な文字が input 存在しません。

• 1 つ以上の挿入文字は、印刷できないか、対応するマスク要素と一致しないため、有効な入力文字ではありません。

• 挿入ポイントの右側に十分な位置がないため、既存の文字をシフトできません。

• 既存の文字をシフトすると、マスク違反が発生します。 このシフトは、個々の文字の挿入中に発生することに注意してください。

空 input の文字列では、書式設定された文字列は変更されませんが、 が返 trueされます。

こちらもご覧ください

• Add
• AvailableEditPositionCount
• Mask
• Remove
• Replace
• Set
• ToDisplayString()
• VerifyString

InsertAt(Char, Int32, Int32, MaskedTextResultHint)

ソース:

MaskedTextProvider.cs

書式設定された文字列内の指定した位置に指定した文字を挿入し、最後の挿入位置と操作のステータスを返します。

public:
 bool InsertAt(char input, int position, [Runtime::InteropServices::Out] int % testPosition, [Runtime::InteropServices::Out] System::ComponentModel::MaskedTextResultHint % resultHint);

public bool InsertAt (char input, int position, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);

member this.InsertAt : char * int * int * MaskedTextResultHint -> bool

Public Function InsertAt (input As Char, position As Integer, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean

パラメーター

input

Char

挿入する Char です。

position

Int32

文字を挿入する、書式設定された文字列内のインデックス番号が 0 から始まる位置。

testPosition

Int32

メソッドが正常に実行された場合は、文字が挿入された最後の位置。それ以外の場合は、挿入が失敗した最初の位置。 出力パラメーター。

resultHint

MaskedTextResultHint

挿入操作の結果を簡潔に示す MaskedTextResultHint。 出力パラメーター。

戻り値

Boolean

挿入が正常に実行された場合は true。それ以外の場合は false。

注釈

メソッドは InsertAt 、 パラメーターで指定された位置以降の最初の編集位置に文字を pos 挿入します。 このメソッドは、挿入ポイントの後にあるすべての既存の文字を 1 つの位置にシフトして、挿入 input された文字のスペースを作ります。 次のいずれかのエラーが発生した場合、挿入は実行されず、 メソッドは を返します false。

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

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

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

• カーソルの右側に使用可能な位置がないため、既存の文字をシフトできません。

• 既存の文字をシフトすると、マスク違反が発生します。

空 input の文字列では、書式設定された文字列は変更されませんが、 が返 trueされます。

こちらもご覧ください

• Add
• AvailableEditPositionCount
• Mask
• Remove
• Replace
• Set
• ToDisplayString()
• VerifyString

InsertAt(String, Int32, Int32, MaskedTextResultHint)

ソース:

MaskedTextProvider.cs

書式設定された文字列内の指定した位置に指定した文字列を挿入し、最後の挿入位置と操作のステータスを返します。

public:
 bool InsertAt(System::String ^ input, int position, [Runtime::InteropServices::Out] int % testPosition, [Runtime::InteropServices::Out] System::ComponentModel::MaskedTextResultHint % resultHint);

public bool InsertAt (string input, int position, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);

member this.InsertAt : string * int * int * MaskedTextResultHint -> bool

Public Function InsertAt (input As String, position As Integer, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean

パラメーター

input

String

挿入する String です。

position

Int32

入力文字列を挿入する、書式設定された文字列内のインデックス番号が 0 から始まる位置。

testPosition

Int32

メソッドが正常に実行された場合は、文字が挿入された最後の位置。それ以外の場合は、挿入が失敗した最初の位置。 出力パラメーター。

resultHint

MaskedTextResultHint

挿入操作の結果を簡潔に示す MaskedTextResultHint。 出力パラメーター。

戻り値

Boolean

挿入が正常に実行された場合は true。それ以外の場合は false。

例外

ArgumentNullException

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

注釈

メソッドは InsertAt 、文字列から位置以降の input 編集位置に各文字を pos 挿入します。 このメソッドは、挿入ポイントの後にあるすべての既存の文字を、挿入された文字ごとに 1 つの位置にシフトします。 次のいずれかのエラーが発生した場合、挿入は実行されません。メソッドは を返します false。

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

• 文字列からすべての文字を挿入するために、 pos書式設定された文字列内に、指定した位置を超える十分な編集可能な文字が input 存在しません。

• 1 つ以上の挿入文字は、印刷できないか、対応するマスク要素と一致しないため、有効な入力文字ではありません。

• 挿入ポイントの右側に十分な位置がないため、既存の文字をシフトできません。

• 既存の文字をシフトすると、マスク違反が発生します。 このシフトは、個々の文字の挿入中に発生することに注意してください。

空 input の文字列では、書式設定された文字列は変更されませんが、 が返 trueされます。

こちらもご覧ください

• Add
• AvailableEditPositionCount
• Mask
• Remove
• Replace
• Set
• ToDisplayString()
• VerifyString