پارامتر (ADO Parameter)
«پارامتر ADO (ADO Parameter)» اطلاعات یک ورودیِ تکی را نگه می دارد. این ورودی در «رویه ذخیره شده (Stored Procedure)» یا «کوئری (Query)» استفاده می شود. سپس پارامتر داخل «مجموعه پارامترها (Parameters Collection)» قرار می گیرد. این مجموعه به یک «فرمان (Command)» وصل است و مقادیر را جابه جا می کند. چهار نوع داریم: ورودی، خروجی، ورودی/خروجی و بازگشتی.
پارامتر ADO چیست؟
پارامترها به ساخت «فرمانِ پارامتردار» کمک می کنند. بنابراین بدنه فرمان ثابت می ماند. اما مقدار شرط ها تغییر می کند. مثلا بخش WHERE می تواند از پارامتر استفاده کند. در نتیجه کوئری امن تر و قابل تنظیم تر می شود.
قواعد نحوی (Syntax)
در مستند، دسترسی به ویژگی ها و متدها به صورت کلی آمده است:
objectname.property
objectname.method
ویژگی ها (Properties)
مهم ترین ویژگی ها برای کنترل نام، نوع و اندازه مقدار هستند.
- Attributes: تنظیم ویژگی های سطح شیء.
- Direction: جهت عبور پارامتر به یا از رویه.
- Name: نام پارامتر برای شناسایی.
- NumericScale: رقم های بعد اعشار عدد.
- Precision: بیشینه رقم های عددی.
- Size: اندازه بیشینه مقدار.
- Type: نوع داده پارامتر.
- Value: مقدار فعلی پارامتر.
متدها (Methods)
- AppendChunk: افزودن داده متنی یا باینری طولانی.
- Delete: حذف شیء از مجموعه Parameters.
انواع پارامترها
- ورودی (Input): مقدار را به رویه می دهد.
- خروجی (Output): مقدار را از رویه می گیرد.
- ورودی/خروجی (Input/Output): هر دو کار را انجام می دهد.
- بازگشتی (Return): مقدار بازگشتی رویه را برمی گرداند.
گام های عملی با پارامترها
- فرمان را آماده کن و متن کوئری را تعیین کن.
- پارامتر بساز و Name، Type و Size را تنظیم کن.
- Direction مناسب را انتخاب کن.
- Value را قبل از اجرا مقداردهی کن.
- فرمان را اجرا کن و نتایج را بررسی کن.
نکته: همیشه Type و Size را با داده واقعی هماهنگ کن.
هشدار: ناسازگاری Precision یا NumericScale باعث خطا می شود.
برای مطالعه بیشتر درباره فرمان، به فرمان ADO برو. همچنین برای ستون ها، فیلد ADO را ببین. مرجع «پارامتر ADO» را کنار دستت نگه دار.
جمع بندی سریع
- پارامتر ADO ورودیِ تکیِ فرمان است.
- چهار نوع جهت دهی داریم.
- Type و Size را دقیق ست کن.
- AppendChunk برای داده بزرگ است.