CodeDomProvider.CreateValidIdentifier(String) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
為指定值建立有效的識別碼。
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