StronglyTypedResourceBuilder.VerifyResourceName Método

Definición

Espacio de nombres:

System.Resources.Tools

Ensamblado:

System.Windows.Forms.Design.dll

Genera una cadena de recurso válida tomando como base la cadena de entrada y el proveedor de código especificados.

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

Parámetros

key

String

Cadena que se va a comprobar y, si es necesario, convertir en un nombre de recurso válido.

provider

CodeDomProvider

Objeto CodeDomProvider que especifica el lenguaje de destino que se va a utilizar.

Devoluciones

String

El nombre de recurso válido derivado del parámetro key. Los tokens que no sean válidos se reemplazarán por el carácter de subrayado (_) o null si la cadena derivada todavía contiene caracteres no válidos de acuerdo con el lenguaje especificado por el parámetro provider.

Excepciones

ArgumentNullException

key o provider es null.

Comentarios

Si el key parámetro es una cadena válida de caracteres, se devuelve esa cadena. Si el key parámetro es una cadena no válida o una cadena que contiene caracteres no válidos, el VerifyResourceName método intenta generar una cadena válida basada en los key parámetros y provider . Si se puede generar una cadena válida, se devuelve esa cadena; de lo contrario, null se devuelve .

Si el key parámetro es una cadena vacía (""), se devuelve una cadena que consta de un solo carácter de subrayado (_). Si el key parámetro no es una cadena vacía, el VerifyResourceName método compara cada carácter de la cadena con un conjunto de tokens no válidos según el idioma especificado por el provider parámetro . Cualquier carácter no válido de la cadena se reemplaza por un carácter de subrayado. Los caracteres que se reemplazarán por un carácter de subrayado son los siguientes:

' ' (espacio), U+00A0 (espacio no importante), '.' (punto), ',' (coma), ';' (punto y coma), '|', '~', '@', '#', '%', '^', '&', '*', '+', '-', '/', '\', '', '<', '>?', '[', ']', '(', ')', '{', '}', ''' (cita), ''' (apóstrofo), ':', y '!'.

Nota

Los recursos fuertemente tipados no permiten el uso de palabras clave de lenguaje (como if, for, etc.) como nombres de clave de recurso. Sin embargo, el System.CodeDom patrón de diseño permite el uso de palabras clave de lenguaje mediante el prefijo de la palabra clave con el carácter de subrayado. El VerifyResourceName método llama al CreateValidIdentifier método para aplicar este diseño. Por ejemplo, si usa un nombre de recurso que es el mismo que una palabra clave de lenguaje, como for, el nombre aparece como _for en la clase de recursos fuertemente tipada generada.