CodeDomProvider.CreateValidIdentifier(String) 方法

定義

為指定值建立有效的識別碼。

public:
 virtual System::String ^ CreateValidIdentifier(System::String ^ value);
public virtual string CreateValidIdentifier(string value);
abstract member CreateValidIdentifier : string -> string
override this.CreateValidIdentifier : string -> string
Public Overridable Function CreateValidIdentifier (value As String) As String

參數

value
String

產生有效識別碼的字串。

傳回

指定值的有效識別碼。

例外狀況

此方法與該 CreateGenerator() 方法在衍生類別中均未被覆寫。

備註

CreateValidIdentifier 測試識別碼是否與保留或語言關鍵字衝突,若有,則嘗試回傳一個不衝突的有效識別碼名稱。 通常回傳的識別碼只會做些微修改,以區分識別碼與關鍵字;例如,名稱前可能會加上底線(「_」)字元。

Note

在 .NET Framework 1.0 和 1.1 版本中,此方法由提供者的 CreateGenerator 方法回傳的 ICodeGenerator 實作提供。 在 2.0 版本中,即使程式碼提供者未覆蓋此方法,也能直接呼叫此方法。 若程式碼提供者未覆寫此方法,基底類別會呼叫實 ICodeGenerator 作。

給繼承者的注意事項

如果你覆寫此方法,則不得呼叫基底類別對應的方法。 基底類別方法在衍生類別中使用過時 CreateGenerator() 的方法建立產生器,以與使用程式碼產生器的既有提供者相容。 基底類別方法接著呼叫實作中的 ICodeGenerator 對應方法來執行此函式。 如果你從不使用程式碼產生器的程式碼提供者呼叫基底類方法,你會得到一個NotImplementedException

適用於