ประกาศแอตทริบิวต์ ValidateSet
แอตทริบิวต์ ValidateSetAttribute ระบุชุดของค่าที่เป็นไปได้สำหรับอาร์กิวเมนต์พารามิเตอร์ cmdlet คุณลักษณะนี้ยังสามารถใช้ได้โดยฟังก์ชัน Windows PowerShell
เมื่อมีการระบุแอตทริบิวต์นี้ รันไทม์ของ Windows PowerShell จะกำหนดว่าอาร์กิวเมนต์ที่ให้มาสำหรับพารามิเตอร์ cmdlet ตรงกับองค์ประกอบในชุดองค์ประกอบที่ให้มาหรือไม่ cmdlet จะทำงานก็ต่อเมื่ออาร์กิวเมนต์พารามิเตอร์ตรงกับองค์ประกอบในชุด หากไม่พบรายการที่ตรงกัน ข้อผิดพลาดจะเกิดขึ้นโดยรันไทม์ Windows PowerShell
ไวยากรณ์
[ValidateSetAttribute(params string[] validValues)]
[ValidateSetAttribute(params string[] validValues, Named Parameters)]
พารามิเตอร์
ValidValues (System.String) จำเป็น ระบุค่าองค์ประกอบพารามิเตอร์ที่ถูกต้อง ตัวอย่างต่อไปนี้แสดงวิธีการระบุองค์ประกอบหนึ่งหรือหลายองค์ประกอบ
[ValidateSetAttribute("Steve")]
[ValidateSetAttribute("Steve","Mary")]
IgnoreCase (System.Boolean) พารามิเตอร์ที่มีชื่อเพิ่มเติม ค่าเริ่มต้นของ true บ่งชี้ว่าตัวพิมพ์จะถูกละเว้น ค่า false ทำให้ cmdlet คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่
หมายเหตุ
คุณลักษณะนี้สามารถใช้ได้เพียงครั้งเดียวต่อพารามิเตอร์
-
หากค่าพารามิเตอร์เป็นอาร์เรย์ ทุกองค์ประกอบของอาร์เรย์จะต้องตรงกับองค์ประกอบของชุดแอตทริบิวต์
คุณลักษณะ ValidateSetAttribute ถูกกำหนดโดยคลาส System.Management.Automation.Validatesetattribute
ดูเพิ่มเติม
System.Management.Automation.Validatesetattribute
การเขียน Windows PowerShell Cmdlet