StronglyTypedResourceBuilder.VerifyResourceName Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Vygeneruje platný řetězec prostředku na základě zadaného vstupního řetězce a zprostředkovatele kódu.
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
Parametry
- key
- String
Řetězec, který se má ověřit a v případě potřeby převést na platný název prostředku.
- provider
- CodeDomProvider
Objekt CodeDomProvider , který určuje cílový jazyk, který se má použít.
Návraty
Platný název prostředku odvozený z parametru key
. Všechny neplatné tokeny jsou nahrazeny znakem podtržítka (_) nebo null
pokud odvozený řetězec stále obsahuje neplatné znaky podle jazyka určeného parametrem provider
.
Výjimky
key
nebo provider
je null
.
Poznámky
key
Pokud je parametr platným řetězcem znaků, vrátí se tento řetězec. key
Pokud je parametr neplatný řetězec nebo řetězec, který obsahuje neplatné znaky, VerifyResourceName metoda se pokusí vygenerovat platný řetězec na key
základě parametrů a provider
. Pokud platný řetězec lze vygenerovat, tento řetězec je vrácen; v null
opačném případě se vrátí.
key
Pokud je parametr prázdný řetězec (""), vrátí se řetězec, který se skládá z jednoho podtržítka (_). key
Pokud parametr není prázdný řetězec, VerifyResourceName metoda porovná každý znak v řetězci se sadou neplatných tokenů na základě jazyka určeného parametrem provider
. Každý neplatný znak v řetězci se nahradí podtržítkem. Znaky, které budou nahrazeny podtržítkem, jsou následující:
' ' (mezera), U+00A0 (nelomná mezera), '.' (tečka), "," (čárka), ";" (středník), |, '~', '@', '#', '%', '^', '&', '*', '+', '-', '/', '\', '<', '',> '?', '[', ']', '(', ')', '{', '}', '"' (citace), ''' (apostrof), ':' a '!'.
Poznámka
Prostředky silného typu neumožňují použití klíčových slov jazyka (například if
, for
atd.) jako názvů klíčů prostředků. Návrhový System.CodeDom vzor však umožňuje použití klíčových slov jazyka tím, že klíčové slovo přidá předponu podtržítkem. Metoda VerifyResourceName volá metodu CreateValidIdentifier k vynucení tohoto návrhu. Pokud například použijete název prostředku, který je stejný jako klíčové slovo jazyka, například for
, název se zobrazí jako _for
ve vygenerované třídě prostředků silného typu.