ValidatePattern, deklaracja atrybutu

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

Gdy funkcja ValidatePattern jest wywoływana w ramach polecenia cmdlet, środowisko uruchomieniowe programu Windows PowerShell konwertuje argument parametru 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 podane dopasowanie wzorca. Jeśli nie są one zgodne, zostanie zgłoszony błąd przez środowisko uruchomieniowe programu Windows PowerShell.

Składnia

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

Parametry

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

Options (System.Text.RegularExpressions.RegexOptions) Opcjonalny nazwany parametr. Określa bitową kombinację System.Text.RegularExpressions.RegexOptions flag określających opcje wyrażeń regularnych.

Uwagi

• Ten atrybut może być używany tylko raz na parametr.

• Aby dokładniej zdefiniować wzorzec, możesz użyć parametru Option atrybutu. Na przykład można określić wielkość liter wzorca.

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

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

Zobacz też

System.Management.Automation.ValidatePatternAttribute

pisanie polecenia cmdlet programu Windows PowerShell