StronglyTypedResourceBuilder.VerifyResourceName Metodo

Definizione

Spazio dei nomi:

System.Resources.Tools

Assembly:

System.Windows.Forms.Design.dll

Genera una stringa di risorsa valida in base alla stringa di input specificata e al provider di codice.

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

Parametri

key

String

La stringa da verificare e, se necessario, da convertire in un nome di risorsa valido.

provider

CodeDomProvider

Oggetto CodeDomProvider che specifica la lingua di destinazione da utilizzare.

Restituisce

String

Nome di risorsa valido derivato dal parametro key. Tutti i token non validi vengono sostituiti dal carattere di sottolineatura (_) oppure null se la stringa derivata contiene ancora caratteri non validi per la lingua specificata dal parametro provider.

Eccezioni

ArgumentNullException

key o provider è null.

Commenti

Se il key parametro è una stringa di caratteri valida, viene restituita tale stringa. Se il key parametro è una stringa non valida o una stringa contenente caratteri non validi, il VerifyResourceName metodo tenta di generare una stringa valida in base ai key parametri e provider . Se è possibile generare una stringa valida, tale stringa viene restituita; in caso contrario, null viene restituito .

Se il key parametro è una stringa vuota (""), viene restituita una stringa costituita da un singolo carattere di sottolineatura (_). Se il key parametro non è una stringa vuota, il VerifyResourceName metodo confronta ogni carattere nella stringa con un set di token non validi in base alla lingua specificata dal provider parametro . Qualsiasi carattere non valido nella stringa viene sostituito con un carattere di sottolineatura. I caratteri che verranno sostituiti con un carattere di sottolineatura sono i seguenti:

' (spazio), U+00A0 (spazio non di rilievo), '.' (punto), ',' (virgola), ';' (punto e virgola), '|', '~', '@', '#', '%', '^', '&', '*', '+', '-', '/', '\', '<', '>?', '?', '[', ']', '(', ')', '{', '}', ' (virgolette), ''' (apostrofo), ':'e '!'.

Nota

Le risorse fortemente tipizzate non consentono l'uso di parole chiave del linguaggio (ad esempio if, fore così via) come nomi di chiave di risorsa. Tuttavia, il System.CodeDom modello di progettazione consente l'uso delle parole chiave del linguaggio anteponendo alla parola chiave il carattere di sottolineatura. Il VerifyResourceName metodo chiama il CreateValidIdentifier metodo per applicare questa progettazione. Ad esempio, se si usa un nome di risorsa uguale a una parola chiave del linguaggio, ad esempio for, il nome viene visualizzato come _for nella classe di risorse fortemente tipizzata generata.