ValidateSet, deklaracja atrybutu

  • Artykuł

Atrybut ValidateSetAttribute określa zestaw możliwych wartości argumentu parametru polecenia cmdlet. Ten atrybut może być również używany przez Windows PowerShell funkcji.

Gdy ten atrybut jest określony, środowisko uruchomieniowe Windows PowerShell określa, czy podany argument dla parametru polecenia cmdlet pasuje do elementu w podanym zestawie elementów. Polecenie cmdlet jest uruchamiane tylko wtedy, gdy argument parametru pasuje do elementu w zestawie. Jeśli dopasowanie nie zostanie znalezione, środowisko uruchomieniowe Windows PowerShell zgłasza błąd.

Składnia

[ValidateSetAttribute(params string[] validValues)]
[ValidateSetAttribute(params string[] validValues, Named Parameters)]

Parametry

ValidValues(System.String) Wymagane. Określa prawidłowe wartości elementu parametru. W poniższym przykładzie pokazano, jak określić jeden element lub wiele elementów.

[ValidateSetAttribute("Steve")]
[ValidateSetAttribute("Steve","Mary")]

IgnoreCase(System.Boolean) Opcjonalny nazwany parametr. Wartość domyślna true oznacza, że przypadek jest ignorowany. Wartość false sprawia, że wielkość liter polecenia cmdlet jest zróżnicowana.

Uwagi

  • Tego atrybutu można używać tylko raz dla każdego parametru.

  • Jeśli wartość parametru jest tablicą, każdy element tablicy musi odpowiadać elementowi zestawu atrybutów.

  • Atrybut ValidateSetAttribute jest definiowany przez klasę System.Management.Automation.Validatesetattribute.

Zobacz też

System.Management.Automation.Validatesetattribute

Pisanie polecenia cmdlet programu Windows PowerShell