Attributdeklaration: ValidatePattern

  • Artikel

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 Runtime 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 das angegebene Muster übereinstimmen. Wenn sie nicht übereinstimmen, wird von der Windows PowerShell Runtime ein Fehler ausgelöst.

Syntax

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

Parameter

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

Optionen (System.Text.Regularexpressions.Regexoptions) Optionaler benannter Parameter. Gibt eine bitweise Kombination von System.Text.Regularexpressions.Regexoptions-Flags an, die Optionen für reguläre Ausdrücke 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. Beispielsweise können Sie 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 von der System.Management.Automation.Validatepatternattribute-Klasse definiert.

Weitere Informationen

System.Management.Automation.Validatepatternattribute

Schreiben eines Windows PowerShell-Cmdlets