StronglyTypedResourceBuilder.VerifyResourceName 方法

定義

命名空間:

System.Resources.Tools

組件:

System.Windows.Forms.Design.dll

根據指定的輸入字串和程式碼提供者，產生有效的資源字串。

public:
 static System::String ^ VerifyResourceName(System::String ^ key, System::CodeDom::Compiler::CodeDomProvider ^ provider);

public static string VerifyResourceName (string key, System.CodeDom.Compiler.CodeDomProvider provider);

static member VerifyResourceName : string * System.CodeDom.Compiler.CodeDomProvider -> string

Public Shared Function VerifyResourceName (key As String, provider As CodeDomProvider) As String

參數

key

String

要驗證的字串，並且在必要時，轉換為有效的資源名稱。

provider

CodeDomProvider

CodeDomProvider 物件，其指定要使用的目標語言。

傳回

String

衍生自 key 參數的有效資源名稱。 任何有效的資源名稱都會以底線 (_) 字元取代，但如果根據 provider 參數指定的語言，衍生的字串仍包含無效的字元，則為 null。

例外狀況

ArgumentNullException

key 或 provider 為 null。

備註

key如果 參數是字元的有效字串，則會傳回該字串。 key如果參數是無效字串或包含無效字元的字串，則VerifyResourceName方法會嘗試根據 key 和 provider 參數產生有效的字串。 如果可以產生有效的字串，則會傳回該字串;否則會 null 傳回 。

key如果參數是空字串 (“”) ，則會傳回由單一底線字元 (_) 所组成的字符串。 key如果參數不是空字串，方法會VerifyResourceName根據 參數指定的provider語言，比較字串中的每個字元與一組無效的標記。 字串中的任何無效字元會取代為底線字元。 將取代為底線的字元如下所示：

' (space) ， U+00A0 (non-break space) ， '.' (period) ， '，'，' (逗號) ， ';' (分號) ， '|'， '~'， '@'， '#'， '%'， '^'、'&'、'*'、'+'、'-'、'/'、'\<>'、''、'？'、'['、']'、' ('、') '、'{'、'}'、'“' (引號) ) 、''' (、'：' 和 '！'。

注意

強型別資源不允許使用語言關鍵詞， (例如 if、 for等) 作為資源索引鍵名稱。 不過，設計 System.CodeDom 模式允許使用語言關鍵詞，方法是在關鍵詞前面加上底線字元。 方法 VerifyResourceName 會 CreateValidIdentifier 呼叫 方法來強制執行此設計。 例如，如果您使用與語言關鍵詞相同的資源名稱，例如 for，則名稱會出現在 _for 產生的強類型資源類別中。