ValidatePattern Attribute Declaration (Declaração do Atributo ValidatePattern)

O atributo ValidatePattern especifica um padrão de expressão regular que valida o argumento de um parâmetro de cmdlet. Esse atributo também pode ser usado por funções do Windows PowerShell.

Quando ValidatePattern é invocado em um cmdlet, o tempo de execução do Windows PowerShell converte o argumento do parâmetro do cmdlet em uma cadeia de caracteres e, em seguida, compara essa cadeia de caracteres com o padrão fornecido pelo atributo ValidatePattern. O cmdlet é 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 tempo de execução 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 do 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

• Este atributo pode ser usado apenas uma vez por parâmetro.

• Você pode usar o parâmetro Option do atributo para definir melhor o padrão. Por exemplo, você pode diferenciar maiúsculas de minúsculas do padrão.

• 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.

Ver também

System.Management.Automation.ValidatePatternAttribute

Escrevendo um cmdlet do Windows PowerShell