Dichiarazione dell'attributo ValidatePatternValidatePattern Attribute Declaration

L'attributo ValidatePattern specifica un modello di espressione regolare che convalida l'argomento di un parametro del cmdlet.The ValidatePattern attribute specifies a regular expression pattern that validates the argument of a cmdlet parameter. Questo attributo può essere usato anche dalle funzioni di Windows PowerShell.This attribute can also be used by Windows PowerShell functions.

Quando ValidatePattern viene richiamato all'interno di un cmdlet, il runtime di Windows PowerShell converte l'argomento del parametro del cmdlet in una stringa e quindi confronta tale stringa con il modello fornito dall'attributo ValidatePattern.When ValidatePattern is invoked within a cmdlet, the Windows PowerShell runtime converts the argument of the cmdlet parameter to a string and then compares that string to the pattern supplied by the ValidatePattern attribute. Il cmdlet viene eseguito solo se la rappresentazione di stringa convertita dell'argomento e il criterio fornito corrispondono.The cmdlet is run only if the converted string representation of the argument and the supplied pattern match. Se non corrispondono, viene generato un errore dal runtime di Windows PowerShell.If they do not match, an error is thrown by the Windows PowerShell runtime.

SintassiSyntax

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

ParametriParameters

RegexString(System. String) obbligatorio.RegexString (System.String) Required. Specifica un'espressione regolare che convalida l'argomento del parametro.Specifies a regular expression that validates the parameter argument.

Options (System. Text. RegularExpressions. RegexOptions) parametro denominato facoltativo.Options (System.Text.Regularexpressions.Regexoptions) Optional named parameter. Specifica una combinazione bit per bit di flag System. Text. RegularExpressions. RegexOptions che specificano le opzioni di espressione regolare.Specifies a bitwise combination of System.Text.Regularexpressions.Regexoptions flags that specify regular expression options.

OsservazioniRemarks

  • Questo attributo può essere utilizzato una sola volta per ogni parametro.This attribute can be used only once per parameter.

  • OptionPer definire ulteriormente il modello, è possibile usare il parametro dell'attributo.You can use the Option parameter of the attribute to further define the pattern. Ad esempio, è possibile rendere la distinzione tra maiuscole e minuscole.For example, you can make the pattern case sensitive.

  • Se questo attributo viene applicato a una raccolta, ogni elemento nella raccolta deve corrispondere al modello.If this attribute is applied to a collection, each element in the collection must match the pattern.

  • L'attributo ValidatePattern è definito dalla classe System. Management. Automation. Validatepatternattribute .The ValidatePattern attribute is defined by the System.Management.Automation.Validatepatternattribute class.

Vedere ancheSee Also

System. Management. Automation. ValidatepatternattributeSystem.Management.Automation.Validatepatternattribute

Scrittura di un cmdlet di Windows PowerShellWriting a Windows PowerShell Cmdlet