ตรวจสอบการประกาศแอตทริบิวต์รูปแบบ

แอตทริบิวต์ ValidatePattern ระบุรูปแบบนิพจน์ทั่วไปที่ตรวจสอบอาร์กิวเมนต์ของพารามิเตอร์ cmdlet คุณลักษณะนี้ยังสามารถใช้ได้โดยฟังก์ชัน Windows PowerShell

เมื่อ ValidatePattern ถูกเรียกใช้ภายใน cmdlet รันไทม์ของ Windows PowerShell จะแปลงอาร์กิวเมนต์ของพารามิเตอร์ cmdlet เป็นสตริง จากนั้นเปรียบเทียบสตริงนั้นกับรูปแบบที่มาจากแอตทริบิวต์ ValidatePattern cmdlet จะทำงานเฉพาะในกรณีที่การแสดงสตริงที่แปลงแล้วของอาร์กิวเมนต์และรูปแบบที่ให้มาตรงกัน หากไม่ตรงกัน รันไทม์ Windows PowerShell จะเกิดข้อผิดพลาด

ไวยากรณ์

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

พารามิเตอร์

RegexString (System.String) จำเป็น ระบุนิพจน์ทั่วไปที่ตรวจสอบอาร์กิวเมนต์พารามิเตอร์

ตัวเลือก (System.Text.Regularexpressions.Regexoptions) พารามิเตอร์ที่มีชื่อเพิ่มเติม ระบุชุดค่าสถานะ System.Text.Regularexpressions.Regexoptions ระดับบิตที่ระบุตัวเลือกนิพจน์ทั่วไป

หมายเหตุ

• คุณลักษณะนี้สามารถใช้ได้เพียงครั้งเดียวต่อพารามิเตอร์

• คุณสามารถใช้พารามิเตอร์ Option ของแอตทริบิวต์เพื่อกำหนดรูปแบบเพิ่มเติมได้ ตัวอย่างเช่น คุณสามารถทำให้รูปแบบคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ได้

• หากใช้แอตทริบิวต์นี้กับคอลเลกชัน แต่ละองค์ประกอบในคอลเลกชันจะต้องตรงกับรูปแบบ

• คุณลักษณะ ValidatePattern ถูกกำหนดโดยคลาส System.Management.Automation.Validatepatternattribute

ดูเพิ่มเติม

System.Management.Automation.Validatepatternattribute

การเขียน Windows PowerShell Cmdlet