MaskedTextProvider.ToString 方法

定義

命名空間:

System.ComponentModel

組件:

System.ComponentModel.TypeConverter.dll

傳回格式化字串。

多載

ToString(Boolean, Boolean, Boolean, Int32, Int32)	傳回格式化字串的子字串，選擇性包含提示、常值和密碼字元。
ToString(Boolean, Boolean, Int32, Int32)	傳回格式化字串的子字串，選擇性包含提示和常值字元。
ToString(Boolean, Int32, Int32)	傳回格式化字串的子字串，選擇性包含密碼字元。
ToString(Boolean)	傳回格式化字串，選擇性包含密碼字元。
ToString(Boolean, Boolean)	傳回格式化字串，選擇性包含提示和常值字元。
ToString()	傳回格式化字串，包含所有指定的字元值。
ToString(Int32, Int32)	傳回格式化字串的子字串。

ToString(Boolean, Boolean, Boolean, Int32, Int32)

來源:

MaskedTextProvider.cs

傳回格式化字串的子字串，選擇性包含提示、常值和密碼字元。

public:
 System::String ^ ToString(bool ignorePasswordChar, bool includePrompt, bool includeLiterals, int startPosition, int length);

public string ToString (bool ignorePasswordChar, bool includePrompt, bool includeLiterals, int startPosition, int length);

override this.ToString : bool * bool * bool * int * int -> string

Public Function ToString (ignorePasswordChar As Boolean, includePrompt As Boolean, includeLiterals As Boolean, startPosition As Integer, length As Integer) As String

參數

ignorePasswordChar

Boolean

true 表示傳回實際的可編輯字元，而 false 則表示接受 PasswordChar 屬性。

includePrompt

Boolean

若要在傳回字串中包含提示字元，則為 true，否則為 false。

includeLiterals

Boolean

若要在傳回字串中傳回常值字元，則為 true，否則為 false。

startPosition

Int32

格式化字串中要開始輸出的以零起始的位置。

length

Int32

要傳回的字元數。

傳回

String

如果成功，則為格式化 String 的子字串，包含所有指定的字元值，而選擇性包含常值、提示和密碼字元，否則為 Empty 字串。

備註

這個版本的多載 ToString 方法會傳回格式化字串的子字串，從位置 startPos 開始，並包含 參數所 length 指定的後續字元數。 傳回字串會分別根據 和 參數的值，包含提示和IncludeLiterals常值IncludePrompt。 請注意，這些參數會覆寫 和 IncludeLiterals 屬性的值IncludePrompt。 ignorePasswordChar如果 參數為 true，則會傳回原始輸入字元，並忽略 屬性的值PasswordChar。 如果此參數為 ，則如果 PasswordChar 屬性設定為 false以外的null值，則會使用密碼字元來遮蔽可編輯的用戶輸入。

重要

因為這個方法可能會顯示通常受密碼字元保護的使用者介面中的資訊，所以應該特別小心使用，以避免意外顯示機密用戶數據。

ToString 當輸入參數不一致時，會執行下列動作：

• 如果 startPos 小於零，則起始位置會設定為零。

• 如果 startPos 大於或等於格式化字串的實際 Length 值，則會 Empty 傳回字串。

• 如果 length 大於超過起始位置的剩餘字元數，則只會傳回剩餘的字元。

• 如果 length 小於或等於零，則會 Empty 傳回字串。

另請參閱

• ToDisplayString()
• Set
• IncludePrompt
• IncludeLiterals
• PasswordChar

ToString(Boolean, Boolean, Int32, Int32)

來源:

MaskedTextProvider.cs

傳回格式化字串的子字串，選擇性包含提示和常值字元。

public:
 System::String ^ ToString(bool includePrompt, bool includeLiterals, int startPosition, int length);

public string ToString (bool includePrompt, bool includeLiterals, int startPosition, int length);

override this.ToString : bool * bool * int * int -> string

Public Function ToString (includePrompt As Boolean, includeLiterals As Boolean, startPosition As Integer, length As Integer) As String

參數

includePrompt

Boolean

若要在傳回字串中包含提示字元，則為 true，否則為 false。

includeLiterals

Boolean

若要在傳回字串中包含常值字元，則為 true，否則為 false。

