StronglyTypedResourceBuilder.VerifyResourceName Methode

Definition

Namespace:

System.Resources.Tools

Assembly:

System.Windows.Forms.Design.dll

Generiert auf Grundlage der angegebenen Eingabezeichenfolge und des Codeanbieters eine gültige Ressourcenzeichenfolge.

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

Parameter

key

String

Die zu überprüfende Zeichenfolge, ggf. in einen gültigen Ressourcennamen konvertiert.

provider

CodeDomProvider

Ein CodeDomProvider-Objekt, das die zu verwendende Zielsprache angibt.

Gibt zurück

String

Ein gültiger Ressourcenname, der vom key-Parameter abgeleitet wurde. Alle ungültigen Token werden durch einen Unterstrich (_) ersetzt, oder null, wenn die Zeichenfolge im Kontext der im provider-Parameter angegebenen Sprache noch immer ungültige Zeichen enthält.

Ausnahmen

ArgumentNullException

key oder provider ist null.

Hinweise

Wenn der key Parameter eine gültige Zeichenfolge ist, wird diese Zeichenfolge zurückgegeben. Wenn der key Parameter eine ungültige Zeichenfolge oder eine Zeichenfolge ist, die ungültige Zeichen enthält, versucht die VerifyResourceName Methode, eine gültige Zeichenfolge basierend auf den key Parametern und provider zu generieren. Wenn eine gültige Zeichenfolge generiert werden kann, wird diese Zeichenfolge zurückgegeben. andernfalls null wird zurückgegeben.

Wenn der key Parameter eine leere Zeichenfolge ("") ist, wird eine Zeichenfolge zurückgegeben, die aus einem einzelnen Unterstrich (_) besteht. Wenn der key Parameter keine leere Zeichenfolge ist, vergleicht die VerifyResourceName Methode jedes Zeichen in der Zeichenfolge basierend auf der vom provider Parameter angegebenen Sprache mit einem Satz ungültiger Token. Jedes ungültige Zeichen in der Zeichenfolge wird durch einen Unterstrich ersetzt. Die Zeichen, die durch einen Unterstrich ersetzt werden, sind wie folgt:

' ' (Leerzeichen), U+00A0 (kein Leerzeichen), '.' (Punkt), "," (Komma), ";" (Semikolon), '|', '~', '@', '#', '%', '^', '&', '*', '+', '-', '/', '\',< '', '>', '?', '[', ']', '(', ')', '{', '}', ''' (Zitat), ''' (Apostroph), ':' und '!'.

Hinweis

Stark typisierte Ressourcen lassen die Verwendung von Sprachschlüsselwörtern (z if. B. , forusw.) als Ressourcenschlüsselnamen nicht zu. Das Entwurfsmuster ermöglicht jedoch die Verwendung von Sprachschlüsselwörtern, System.CodeDom indem dem Schlüsselwort (keyword) der Unterstrich vorangestellt wird. Die VerifyResourceName -Methode ruft die CreateValidIdentifier -Methode auf, um diesen Entwurf zu erzwingen. Wenn Sie beispielsweise einen Ressourcennamen verwenden, der mit einer Sprach-Schlüsselwort (keyword) identisch ist, wie forz. B. , wird der Name in _for der generierten stark typisierten Ressourcenklasse angezeigt.