Attributdeklaration: ValidateSet

  • Artikel

Das ValidateSetAttribute-Attribut gibt einen Satz möglicher Werte für ein Cmdlet-Parameterargument an. Dieses Attribut kann auch von Windows PowerShell verwendet werden.

Wenn dieses Attribut angegeben wird, bestimmt die Windows PowerShell Runtime, ob das angegebene Argument für den Cmdlet-Parameter mit einem Element im angegebenen Elementsatz entspricht. Das Cmdlet wird nur ausgeführt, wenn das Parameterargument einem Element im Satz entspricht. Wenn keine Übereinstimmung gefunden wird, wird ein Fehler von der Windows PowerShell ausgelöst.

Syntax

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

Parameter

ValidValues (System.String) Erforderlich. Gibt die gültigen Parameterelementwerte an. Im folgenden Beispiel wird gezeigt, wie ein element oder mehrere Elemente angegeben werden.

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

IgnoreCase (System.Boolean) Optionaler benannter Parameter. Der Standardwert von gibt true an, dass der Fall ignoriert wird. Durch den Wert false wird die Schreibung des Cmdlets beachtet.

Bemerkungen

  • Dieses Attribut kann nur einmal pro Parameter verwendet werden.

  • Wenn der Parameterwert ein Array ist, muss jedes Element des Arrays mit einem Element des Attributsets übereinstimmen.

  • Das ValidateSetAttribute-Attribut wird von der System.Management.Automation.Validatesetattribute-Klasse definiert.

Weitere Informationen

System.Management.Automation.Validatesetattribute

Schreiben eines Windows PowerShell-Cmdlets