StronglyTypedResourceBuilder.VerifyResourceName Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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);
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
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
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
, for
e 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.