جریان (ADO Stream)
«جریان ADO (ADO Stream)» لوله داده است. بنابراین متن یا باینری را می خواند و می نویسد. این شیء برای فایل ها، پاسخ ها، یا حافظه کاربردی است. پس می توانی متن ذخیره کنی یا فایل بسازی.
جریان ADO چیست؟
«استریم (Stream)» دنباله ای از داده است. داده می تواند متن یا باینری باشد. همچنین استریم از سه راه به دست می آید: از URL، با ساخت مستقیم، یا از استریم پیش فرض رکورد.
نمونه استریم متنی: نوشتن و ذخیره
<%
' ساخت یک استریم متنی و ذخیره آن در فایل
set st = Server.CreateObject("ADODB.Stream")
st.Type = 2 ' adTypeText
st.Open
st.CharSet = "UTF-8"
st.LineSeparator = -1 ' adCRLF
st.WriteText "Hello Stream!"
st.Position = 0
st.SaveToFile Server.MapPath("out.txt"), 2 ' adSaveCreateOverWrite
st.Close
set st = Nothing
%>
نمونه استریم باینری: خواندن فایل
<%
' بارگذاری فایل باینری در استریم و خواندن اندازه
set bs = Server.CreateObject("ADODB.Stream")
bs.Type = 1 ' adTypeBinary
bs.Open
bs.LoadFromFile Server.MapPath("logo.png")
sizeInBytes = bs.Size
Response.Write "Bytes: " & sizeInBytes
bs.Close
set bs = Nothing
%>
ویژگی ها (Properties) مهم
چند ویژگی کلیدی را کوتاه ببینیم. سپس با نیاز بیشتر شو.
- Type: نوع داده استریم را تعیین می کند.
- CharSet: مجموعه نویسه متن را مشخص می کند.
- LineSeparator: جداکننده خط متن را تنظیم می کند.
- Mode: سطح دسترسی خواندن/نوشتن را تعیین می کند.
- Position: جایگاه فعلی در استریم را می گوید.
- Size: اندازه استریم باز را برمی گرداند.
- State: باز یا بسته بودن استریم را نشان می دهد.
- EOS: پایان استریم را گزارش می دهد.
متدها (Methods) پرکاربرد
- Open/Close: استریم را باز و بسته می کند.
- Read/ReadText: خواندن باینری یا متن انجام می دهد.
- Write/WriteText: نوشتن باینری یا متن انجام می دهد.
- LoadFromFile/SaveToFile: بارگذاری یا ذخیره فایل انجام می دهد.
- CopyTo: کپی بین دو استریم انجام می دهد.
- Flush: بافر را به مقصد می فرستد.
- SetEOS: پایان استریم را تنظیم می کند.
- SkipLine: یک خط متن را رد می کند.
- Cancel: اجرای Open را لغو می کند.
گام های امن کار با جریان ADO
- نوع استریم را درست تعیین کن.
- برای متن، CharSet مناسب بگذار.
- پس از کار، حتماً Close را انجام بده.
نکته: هنگام overwrite فایل، مسیر و مجوزها را بررسی کن. سپس SaveToFile را اجرا کن.
پیوند با بخش های مرتبط
برای داده جدولی، رکوردست ADO مناسب است. همچنین برای ردیف تکی، رکورد ADO را ببین. این صفحه «جریان ADO» مرجع متنی و باینری است.
جمع بندی سریع
- جریان ADO لوله داده است.
- Type را درست انتخاب کن.
- متن نیازمند CharSet صحیح است.
- فایل ها را با SaveToFile ذخیره کن.
- همیشه در پایان Close کن.