startPosition

Int32

格式化字串中要開始輸出的以零起始的位置。

length

Int32

要傳回的字元數。

傳回

String

如果成功，則為格式化 String 的子字串，包含所有指定的字元值，而選擇性包含常值和提示，否則為 Empty 字串。

備註

這個版本的多載 ToString 方法會傳回格式化字串的子字串，從位置 startPos 開始，並包含 參數所 length 指定的後續字元數。 傳回字串會分別根據 和 參數的值，包含提示和IncludeLiterals常值IncludePrompt。 請注意，這些參數會覆寫屬性的值 IncludePromptIncludeLiterals 。 這個方法一律會傳回原始輸入字元，忽略 屬性的值 PasswordChar 。

重要

因為這個方法會以密碼字元在使用者介面中顯示通常受到保護的資訊，所以應該特別小心使用，以避免意外顯示敏感數據。

ToString 當輸入參數不一致時，會執行下列動作：

• 如果 startPos 小於零，則起始位置會設定為零。

• 如果 startPos 大於或等於格式化字串的實際 Length 值，則會 Empty 傳回字串。

• 如果 length 大於超過起始位置的剩餘字元數，則只會傳回剩餘的字元。

• 如果 length 小於或等於零，則會 Empty 傳回字串。

另請參閱

• ToDisplayString()
• Set
• IncludePrompt
• IncludeLiterals
• PasswordChar

ToString(Boolean, Int32, Int32)

來源:

MaskedTextProvider.cs

傳回格式化字串的子字串，選擇性包含密碼字元。

public:
 System::String ^ ToString(bool ignorePasswordChar, int startPosition, int length);

public string ToString (bool ignorePasswordChar, int startPosition, int length);

override this.ToString : bool * int * int -> string

Public Function ToString (ignorePasswordChar As Boolean, startPosition As Integer, length As Integer) As String

參數

ignorePasswordChar

Boolean

true 表示傳回實際的可編輯字元，而 false 則表示接受 PasswordChar 屬性。

startPosition

Int32

格式化字串中要開始輸出的以零起始的位置。

length

Int32

要傳回的字元數。

傳回

String

如果成功，則為格式化 String 的子字串，包含常值、提示和選擇性的密碼字元，否則為 Empty 字串。

備註

這個版本的多載 ToString 方法會傳回格式化字串的子字串，從位置 startPos 開始，並包含 參數所 length 指定的後續字元數。 傳回的字串會分別根據 和 屬性的目前值，包含提示和IncludeLiterals常值IncludePrompt。 ignorePasswordChar如果 參數為 true，則會傳回原始輸入字元，並忽略 屬性的值PasswordChar。 如果此參數為 ，則如果 PasswordChar 屬性設定為 false以外的null值，則會使用密碼字元來遮蔽可編輯的用戶輸入。

重要

因為這個方法可能會顯示通常受密碼字元保護的使用者介面中的資訊，所以應該特別小心使用，以避免意外顯示機密用戶數據。

ToString 當輸入參數不一致時，會執行下列動作：

• 如果 startPos 小於零，則起始位置會設定為零。

• 如果 startPos 大於或等於格式化字串的實際 Length 值，則會 Empty 傳回字串。

• 如果 length 大於超過起始位置的剩餘字元數，則只會傳回剩餘的字元。

• 如果 length 小於或等於零，則會 Empty 傳回字串。

另請參閱

• ToDisplayString()
• Set
• IncludePrompt
• IncludeLiterals
• PasswordChar

ToString(Boolean)

來源:

MaskedTextProvider.cs

傳回格式化字串，選擇性包含密碼字元。

public:
 System::String ^ ToString(bool ignorePasswordChar);

public string ToString (bool ignorePasswordChar);

override this.ToString : bool -> string

Public Function ToString (ignorePasswordChar As Boolean) As String

參數

ignorePasswordChar

Boolean

true 表示傳回實際的可編輯字元，而 false 則表示接受 PasswordChar 屬性。

傳回

String

格式化 String，包含常值、提示和選擇性的密碼字元。

備註

