CodeDomProvider.IsValidIdentifier(String) 方法

定義

命名空間:

System.CodeDom.Compiler

組件:

System.CodeDom.dll

套件:

System.CodeDom v8.0.0

來源:

CodeDomProvider.cs

傳回值，指出指定的值是否為目前語言的有效識別項。

public:
 virtual bool IsValidIdentifier(System::String ^ value);

public virtual bool IsValidIdentifier (string value);

abstract member IsValidIdentifier : string -> bool
override this.IsValidIdentifier : string -> bool

Public Overridable Function IsValidIdentifier (value As String) As Boolean

參數

value

String

要驗證為有效識別項的值。

傳回

Boolean

如果 value 參數是有效的識別項，則為 true，否則為 false。

例外狀況

NotImplementedException

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

備註

這個方法會測試標識碼是否有效。 方法是 IsValidIdentifier 提供者特定的。 對某個提供者有效的標識碼可能不適用於其他提供者。 如果 value 包含 ASCII 字元範圍以外的字元，請檢查可能用來編譯程式代碼之所有語言的識別碼。

注意

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

給繼承者的注意事項

在衍生類別中覆 IsValidIdentifier(String) 寫時，只有在值符合語言規則且與關鍵詞不衝突時，才設計方法以傳回 true 。

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