StronglyTypedResourceBuilder.VerifyResourceName Méthode

Définition

Espace de noms:

System.Resources.Tools

Assembly:

System.Windows.Forms.Design.dll

Génère une chaîne de ressource valide selon la chaîne d'entrée et le fournisseur de code spécifiés.

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

Paramètres

key

String

Chaîne à vérifier et, le cas échéant, à convertir en nom de ressource valide.

provider

CodeDomProvider

Objet CodeDomProvider qui spécifie le langage cible à utiliser.

Retours

String

Nom de ressource valide dérivé du paramètre key. Tout jeton non valide est remplacé par le caractère de soulignement (_), ou null si la chaîne dérivée contient encore des caractères non valides en fonction du langage spécifié par le paramètre provider.

Exceptions

ArgumentNullException

key ou provider est null.

Remarques

Si le key paramètre est une chaîne de caractères valide, cette chaîne est retournée. Si le key paramètre est une chaîne non valide ou une chaîne qui contient des caractères non valides, la VerifyResourceName méthode tente de générer une chaîne valide basée sur les key paramètres et provider . Si une chaîne valide peut être générée, cette chaîne est retournée ; dans le cas contraire, null est retourné.

Si le key paramètre est une chaîne vide («  »), une chaîne qui se compose d’un seul caractère de soulignement (_) est retournée. Si le key paramètre n’est pas une chaîne vide, la VerifyResourceName méthode compare chaque caractère de la chaîne à un ensemble de jetons non valides en fonction de la langue spécifiée par le provider paramètre. Tout caractère non valide dans la chaîne est remplacé par un caractère de soulignement. Les caractères qui seront remplacés par un trait de soulignement sont les suivants :

' ' (espace), U+00A0 (espace non cassant), '.' (point), ',' (virgule), ' ;' (point-virgule), '|', '~', '@', '#', '%', '^', '&', '*', '+', '-', '/', '\'<>, '', ' ?', '[', ']', '(', ')', '{', '}', '" » (apostrophe), ' :' et ' !'.

Notes

Les ressources fortement typées n’autorisent pas l’utilisation de mots clés de langue (tels que if, for, etc.) comme noms de clés de ressource. Toutefois, le System.CodeDom modèle de conception permet d’utiliser des mots clés de langue en préfixant le mot clé par le caractère de soulignement. La VerifyResourceName méthode appelle la CreateValidIdentifier méthode pour appliquer cette conception. Par exemple, si vous utilisez un nom de ressource identique à celui d’une langue mot clé, par forexemple , le nom apparaît comme _for dans la classe de ressource fortement typée générée.