روش AppendChunk ADO

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

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

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

شیء توضیح روش AppendChunk
Parameter

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

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

Field

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

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

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

توجه: روش AppendChunk بر روی اشیاء Field در Record Object کار نمی‌کند. هیچ عملی انجام نمی‌دهد و خطای زمان اجرا ایجاد می‌کند.

نحوه‌ی نوشتن

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