StronglyTypedResourceBuilder.VerifyResourceName メソッド

  • リファレンス

定義

名前空間:
System.Resources.Tools
アセンブリ:
System.Design.dll
アセンブリ:
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);
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メソッドは パラメーターと provider パラメーターに基づいて有効な文字列をkey生成しようとします。 有効な文字列を生成できる場合は、その文字列が返されます。それ以外の場合は が null 返されます。

パラメーターが空の key 文字列 ("") の場合は、1 つのアンダースコア文字 (_) で構成される文字列が返されます。 パラメーターが空の key 文字列でない場合、 VerifyResourceName メソッドは、パラメーターで指定された provider 言語に基づいて、文字列内の各文字を無効なトークンのセットと比較します。 文字列内の無効な文字はアンダースコア文字に置き換えられます。 アンダースコアに置き換えられる文字は次のとおりです。

' ' (space)、U+00A0 (改行しないスペース)、'.'(period)、'、' (コンマ)、';'(セミコロン)、'|'、 '~'、'@'、'#'、'%'、'^'、'&'、'*'、'+'、'-'、'/'、''、'<>?'、'['、']'、'('、')、'{'、'}'、'"(quote)、''' (アポストロフィ)、':'、'!

注意

厳密に型指定されたリソースでは、言語キーワード (、、などiffor) をリソース キー名として使用することはできません。 ただし、デザイン パターンではSystem.CodeDom、キーワード (keyword)の前にアンダースコア文字を付けることで、言語キーワードを使用できます。 メソッドは VerifyResourceName メソッドを CreateValidIdentifier 呼び出して、この設計を強制します。 たとえば、 などのfor言語キーワード (keyword)と同じリソース名を使用すると、生成された厳密に型指定されたリソース クラスのように_for名前が表示されます。

適用対象