ValidateSet, deklaracja atrybutu

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

Po określeniu tego atrybutu środowisko uruchomieniowe programu Windows PowerShell określa, czy podany argument parametru 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 nie zostanie znalezione dopasowanie, zostanie zgłoszony błąd przez środowisko uruchomieniowe programu Windows PowerShell.

Składnia

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

Parametry

ValidValues ( wymaganeSystem.String). 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 wskazuje, że przypadek jest ignorowany. Wartość false uwzględnia wielkość liter polecenia cmdlet.

Uwagi

• Ten atrybut może być używany tylko raz na parametr.

• Jeśli wartość parametru jest tablicą, każdy element tablicy musi być zgodny z elementem 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