這個版本的多載ToString方法會分別根據 和 屬性的目前值，包含提示和IncludeLiterals常值IncludePrompt。 ignorePasswordChar如果 參數為 true，則會傳回原始輸入字元，並忽略 屬性的值PasswordChar。 如果此參數為 ，則如果 PasswordChar 屬性設定為 false以外的null值，則會使用密碼字元來遮蔽可編輯的用戶輸入。

重要

因為這個方法可能會顯示通常受密碼字元保護的使用者介面中的資訊，所以應該特別小心使用，以避免意外顯示機密用戶數據。

另請參閱

• ToDisplayString()
• Set
• IncludePrompt
• IncludeLiterals
• PasswordChar

ToString(Boolean, Boolean)

來源:

MaskedTextProvider.cs

傳回格式化字串，選擇性包含提示和常值字元。

public:
 System::String ^ ToString(bool includePrompt, bool includeLiterals);

public string ToString (bool includePrompt, bool includeLiterals);

override this.ToString : bool * bool -> string

Public Function ToString (includePrompt As Boolean, includeLiterals As Boolean) As String

參數

includePrompt

Boolean

若要在傳回字串中包含提示字元，則為 true，否則為 false。

includeLiterals

Boolean

若要在傳回字串中包含常值字元，則為 true，否則為 false。

傳回

String

格式化 String，包含所有指定的字元值，而選擇性包含常值和提示。

備註

這個版本的多載ToString方法會分別根據 和 參數的值，包含提示和IncludeLiterals常值IncludePrompt。 請注意，這些參數會覆寫屬性的值 IncludePromptIncludeLiterals 。 這個方法一律會傳回原始輸入字元，忽略 屬性的值 PasswordChar 。

重要

因為這個方法會以密碼字元在使用者介面中顯示通常受到保護的資訊，所以應該特別小心使用，以避免意外顯示敏感數據。

另請參閱

• IsAvailablePosition(Int32)
• ToDisplayString()
• Set
• IncludePrompt
• IncludeLiterals
• PasswordChar

ToString()

來源:

MaskedTextProvider.cs

傳回格式化字串，包含所有指定的字元值。

public:
 override System::String ^ ToString();

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

傳回

String

格式化 String，包含所有指定的字元值。

備註

這個版本的多載ToString方法會分別根據 和 屬性的目前值，包含提示和IncludeLiterals常值IncludePrompt。 它一律會傳回原始輸入字元，忽略 屬性的值 PasswordChar 。

重要

因為這個方法會以密碼字元在使用者介面中顯示通常受到保護的資訊，所以應該特別小心使用，以避免意外顯示敏感數據。

另請參閱

• ToDisplayString()
• Set
• IncludePrompt
• IncludeLiterals
• PasswordChar

ToString(Int32, Int32)

來源:

MaskedTextProvider.cs

傳回格式化字串的子字串。

public:
 System::String ^ ToString(int startPosition, int length);

public string ToString (int startPosition, int length);

override this.ToString : int * int -> string

Public Function ToString (startPosition As Integer, length As Integer) As String

參數

startPosition

Int32

格式化字串中要開始輸出的以零起始的位置。

length

Int32

要傳回的字元數。

傳回

String

如果成功，則為格式化 String 的子字串，包含所有指定的字元值，否則為 Empty 字串。

備註

這個版本的多載 ToString 方法會傳回格式化字串的子字串，從位置 startPos 開始，並包含 參數所 length 指定的後續字元數。 傳回的字串會分別根據 和 屬性的目前值，包含提示和IncludeLiterals常值IncludePrompt。 傳回字串將包含原始輸入字元;屬性 PasswordChar 一律會被忽略。

重要

因為這個方法會以密碼字元在使用者介面中顯示通常受到保護的資訊，所以應該特別小心使用，以避免意外顯示敏感數據。

ToString 當輸入參數不一致時，會執行下列動作：

• 如果 startPos 小於零，起始位置會設定為零。

• 如果 startPos 大於或等於格式化字串的實際 Length 值，則會 Empty 傳回字串。

• 如果 length 大於超過開始位置的剩餘字元數，則只會傳回剩餘的字元。

• 如果 length 小於或等於零，則會 Empty 傳回字串。

另請參閱

• ToDisplayString()
• Set
• IncludePrompt
• IncludeLiterals
• PasswordChar