Attributdeklaration: ValidatePattern

Das ValidatePattern-Attribut gibt ein Muster für reguläre Ausdrücke an, das das Argument eines Cmdlet-Parameters überprüft. Dieses Attribut kann auch von Windows PowerShell-Funktionen verwendet werden.

Wenn ValidatePattern innerhalb eines Cmdlets aufgerufen wird, konvertiert die Windows PowerShell-Laufzeit das Argument des Cmdlet-Parameters in eine Zeichenfolge und vergleicht diese Zeichenfolge dann mit dem muster, das vom ValidatePattern-Attribut bereitgestellt wird. Das Cmdlet wird nur ausgeführt, wenn die konvertierte Zeichenfolgendarstellung des Arguments und die angegebene Mustervergleichszeichenfolge übereinstimmen. Wenn sie nicht übereinstimmen, wird ein Fehler von der Windows PowerShell-Laufzeit ausgelöst.

Syntax

[ValidatePattern(string regexString)]
[ValidatePattern(string regexString, Named Parameters)]

Die Parameter

RegexString (System.String) Erforderlich. Gibt einen regulären Ausdruck an, der das Parameterargument überprüft.

Options (System.Text.RegularExpressions.RegexOptions) Optionaler benannter Parameter. Gibt eine bitweise Kombination aus System.Text.RegularExpressions.RegexOptions Flags an, die reguläre Ausdrucksoptionen angeben.

Bemerkungen

• Dieses Attribut kann nur einmal pro Parameter verwendet werden.

• Sie können den Option Parameter des Attributs verwenden, um das Muster weiter zu definieren. Sie können z. B. die Groß-/Kleinschreibung des Musters beachten.

• Wenn dieses Attribut auf eine Auflistung angewendet wird, muss jedes Element in der Auflistung mit dem Muster übereinstimmen.

• Das ValidatePattern-Attribut wird durch die System.Management.Automation.ValidatePatternAttribute Klasse definiert.

Siehe auch

System.Management.Automation.ValidatePatternAttribute

Schreiben eines Windows PowerShell-Cmdlets