فهرست سرفصل‌های ASP
خانه (HOME) معرفی (WebPages Intro) ریزر (WebPages Razor) چیدمان (WebPages Layout) پوشه ها (WebPages Folders) گلوبال (WebPages Global) فرم ها (WebPages Forms) اشیا (WebPages Objects) فایل ها (WebPages Files) پایگاه داده ها (WebPages Databases) هلپرها (WebPages Helpers) وب گرید (WebPages WebGrid) نمودارها (WebPages Charts) ایمیل (WebPages Email) امنیت (WebPages Security) انتشار (WebPages Publish) نمونه ها (WebPages Examples) کلاس ها (WebPages Classes) معرفی (Razor Intro) سینتکس (Razor Syntax) متغیرها (Razor C# Variables) حلقه ها (Razor C# Loops) منطق (Razor C# Logic) متغیرها (Razor VB Variables) حلقه ها (Razor VB Loops) منطق (Razor VB Logic) معرفی (ASP Intro) سینتکس (ASP Syntax) متغیرها (ASP Variables) رویه ها (ASP Procedures) شرط ها (ASP Conditionals) حلقه ها (ASP Looping) فرم ها (ASP Forms) کوکی ها (ASP Cookies) نشست (ASP Session) برنامه (ASP Application) اینکلود (#include) (ASP #include) Global.asa (ASP Global.asa) AJAX (ASP AJAX) ایمیل (ASP e-mail) نمونه ها (ASP Examples) گواهینامه (ASP Certificate) توابع VB (ASP VB Functions) کلیدواژه های VB (ASP VB Keywords) Response (ASP Response) Request (ASP Request) Application (ASP Application) Session (ASP Session) Server (ASP Server) Error (ASP Error) FileSystem (ASP FileSystem) TextStream (ASP TextStream) Drive (ASP Drive) File (ASP File) Folder (ASP Folder) Dictionary (ASP Dictionary) AdRotator (ASP AdRotator) BrowserCap (ASP BrowserCap) پیوند محتوا (ASP Content Linking) گرداننده محتوا (ASP Content Rotator) راهنمای سریع (ASP Quick Ref) معرفی (ADO Intro) اتصال (ADO Connect) رکوردست (ADO Recordset) نمایش (ADO Display) کوئری (ADO Query) مرتب سازی (ADO Sort) افزودن (ADO Add) به روزرسانی (ADO Update) حذف (ADO Delete) فرمان (ADO Command) اتصال (ADO Connection) خطا (ADO Error) فیلد (ADO Field) پارامتر (ADO Parameter) ویژگی (ADO Property) رکورد (ADO Record) رکوردست (ADO Recordset) جریان (ADO Stream) انواع داده (ADO DataTypes)
نتیجه‌ای برای جستجو یافت نشد.
ASP

ASP — رکورد (ADO Record)

آخرین بروزرسانی: 1404/08/14

رکورد (ADO Record)

شیء «رکورد ADO (ADO Record)» یک سطر داده را نگه می دارد. گاهی این سطر از Recordset است، گاهی از پوشه یا فایل. بنابراین، با رکورد می توان داده های غیرجدولی را هم مدیریت کرد. «پایگاه داده ساخت یافته» یعنی جدول ها ستون های یکسان دارند. اما رکورد می تواند ردیف های با ستون های متفاوت را هم نمایش دهد.

رکورد چه کار می کند؟

رکورد یک ردیف منفرد را نمایش می دهد. سپس می توان فایل، پوشه یا ردیف خاصی را باز کرد. بنابراین، دسترسی به داده های انعطاف پذیر ساده می شود.

سینتکس سریع

objectname.property
objectname.method

مشاهده در ادیتور

ویژگی ها (Properties)

چند ویژگی مهم رکورد را بشناسیم. هرکدام نقش روشنی دارند.

  • ActiveConnection: اتصال والد رکورد را تنظیم یا برمی گرداند.
  • Mode: سطح مجوز تغییر داده را تعیین می کند.
  • ParentURL: آدرس مطلق رکورد والد را برمی گرداند.
  • RecordType: نوع رکورد را برمی گرداند.
  • Source: منبع Open رکورد را تنظیم یا برمی گرداند.
  • State: وضعیت فعلی رکورد را برمی گرداند.

متدها (Methods)

  • Open: یک رکورد را باز یا فایل/پوشه جدید ایجاد می کند.
  • Close: رکورد را می بندد.
  • CopyRecord: فایل یا پوشه را کپی می کند.
  • MoveRecord: فایل یا پوشه را جابجا می کند.
  • DeleteRecord: فایل یا پوشه را حذف می کند.
  • GetChildren: یک Recordset از اقلام داخل پوشه برمی گرداند.
  • Cancel: اجرای عملیات کپی، حذف، جابجایی یا Open را لغو می کند.

مجموعه ها (Collections)

  • Properties: مجموعه ای از ویژگی های وابسته به ارائه دهنده.
  • Fields: شامل همه Field های داخل رکورد.

کار با Fields: شمارش و دسترسی

با Count تعداد فیلدها را می گیریم. سپس با Item به فیلد برسیم.

<%
' فرض: rec یک شیء Record باز است
countfields = rec.Fields.Count
Response.Write countfields
%>

مشاهده در ادیتور

<%
' دسترسی با ایندکس عددی
itemByIndex = rec.Fields.Item(1)
Response.Write itemByIndex.Name

' دسترسی با نام فیلد
itemByName = rec.Fields.Item("Name")
Response.Write itemByName.Value
%>

مشاهده در ادیتور

مراحل نمونه عملی

  1. مسیر منبع را تعیین کن؛ مثلا مسیر پوشه.
  2. رکورد را با Open باز کن.
  3. با GetChildren محتوا را فهرست کن.
  4. در پایان، Close را فراموش نکن.

نکته: همیشه State را بررسی کن. سپس اقدام بعدی را انجام بده.

هشدار: عملیات DeleteRecord برگشت ناپذیر است. قبل از اجرا مطمئن شو.

ارتباط با دیگر بخش ها

برای ستون ها، صفحه فیلد ADO را ببین. سپس برای مجموعه کامل ردیف ها، رکوردست ADO را مطالعه کن. همچنین برای تنظیمات اتصال، اتصال ADO مفید است. این صفحه «رکورد ADO» کلیدواژه اصلی ماست.

جمع بندی سریع

  • رکورد یک ردیف منفرد را نگه می دارد.
  • با فایل و پوشه هم کار می کند.
  • ویژگی های کلیدی: Source، Mode، State.
  • با Fields.Count و Item کار کن.