MaskedTextProvider.Replace 方法

定義

命名空間:

System.ComponentModel

組件:

System.ComponentModel.TypeConverter.dll

將格式化字串中的一或多個可編輯字元取代成指定字元。

多載

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

格式化字串中要開始取代之以零起始的位置。

endPosition

Int32

格式化字串中要結束取代之以零起始的位置。

testPosition

Int32

如果成功，則會是格式化字串中實際取代最後一個字元的以零起始的位置，否則，會是作業失敗的第一個位置。 輸出參數。

resultHint

MaskedTextResultHint

MaskedTextResultHint，簡潔描述取代作業的結果。 輸出參數。

傳回

Boolean

如果成功取代所有字元，則為 true，否則為 false。

備註

方法 Replace 會在指定的開始和結束位置之間，搜尋格式化字串中的第一個可編輯位置。 根據假設在這個點之後有足夠的可編輯位置，現有的字元值會逐一取代為取代字串參數 input的內容。

下列條件會被視為錯誤。 發生錯誤時，不會發生任何取代，並 Replace 傳 false回 。

• startPos或 endPos 參數會指向格式化字串的開頭或超出其結尾。

• 格式化字串中沒有足夠的可編輯位置，無法儲存取代字串的內容。

• 其中一個取代字元值無效，因為它無法列印或不符合其對應的mask元素。

除了傳回值之外，這個方法還有兩個輸出參數，可提供替代作業的其他資訊。

另請參閱

• 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

格式化字串中要開始取代之以零起始的位置。

endPosition

Int32

格式化字串中要結束取代之以零起始的位置。

testPosition

Int32

如果成功，則會是格式化字串中實際取代最後一個字元的以零起始的位置，否則，會是作業失敗的第一個位置。 輸出參數。

resultHint

MaskedTextResultHint

MaskedTextResultHint，簡潔描述取代作業的結果。 輸出參數。

傳回

Boolean

如果成功取代字元，則為 true，否則為 false。

備註

方法 Replace(Char, Int32, Int32, Int32, MaskedTextResultHint) 會在指定的開始和結束位置之間，搜尋格式化字串中的第一個可編輯位置。 如果找到一個，則可編輯位置的值會變更為指定的字元 input。 下列任何條件都會導致錯誤狀況導致不執行任何取代，並傳回 的值 false ：

• startPos或 endPos 參數會指向格式化字串的開頭或超出其結尾。

• 在指定的間隔中找不到可編輯的字元。

• 取代字元 不是有效的輸入字元 input，因為它無法列印或不符合其對應的mask元素。

除了傳回值之外，這個方法還有兩個輸出參數，可提供替代作業的其他資訊。

另請參閱

• 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

搜尋第一個可編輯的字元並加以取代的以零起始的位置。

testPosition

Int32

如果成功，則會是格式化字串中實際取代最後一個字元的以零起始的位置，否則，會是作業失敗的第一個位置。 輸出參數。

resultHint

MaskedTextResultHint

MaskedTextResultHint，簡潔描述取代作業的結果。 輸出參數。

傳回

Boolean

如果成功取代所有字元，則為 true，否則為 false。

備註

方法Replace(String, Int32, Int32, MaskedTextResultHint)會搜尋位於指定位置或超過指定位置的第一個可編輯位置。 pos 根據假設在這個點之後有足夠的可編輯位置，現有的字元值會逐一取代為取代字串參數 input的內容。

下列條件會被視為錯誤。 發生錯誤時，不會發生任何取代，並 Replace(String, Int32, Int32, MaskedTextResultHint) 傳 false回 。

• 參數 pos 小於零或大於 Length 格式化字串的 。

• 格式化字串中沒有足夠的可編輯位置，無法儲存取代字串的內容。

• 其中一個取代字元值無效，因為它無法列印或不符合其對應的mask元素。

除了傳回值之外，這個方法還有兩個輸出參數，可提供替代作業的其他資訊。

另請參閱

• 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

搜尋第一個可編輯的字元並加以取代的以零起始的位置。

testPosition

Int32

如果成功，則會是格式化字串中實際取代最後一個字元的以零起始的位置，否則，會是作業失敗的第一個位置。 輸出參數。

resultHint

MaskedTextResultHint

MaskedTextResultHint，簡潔描述取代作業的結果。 輸出參數。

傳回

Boolean

如果成功取代字元，則為 true，否則為 false。

備註

方法Replace(Char, Int32, Int32, MaskedTextResultHint)會搜尋格式化字串中第一個可編輯的位置，位於或超過指定的位置。 pos 如果找到一個，則可編輯位置的值會變更為指定的字元 input。 下列任何條件都會導致錯誤狀況導致不執行任何取代，並傳回 的值 false ：

• 參數 pos 小於零或大於 Length 格式化字串的 。

• 在格式字串中找不到可編輯的字元，位於或超過指定的位置 pos。

• 取代字元 不是有效的輸入字元 input，因為它無法列印或不符合其對應的mask元素。

除了傳回值之外，這個方法還有兩個輸出參數，可提供替代作業的其他資訊。

另請參閱

• 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

搜尋第一個可編輯的字元並加以取代的以零起始的位置。

傳回

Boolean

如果成功取代所有字元，則為 true，否則為 false。

例外狀況

ArgumentNullException

input 參數為 null。

備註

方法Replace(String, Int32)會搜尋位於指定位置或超過指定位置的第一個可編輯位置。 pos 根據假設在這個點之後有足夠的可編輯位置，現有的字元值會逐一取代為取代字串參數的內容。 input

下列條件會被視為錯誤。 發生錯誤時，不會發生任何取代，並 Replace(String, Int32) 傳 false回 。

• 參數 pos 小於零或大於 Length 格式化字串的 。

• 格式化字串中沒有足夠的可編輯位置，無法儲存取代字串的內容。

• 其中一個取代字元值無效，因為它無法列印或不符合其對應的mask元素。

另請參閱

• 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

搜尋第一個可編輯的字元並加以取代的以零起始的位置。

傳回

Boolean

如果成功取代字元，則為 true，否則為 false。

備註

方法Replace(Char, Int32)會搜尋格式化字串中第一個可編輯的位置，位於或超過指定的位置。 pos 如果找到一個，則可編輯位置的值會變更為指定的字元 input。 下列任何條件都會導致錯誤，導致不執行任何取代，並傳回 的值 false ：

• 參數 pos 小於零或大於 Length 格式化字串的 。

• 在格式字串中找不到可編輯的字元，位於或超過指定的位置 pos。

• 取代字元 不是有效的輸入字元 input，因為它無法列印或不符合其對應的mask元素。

另請參閱

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