Declaración de atributo ValidatePatternValidatePattern Attribute Declaration

El atributo ValidatePattern especifica un patrón de expresión regular que valida el argumento de un parámetro de cmdlet.The ValidatePattern attribute specifies a regular expression pattern that validates the argument of a cmdlet parameter. Este atributo también se puede usar en las funciones de Windows PowerShell.This attribute can also be used by Windows PowerShell functions.

Cuando se invoca ValidatePattern dentro de un cmdlet, el tiempo de ejecución de Windows PowerShell convierte el argumento del parámetro de cmdlet en una cadena y, a continuación, compara esa cadena con el patrón proporcionado por el atributo 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. El cmdlet se ejecuta solo si la representación de cadena convertida del argumento y el patrón proporcionado coinciden.The cmdlet is run only if the converted string representation of the argument and the supplied pattern match. Si no coinciden, el tiempo de ejecución de Windows PowerShell produce un error.If they do not match, an error is thrown by the Windows PowerShell runtime.

SintaxisSyntax

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

ParámetrosParameters

RegexString(System. String) requerido.RegexString (System.String) Required. Especifica una expresión regular que valida el argumento del parámetro.Specifies a regular expression that validates the parameter argument.

Options (System. Text. RegularExpressions. RegexOptions) opcional parámetro con nombre.Options (System.Text.Regularexpressions.Regexoptions) Optional named parameter. Especifica una combinación bit a bit de las marcas System. Text. RegularExpressions. RegexOptions que especifican las opciones de expresión regular.Specifies a bitwise combination of System.Text.Regularexpressions.Regexoptions flags that specify regular expression options.

ObservacionesRemarks

  • Este atributo solo se puede usar una vez por parámetro.This attribute can be used only once per parameter.

  • Puede usar el Option parámetro del atributo para definir más el modelo.You can use the Option parameter of the attribute to further define the pattern. Por ejemplo, puede hacer que el patrón distinga mayúsculas de minúsculas.For example, you can make the pattern case sensitive.

  • Si este atributo se aplica a una colección, cada elemento de la colección debe coincidir con el patrón.If this attribute is applied to a collection, each element in the collection must match the pattern.

  • La clase System. Management. Automation. Validatepatternattribute define el atributo ValidatePattern.The ValidatePattern attribute is defined by the System.Management.Automation.Validatepatternattribute class.

Consulte tambiénSee Also

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

Escribir un cmdlet de Windows PowerShellWriting a Windows PowerShell Cmdlet