مетод ADO AppendChunk

برگشت به دستورالعمل‌های مرجع موضوع Field ADO

تعریف و استفاده

AppendChunk برای اضافه کردن داده‌ها به Fieldهای بزرگ نوشتاری یا باینری یا به شیء Parameter استفاده می‌شود.

توضیح:از روش AppendChunk شیء Field یا Parameter برای پر کردن داده‌های دو باینری یا حروفی استفاده می‌شود. در شرایطی که حافظه سیستم محدود است، می‌توان از روش AppendChunk برای عملیات بر روی بخشی از Longها و نه تمامی آن‌ها استفاده کرد.

شیء توضیح روش AppendChunk
پارامتر

اگر بیت adFldLong در ویژگی Attributes شیء Parameter تنظیم به True باشد، می‌توان از روش AppendChunk برای این پارامتر استفاده کرد.

اولین فراخوانی AppendChunk روی شیء Parameter داده‌ها را به پارامتر وارد می‌کند و هرگونه داده‌های موجود را پوشش می‌دهد. فراخوانی‌های AppendChunk بعدی روی شیء Parameter داده‌ها را به داده‌های پارامتر موجود اضافه می‌کنند. فراخوانی AppendChunk با ارزش Null داده‌های پارامتر را کنار می‌گذارد.
حقل

اگر بیت adFldLong در ویژگی Attributes شیء Field تنظیم به True باشد، می‌توان از روش AppendChunk برای این حقل استفاده کرد.

اولین فراخوانی AppendChunk روی شیء Field داده‌ها را به حقل وارد می‌کند و هرگونه داده‌های موجود را پوشش می‌دهد. فراخوانی‌های AppendChunk بعدی داده‌ها را به داده‌های موجود اضافه می‌کنند. اگر بخواهید داده‌ها را به یک حقل اضافه کنید و سپس در ثبت کنونی ارزش‌های حقلهای دیگر را تنظیم یا خواند، ADO آن را به عنوان اضافه کردن داده‌ها به اولین حقل می‌پندارد. اگر AppendChunk روش دوباره روی اولین حقل فراخوانی شود، ADO این فراخوانی را به عنوان یک عملیات جدید AppendChunk در نظر می‌گیرد و داده‌های موجود را پوشش می‌دهد. دسترسی به حقلهای دیگر Recordset (و نه کپی اولین Recordset) عملیات AppendChunk را مختل نمی‌کند.

در حالی که AppendChunk بر روی موضوع Field فراخوانی می‌شود و هیچ گزارش فعلی وجود ندارد، خطا رخ می‌دهد.

توجه: روش AppendChunk بر روی موضوع Field موضوع Record فاقد اثر است. این روش هیچ عملی انجام نمی‌دهد و خطای زمان اجرا ایجاد می‌کند.

عبارت

objectname.AppendChunk data
پارامتر توضیح
data Variant، شامل داده‌هایی که باید به موضوع داده شود.

برگشت به دستورالعمل‌های مرجع موضوع Field ADO