ValidatePattern, deklaracja atrybutu

Atrybut ValidatePattern określa wzorzec wyrażenia regularnego, który weryfikuje argument parametru polecenia cmdlet. Ten atrybut może być również używany przez Windows PowerShell funkcji.

Gdy validatePattern jest wywoływana w ramach polecenia cmdlet, środowisko uruchomieniowe Windows PowerShell konwertuje argument parametru polecenia cmdlet na ciąg, a następnie porównuje ten ciąg ze wzorcem dostarczonym przez atrybut ValidatePattern. Polecenie cmdlet jest uruchamiane tylko wtedy, gdy przekonwertowana reprezentacja ciągu argumentu i podany wzorzec są zgodne. Jeśli nie są one zgodne, środowisko uruchomieniowe Windows PowerShell zgłasza błąd.

Składnia

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

Parametry

RegexString(System.String) Wymagane. Określa wyrażenie regularne, które weryfikuje argument parametru.

Opcje (System.Text.Regularexpressions.Regexoptions) Opcjonalny nazwany parametr. Określa bitową kombinację flag System.Text.Regularexpressions.Regexoptions, które określają opcje wyrażenia regularnego.

Uwagi

  • Tego atrybutu można używać tylko raz dla każdego parametru.

  • Możesz użyć Option parametru atrybutu , aby dodatkowo zdefiniować wzorzec. Na przykład można wprowadzić wielkość liter we wzorcu.

  • Jeśli ten atrybut jest stosowany do kolekcji, każdy element w kolekcji musi być zgodne ze wzorcem.

  • Atrybut ValidatePattern jest definiowany przez klasę System.Management.Automation.Validatepatternattribute.

Zobacz też

System.Management.Automation.Validatepatternattribute

Pisanie polecenia cmdlet programu Windows PowerShell