StronglyTypedResourceBuilder.VerifyResourceName Método

Definição

Namespace:

System.Resources.Tools

Assembly:

System.Windows.Forms.Design.dll

Gera uma cadeia de caracteres de recurso válida com base na cadeia de caracteres de entrada e no provedor do 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

A cadeia de caracteres a ser verificada e, se necessário, convertida a um nome de recurso válido.

provider

CodeDomProvider

Um objeto CodeDomProvider que especifica a linguagem de destino a ser usada.

Retornos

String

Um nome de recurso válido é derivado do parâmetro key. Tokens inválidos são substituídos pelo caractere de sublinhado (_) ou null se a cadeia de caracteres derivada ainda contiver caracteres inválidos de acordo com a linguagem especificada pelo parâmetro provider.

Exceções

ArgumentNullException

key ou provider é null.

Comentários

Se o key parâmetro for uma cadeia de caracteres válida, essa cadeia de caracteres será retornada. Se o key parâmetro for uma cadeia de caracteres inválida ou uma cadeia de caracteres que contém caracteres inválidos, o VerifyResourceName método tentará gerar uma cadeia de caracteres válida com base nos key parâmetros e provider . Se uma cadeia de caracteres válida puder ser gerada, essa cadeia de caracteres será retornada; caso contrário, null será retornado.

Se o key parâmetro for uma cadeia de caracteres vazia (""), uma cadeia de caracteres que consiste em um único caractere de sublinhado (_) será retornada. Se o key parâmetro não for uma cadeia de caracteres vazia, o VerifyResourceName método comparará cada caractere na cadeia de caracteres com um conjunto de tokens inválidos com base no idioma especificado pelo provider parâmetro . Qualquer caractere inválido na cadeia de caracteres é substituído por um caractere de sublinhado. Os caracteres que serão substituídos por um sublinhado são os seguintes:

' ' (espaço), U+00A0 (espaço sem interrupção), '.' (ponto final), ',' (vírgula), ';' (ponto e vírgula), '|', '~', '@', '#', '%', '^', '&', '*', '+', '-', '/', '\', '<', '>', '?', '[', ']', '(', ')', '{', '}', '"' (citação), ''' (apóstrofo), ':' e '!'.

Observação

Recursos fortemente tipados não permitem o uso de palavras-chave de linguagem (como if, fore assim por diante) como nomes de chave de recurso. No entanto, o System.CodeDom padrão de design permite o uso de palavras-chave de linguagem prefixando o palavra-chave com o caractere sublinhado. O VerifyResourceName método chama o CreateValidIdentifier método para impor esse design. Por exemplo, se você usar um nome de recurso igual a um idioma palavra-chave, como for, o nome aparecerá como _for na classe de recurso fortemente tipada gerada.