Declaração de atributo ValidatePattern
O atributo ValidatePattern especifica um padrão de expressão regular que valida o argumento de um parâmetro cmdlet. Esse atributo também pode ser usado por funções do Windows PowerShell.
Quando ValidatePattern é invocado dentro de um cmdlet, o runtime do Windows PowerShell converte o argumento do parâmetro cmdlet em uma cadeia de caracteres e compara essa cadeia de caracteres com o padrão fornecido pelo atributo ValidatePattern. O cmdlet será executado somente se a representação de cadeia de caracteres convertida do argumento e o padrão fornecido corresponderem. Se eles não corresponderem, um erro será gerado pelo runtime do Windows PowerShell.
Sintaxe
[ValidatePattern(string regexString)]
[ValidatePattern(string regexString, Named Parameters)]
Parâmetros
RegexString
(System.String) Obrigatório. Especifica uma expressão regular que valida o argumento de parâmetro.
Opções (System.Text.RegularExpressions.RegexOptions) Parâmetro nomeado opcional. Especifica uma combinação bit a bit de System.Text.RegularExpressions.RegexOptions sinalizadores que especificam opções de expressão regular.
Observações
Esse atributo pode ser usado apenas uma vez por parâmetro.
Você pode usar o parâmetro
Option
do atributo para definir ainda mais o padrão. Por exemplo, você pode diferenciar o padrão de maiúsculas e minúsculas.Se esse atributo for aplicado a uma coleção, cada elemento da coleção deverá corresponder ao padrão.
O atributo ValidatePattern é definido pela classe System.Management.Automation.ValidatePatternAttribute.