روش GetChunk ADO

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

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

روش GetChunk می‌تواند یک مقدار variant بازگردانی کند که شامل بخشی یا تمامی داده‌های بزرگ نوشتاری یا دوگانه Field است.

برای جستجو در بخشی یا تمامی داده‌های دوگانه یا کاراکتری در Field، از روش GetChunk استفاده کنید. در شرایطی که حافظه سیستم محدود است، می‌توانید از روش GetChunk برای عملیات بر روی بخشی از داده‌های Long استفاده کنید.

داده‌هایی که توسط فراخوانی GetChunk بازگردانده می‌شود به متغیر variable تخصیص داده می‌شود. اگر اندازه Size بزرگتر از داده‌های باقی‌مانده باشد، روش GetChunk فقط داده‌های باقی‌مانده را بازگردانی می‌کند و از فضاهای خالی برای پر کردن variable استفاده نمی‌کند. اگر فیلد خالی باشد، روش GetChunk مقدار Null را بازگردانی می‌کند.

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

اگر بیت adFldLong属性 آبجکت Field به True تنظیم شده باشد، می‌توان از روش GetChunk برای این زمینه استفاده کرد.

نکته:اگر از روش Getchunk آبجکت Field استفاده شود و ضبط فعلی وجود نداشته باشد، خطای 3021 (بدون ضبط فعلی) ایجاد خواهد شد.

نکته:روش GetChunk در آبجکت Field در آبجکت Record不起اد عمل کرده و خطای زمان اجرایی ایجاد خواهد کرد.

نحوه‌ی نوشتن

variable_name=field.GetChunk(size)
پارامتر توضیح
size عبارت طولانی، برابر با تعداد بایت یا کاراکتر مورد جستجو است.

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