CodeDomProvider.CreateValidIdentifier(String) 方法

定義

命名空間:

System.CodeDom.Compiler

組件:

System.CodeDom.dll

套件:

System.CodeDom v8.0.0

來源:

CodeDomProvider.cs

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

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

要產生有效識別項的字串。

傳回

String

指定值的有效識別項。

例外狀況

NotImplementedException

此方法或 CreateGenerator() 方法都沒有在衍生類別中覆寫。

備註

CreateValidIdentifier 會測試標識碼是否與保留或語言關鍵詞衝突，如果是，則嘗試傳回不衝突的有效標識符名稱。 通常傳回的標識碼只會稍微修改，以區分標識符與 關鍵詞;例如，名稱前面可能會加上底線 (“_”) 字元。

注意

在 .NET Framework 1.0 和 1.1 版中，這個方法是由ICodeGenerator提供者的 方法傳CreateGenerator回的 實作所提供。 在 2.0 版中，即使程式代碼提供者未覆寫此方法，也可以直接在程式代碼提供者上呼叫此方法。 如果程式代碼提供者未覆寫這個方法， ICodeGenerator 基類會呼叫 實作。

給繼承者的注意事項

如果您覆寫這個方法，則不得呼叫基類的對應方法。 基類方法會在衍生類別中使用過時 CreateGenerator() 的 方法來建立產生器，以便與使用程式代碼產生器的預先存在提供者相容。 基類方法接著會呼叫 實作中的 ICodeGenerator 對等方法，以執行此函式。 如果您從不使用程式代碼產生器的程式代碼提供者呼叫基類方法，您將會收到 NotImplementedException 。