SFDatabases.Dataset service

The Dataset service is used to represent tabular data produced by a database. With this service it is possible to:

warning

Updating and inserting records using the Dataset service is slower than using SQL statements. When updating or inserting large amounts of records, it is recommended to use SQL statements instead of using the methods in this service.


Service invocation

Before using the Dataset service the ScriptForge library needs to be loaded or imported:

note

• ມາໂຄຣ Basic ຕ້ອງມີການໂຫຼດຄັງສຳນວນ ScriptForge ໂດຍໃຊ້ຄຳສັ່ງດັ່ງນີ້:
GlobalScope.BasicLibraries.loadLibrary("ScriptForge")

• ສະຄຣິບ Python ຕ້ອງມີການນຳເຂົ້າຈາກໂມດູນ scriptforge:
from scriptforge import CreateScriptService


The Dataset service is invoked using the CreateDataset method, which can be called either from a Database service instance or from another Dataset instance.

ໃນ Basic

The following example creates a Dataset from the table "Customers" stored in a database file.


    oDatabase = CreateScriptService("Database", "C:\MyDatabase.odb")
    oDataset = oDatabase.CreateDataset("Customers")
    With oDataset
        Do While .MoveNext()
            oValues = .Values()
            ' ...
        Loop
        .CloseDataset()
    End With
  
note

Upon the creation of the Dataset, the current record is positioned before the first record.


The example below creates a Dataset instance by filtering the original dataset.


    oNewDataset = oDataset.CreateDataset(Filter := "[City]='New York'")
  
ໃນ Python

    database = CreateScriptService("Database", r"C:\MyDatabase.odb")
    dataset = database.CreateDataset("Customers")
    while dataset.MoveNext():
        values = dataset.Values
        # ...
    dataset.CloseDataset()
  

    new_dataset = dataset.CreateDataset(filter = "[City]='New York'")
  

Properties

Name

Readonly

Type

Description

BOF

No

Boolean

Returns True if the current record position is before the first record in the dataset, otherwise returns False.

Set this property to True to move the cursor to the beginning of the dataset. Setting this property to False is ignored.

DefaultValues

Yes

Dictionary service

Returns a Dictionary with the default values used for each field in the dataset. The fields or columns in the dataset are the keys in the dictionary.

The database field types are converted to their corresponding Basic/Python data types. When the field type is undefined, the default value is Null if the field is nullable or Empty.

EOF

No

Boolean

Returns True if the current record position is after the last record in the dataset, otherwise returns False.

Set this property to True to move the cursor to the end of the dataset. Setting this property to False is ignored.

Fields

Yes

Array

Returns an Array containing the names of all fields in the dataset.

Filter

Yes

String

Returns the filter applied in addition to the eventual WHERE clause(s) in the initial SQL statement. This property is expressed as a WHERE clause without the "WHERE" keyword.

OrderBy

Yes

String

Returns the ordering clause that replaces the eventual ORDER BY clause present in the initial SQL statement. This property is expressed as a ORDER BY clause without the "ORDER BY" keywords.

ParentDatabase

Yes

Database service

Returns the Database instance corresponding to the parent database of the current dataset.

RowCount

Yes

Long

Returns the exact number of records in the dataset.

Note that the evaluation of this property implies browsing the whole dataset, which may be costly depending on the dataset size.

RowNumber

Yes

Long

Returns the number of the current record starting at 1. Returns 0 if this property is unknown.

Source

Yes

String

Returns the source of the dataset. It can be either a table name, a query name or a SQL statement.

SourceType

ແມ່ນ

String

ສົ່ງຄືນແຫຼ່ງທີ່ມາຂອງຊຸດຂໍ້ມູນ. ມັນສາມາດເປັນຄ່າສະຕຣິງໃດໜຶ່ງດັ່ງນີ້: TABLE, QUERY ຫຼື SQL.

UpdatableFields

ແມ່ນ

Array

ສົ່ງຄືນ Array ທີ່ບັນຈຸຊື່ຂອງຟິວໃນຊຸດຂໍ້ມູນທີ່ສາມາດອັບເດດໄດ້.

Values

ແມ່ນ

Array

ສົ່ງຄືນ Dictionary ທີ່ບັນຈຸຄູ່ຂອງ (ຊື່ຟິວ: ຄ່າ) ຂອງຂໍ້ມູນປັດຈຸບັນໃນຊຸດຂໍ້ມູນ.

XRowSet

ແມ່ນ

ອັອບເຈັກ UNO

ສົ່ງຄືນອັອບເຈັກ UNO com.sun.star.sdb.RowSet ທີ່ສະແດງເຖິງຊຸດຂໍ້ມູນ.


ລາຍຊື່ວິທີການໃນບໍລິການ Dataset

CloseDataset
CreateDataset
Delete
ExportValueToFile
GetRows

GetValue
Insert
MoveFirst
MoveLast

MoveNext
MovePrevious
Reload
Update


CloseDataset

ປິດຊຸດຂໍ້ມູນປັດຈຸບັນ. ວິທີນີ້ຈະສົ່ງຄືນຄ່າ True ເມື່ອສຳເລັດ.

note

ແນະນຳໃຫ້ປິດຊຸດຂໍ້ມູນຫຼັງຈາກການນຳໃຊ້ ເພື່ອຄືນຊັບພະຍາກອນໃຫ້ລະບົບ.


ໄວຍາກອນ:

svc.CloseDataset(): bool

ຕົວຢ່າງ:

ໃນ Basic

      oDataset = oDatabase.CreateDataset("MyTable")
      ' ...
      oDataset.CloseDataset()
    
ໃນ Python

      dataset = database.CreateDataset("MyTable")
      # ...
      dataset.CloseDataset()
    

CreateDataset

ສົ່ງຄືນອິນສະແຕນຊ໌ບໍລິການ Dataset ຈາກຊຸດຂໍ້ມູນທີ່ມີຢູ່ ໂດຍການນຳໃຊ້ຕົວຕອງທີ່ລະບຸ ແລະ ຄຳສັ່ງ ORDER BY.

ໄວຍາກອນ:

svc.CreateDataset(opt filter: str, opt orderby: str): svc

ພາຣາມິເຕີ:

filter: ລະບຸເງື່ອນໄຂທີ່ລະບຽບຂໍ້ມູນຕ້ອງກົງກັນ ເພື່ອໃຫ້ລວມຢູ່ໃນຊຸດຂໍ້ມູນທີ່ສົ່ງຄືນ. ອາຄິວເມັ້ນນີ້ແມ່ນສະແດງອອກເປັນຄຳສັ່ງ SQL WHERE ໂດຍບໍ່ຕ້ອງມີຄຳຫຼັກ "WHERE". ຖ້າບໍ່ໄດ້ລະບຸອາຄິວເມັ້ນນີ້, ຕົວຕອງທີ່ໃຊ້ໃນຊຸດຂໍ້ມູນປັດຈຸບັນຈະຖືກນຳໃຊ້, ຖ້າບໍ່ດັ່ງນັ້ນ ຕົວຕອງປັດຈຸບັນຈະຖືກແທນທີ່ດ້ວຍອາຄິວເມັ້ນນີ້.

orderby: ລະບຸການຈັດລຽງຂອງຊຸດຂໍ້ມູນເປັນຄຳສັ່ງ SQL ORDER BY ໂດຍບໍ່ຕ້ອງມີຄຳຫຼັກ "ORDER BY". ຖ້າບໍ່ໄດ້ລະບຸອາຄິວເມັ້ນນີ້, ລຳດັບການຈັດລຽງທີ່ໃຊ້ໃນຊຸດຂໍ້ມູນປັດຈຸບັນຈະຖືກນຳໃຊ້, ຖ້າບໍ່ດັ່ງນັ້ນ ລຳດັບການຈັດລຽງປັດຈຸບັນຈະຖືກແທນທີ່ດ້ວຍອາຄິວເມັ້ນນີ້.

ຕົວຢ່າງ:

ໃນ Basic

      ' ໃຊ້ຂໍ້ຄວາມວ່າງ (empty string) ເພື່ອລຶບຕົວຕອງປັດຈຸບັນອອກ
      oNewDataset = oDataset.CreateDataset(Filter := "")
      ' ຕົວຢ່າງຂອງຕົວຕອງທົ່ວໄປ
      oNewDataset = oDataset.CreateDataset(Filter := "[Name] = 'John'")
      oNewDataset = oDataset.CreateDataset(Filter := "[Name] LIKE 'A'")
      ' ສາມາດເພີ່ມເງື່ອນໄຂເພີ່ມເຕີມເຂົ້າໃນຕົວຕອງປັດຈຸບັນໄດ້
      oNewDataset = oDataset.CreateDataset(Filter := "(" & oDataset.Filter & ") AND [Name] LIKE 'A'")
    
ໃນ Python

      new_dataset = dataset.CreateDataset(filter = "")
      new_dataset = dataset.CreateDataset(filter = "[Name] = 'John'")
      new_dataset = dataset.CreateDataset(filter = "[Name] LIKE 'A'")
      new_dataset = dataset.CreateDataset(filter = f"({dataset.Filter}) AND [Name] LIKE 'A'")
    

Delete

ລຶບລະບຽບຂໍ້ມູນປັດຈຸບັນອອກຈາກຊຸດຂໍ້ມູນ. ວິທີນີ້ຈະສົ່ງຄືນຄ່າ True ເມື່ອສຳເລັດ.

ຫຼັງຈາກການປະຕິບັດງານນີ້, ເຄີເຊີ (cursor) ຈະຖືກຍ້າຍໄປທີ່ລະບຽບຂໍ້ມູນຖັດຈາກອັນທີ່ຖືກລຶບ. ຖ້າລະບຽບຂໍ້ມູນທີ່ຖືກລຶບນັ້ນແມ່ນອັນສຸດທ້າຍໃນຊຸດຂໍ້ມູນ, ເຄີເຊີຈະຖືກຍ້າຍໄປໄວ້ຫຼັງຈາກນັ້ນ ແລະ ຄຸນສົມບັດ EOF ຈະສົ່ງຄືນຄ່າ True.

ໄວຍາກອນ:

svc.Delete(): bool

ຕົວຢ່າງ:

ໃນ Basic

      oDataset.Delete()
    
ໃນ Python

      dataset.Delete()
    

ExportValueToFile

ສົ່ງອອກຄ່າຂອງຟີວ (field) ຖານສອງຂອງລະບຽບຂໍ້ມູນປັດຈຸບັນໄປຍັງໄຟລ໌ທີ່ລະບຸ.

note

ຖ້າຟີວທີ່ລະບຸບໍ່ແມ່ນຖານສອງ ຫຼື ບໍ່ມີຂໍ້ມູນ, ໄຟລ໌ຜົນລັບຈະບໍ່ຖືກສ້າງຂຶ້ນ.


ໄວຍາກອນ:

svc.ExportValueToFile(fieldname: str, filename: str, overwrite: bool): bool

ພາຣາມິເຕີ:

fieldname: ຊື່ຂອງຟີວຖານສອງທີ່ຈະສົ່ງອອກ, ເປັນຂໍ້ຄວາມທີ່ແຍກຕົວອັກສອນນ້ອຍ-ໃຫຍ່.

filename: ເສັ້ນທາງເຕັມຂອງໄຟລ໌ທີ່ຈະສ້າງຂຶ້ນ ໂດຍໃຊ້ຮູບແບບທີ່ກຳນົດໄວ້ໃນຄຸນສົມບັດ FileSystem.FileNaming.

overwrite: ຕັ້ງອາຄິວເມັ້ນນີ້ເປັນ True ເພື່ອອະນຸຍາດໃຫ້ຂຽນທັບໄຟລ໌ປາຍທາງ (ຄ່າເລີ່ມຕົ້ນ = False).

ຕົວຢ່າງ:

ໃນຕົວຢ່າງລຸ່ມນີ້, ຊຸດຂໍ້ມູນມີຟີວທີ່ຊື່ວ່າ "Picture" ເຊິ່ງຈະຖືກສົ່ງອອກເປັນໄຟລ໌ຮູບພາບ.

ໃນ Basic

      oDataset.ExportValueToFile("Picture", "C:\my_image.png", True)
    
ໃນ Python

      dataset.ExportValueToFile("Picture", r"C:\my_image.png", True)
    

GetRows

ສົ່ງຄືນເນື້ອໃນຂອງຊຸດຂໍ້ມູນໃນຮູບແບບອາເຣ 2 ມິຕິ, ເເລີ່ມຈາກລະບຽບຂໍ້ມູນທຳອິດຖັດຈາກລະບຽບຂໍ້ມູນປັດຈຸບັນ.

ຫຼັງຈາກການປະຕິບັດ, ເຄີເຊີຈະຖືກຍ້າຍໄປທີ່ແຖວທີ່ອ່ານຫຼ້າສຸດ ຫຼື ຫຼັງລະບຽບຂໍ້ມູນສຸດທ້າຍໃນຊຸດຂໍ້ມູນ, ໃນກໍລະນີນັ້ນ ຄຸນສົມບັດ EOF ຈະສົ່ງຄືນຄ່າ True.

ວິທີນີ້ສາມາດໃຊ້ເພື່ອອ່ານຂໍ້ມູນຈາກຊຸດຂໍ້ມູນເປັນຊຸດໆ, ເຊິ່ງຂະໜາດແມ່ນກຳນົດໂດຍອາຄິວເມັ້ນ maxrows.

note

ອາເຣທີ່ສົ່ງຄືນຈະມີສອງມິຕິສະເໝີ, ເຖິງແມ່ນວ່າຊຸດຂໍ້ມູນຈະມີພຽງຄໍລຳດຽວ ແລະ ລະບຽບຂໍ້ມູນດຽວກໍຕາມ.


ໄວຍາກອນ:

svc.GetRows(header: bool, maxrows: int): any

ພາຣາມິເຕີ:

header: ຕັ້ງອາຄິວເມັ້ນນີ້ເປັນ True ເພື່ອໃຫ້ລາຍການທຳອິດໃນ Array ເປັນຫົວຄໍລຳ (ຄ່າເລີ່ມຕົ້ນ = False).

maxrows: ກຳນົດຈຳນວນລະບຽບຂໍ້ມູນສູງສຸດທີ່ຈະສົ່ງຄືນ. ຖ້າຈຳນວນລະບຽບຂໍ້ມູນທີ່ມີຢູ່ໜ້ອຍກວ່າ maxrows, ຂະໜາດຂອງອາເຣທີ່ສົ່ງຄືນຈະເທົ່າກັບຈຳນວນລະບຽບຂໍ້ມູນທີ່ເຫຼືອໃນຊຸດຂໍ້ມູນ. ປະອາຄິວເມັ້ນນີ້ໄວ້ວ່າງ ຫຼື ຕັ້ງເປັນສູນ ເພື່ອສົ່ງຄືນທຸກແຖວໃນຊຸດຂໍ້ມູນ (ຄ່າເລີ່ມຕົ້ນ = 0)

ຕົວຢ່າງ:

ຕົວຢ່າງຕໍ່ໄປນີ້ອ່ານຊຸດຂໍ້ມູນເທື່ອລະ 100 ແຖວ ຈົນກວ່າຈະອ່ານຊຸດຂໍ້ມູນທັງໝົດສຳເລັດ.

ໃນ Basic

      Dim arrChunk As Variant, lMaxRows As Long
      lMaxRows = 100
      Do
          arrChunk = oDataset.GetRows(MaxRows := lMaxRows)
          If UBound(arrChunk, 1) >= 0 Then
              ' ...
          End If
      Loop Until UBound(arrChunk, 1) < lMaxRows - 1
    
ໃນ Python

      max_rows = 100
      chunk = dataset.GetRows(maxrows = max_rows)
      while len(chunk) > 0:
          # ...
          chunk = dataset.GetRows(maxrows = max_rows)
    

GetValue

ສົ່ງຄືນຄ່າຂອງຟີວທີ່ລະບຸຈາກລະບຽບຂໍ້ມູນປັດຈຸບັນຂອງຊຸດຂໍ້ມູນ.

note

ຖ້າຟີວທີ່ລະບຸເປັນຖານສອງ, ມັນຈະສົ່ງຄືນຄວາມຍາວຂອງມັນ.


ໄວຍາກອນ:

svc.GetValue(fieldname: str): any

ພາຣາມິເຕີ:

fieldname: ຊື່ຂອງຟີວທີ່ຈະສົ່ງຄືນ, ເປັນຂໍ້ຄວາມທີ່ແຍກຕົວອັກສອນນ້ອຍ-ໃຫຍ່.

ຕົວຢ່າງ:

ໃນ Basic

      currId = oDataset.GetValue(FieldName := "ID")
    
ໃນ Python

      curr_id = dataset.GetValue(fieldname = "ID")
    

Insert

ແຊກລະບຽບຂໍ້ມູນໃໝ່ໃສ່ທ້າຍຊຸດຂໍ້ມູນ ແລະ ຕັ້ງຄ່າເລີ່ມຕົ້ນໃຫ້ຟີວຕ່າງໆດ້ວຍຄ່າທີ່ລະບຸ.

ຖ້າຄີຫຼັກ (primary key) ຂອງຊຸດຂໍ້ມູນເປັນຄ່າອັດຕະໂນມັດ, ວິທີນີ້ຈະສົ່ງຄືນຄ່າຄີຫຼັກຂອງລະບຽບຂໍ້ມູນໃໝ່. ຖ້າບໍ່ດັ່ງນັ້ນ, ມັນຈະສົ່ງຄືນ 0 (ເມື່ອສຳເລັດ) ຫຼື -1 (ເມື່ອບໍ່ສຳເລັດ).

note

ຟີວທີ່ສາມາດອັບເດດໄດ້ໂດຍບໍ່ມີການລະບຸຄ່າ ຈະຖືກຕັ້ງເປັນຄ່າເລີ່ມຕົ້ນຂອງພວກມັນ.


note

ຖ້າຟີວທີ່ລະບຸເປັນຖານສອງ, ມັນຈະສົ່ງຄືນຄວາມຍາວຂອງມັນ.


ໄວຍາກອນ:

svc.Insert(pvargs: any): int

ພາຣາມິເຕີ:

pvargs: Dictionary ທີ່ບັນຈຸຄູ່ຂອງຊື່ຟີວ ແລະ ຄ່າຂອງພວກມັນ. ຫຼື ສາມາດລະບຸອາຄິວເມັ້ນເປັນຈຳນວນຄູ່ ໂດຍສະຫຼັບກັນລະຫວ່າງຊື່ຟີວ (ເປັນ String) ແລະ ຄ່າຂອງພວກມັນ.

ຕົວຢ່າງ:

ໃນ Basic

ສົມມຸດວ່າມີຕາຕະລາງຊື່ "Customers" ທີ່ມີ 4 ຟີວ: "ID" (BigInt, ຄ່າອັດຕະໂນມັດ ແລະ ຄີຫຼັກ), "Name" (VarChar), "Age" (Integer), "City" (VarChar).

ຕົວຢ່າງລຸ່ມນີ້ແຊກລະບຽບຂໍ້ມູນໃໝ່ໃສ່ຊຸດຂໍ້ມູນນີ້ໂດຍໃຊ້ Dictionary.


      oDataset = oDatabase.CreateDataset("Customers")
      oNewData = CreateScriptService("Dictionary")
      oNewData.Add("Name", "John")
      oNewData.Add("Age", 50)
      oNewData.Add("City", "Chicago")
      lNewID = oDataset.Insert(oNewData)
    

ຜົນລັບດຽວກັນສາມາດເຮັດໄດ້ໂດຍການສົ່ງຄູ່ຂອງຟີວ ແລະ ຄ່າທັງໝົດເປັນອາຄິວເມັ້ນ:


      oDataset.Insert("Name", "John", "Age", 50, "City", "Chicago")
    
ໃນ Python

      dataset = database.CreateDataset("Customers")
      new_data = {"Name": "John", "Age": 30, "City": "Chicago"}
      new_id = dataset.Insert(new_data)
    

ການເອີ້ນໃຊ້ຕໍ່ໄປນີ້ແມ່ນຮອງຮັບໃນ Python:


      dataset.Insert("Name", "John", "Age", 50, "City", "Chicago")
      dataset.Insert(Name = "John", Age = 50, City = "Chicago")
    

MoveFirst / MoveLast

ຍ້າຍເຄີເຊີຂອງຊຸດຂໍ້ມູນໄປທີ່ລະບຽບຂໍ້ມູນທຳອິດ (ດ້ວຍ MoveFirst) ຫຼື ໄປທີ່ລະບຽບຂໍ້ມູນສຸດທ້າຍ (ດ້ວຍ MoveLast).

ວິທີການນີ້ສົ່ງຄືນ True ເມື່ອສຳເລັດ.

note

ລະບຽບຂໍ້ມູນທີ່ຖືກລຶບຈະຖືກລະເລີຍໂດຍວິທີນີ້.


ໄວຍາກອນ:

svc.MoveFirst(): bool

svc.MoveLast(): bool

ຕົວຢ່າງ:

ໃນ Basic

      oDataset.MoveFirst()
    
ໃນ Python

      dataset.MoveFirst()
    

MoveNext / MovePrevious

ຍ້າຍເຄີເຊີຂອງຊຸດຂໍ້ມູນໄປຂ້າງໜ້າ (ດ້ວຍ MoveNext) ຫຼື ຖອຍຫຼັງ (ດ້ວຍ MovePrevious) ຕາມຈຳນວນລະບຽບຂໍ້ມູນທີ່ກຳນົດ.

ວິທີນີ້ຈະສົ່ງຄືນຄ່າ True ເມື່ອສຳເລັດ.

note

ລະບຽບຂໍ້ມູນທີ່ຖືກລຶບຈະຖືກລະເລີຍໂດຍວິທີນີ້.


ໄວຍາກອນ:

svc.MoveNext(offset: int = 1): bool

svc.MovePrevious(offset: int = 1): bool

ພາຣາມິເຕີ:

offset: ຈຳນວນລະບຽບຂໍ້ມູນທີ່ເຄີເຊີຈະຍ້າຍໄປຂ້າງໜ້າ ຫຼື ຖອຍຫຼັງ. ອາຄິວເມັ້ນນີ້ສາມາດເປັນຄ່າລົບໄດ້ (ຄ່າເລີ່ມຕົ້ນ = 1).

ຕົວຢ່າງ:

ໃນ Basic

      oDataset.MoveNext()
      oDataset.MoveNext(5)
    
ໃນ Python

      dataset.MoveNext()
      dataset.MoveNext(5)
    

Reload

ໂຫຼດຊຸດຂໍ້ມູນຄືນໃໝ່ຈາກຖານຂໍ້ມູນ. ສາມາດກຳນົດຄຸນສົມບັດ Filter ແລະ OrderBy ໄດ້ເມື່ອເອີ້ນໃຊ້ວິທີນີ້.

ວິທີນີ້ຈະສົ່ງຄືນຄ່າ True ເມື່ອສຳເລັດ.

tip

ການໂຫຼດຊຸດຂໍ້ມູນຄືນໃໝ່ມີປະໂຫຍດເມື່ອມີການແຊກ ຫຼື ລຶບລະບຽບຂໍ້ມູນອອກຈາກຖານຂໍ້ມູນ. ໝາຍເຫດວ່າ ວິທີ CreateDataset ແລະ Reload ເຮັດວຽກຄ້າຍຄືກັນ, ແຕ່ Reload ຈະນຳໃຊ້ອິນສະແຕນຊ໌ຄລາສ Dataset ເດີມຄືນໃໝ່.


ໄວຍາກອນ:

svc.Reload(opt filter: str, opt orderby: str): bool

ພາຣາມິເຕີ:

filter: ລະບຸເງື່ອນໄຂທີ່ລະບຽບຂໍ້ມູນຕ້ອງກົງກັນ ເພື່ອໃຫ້ລວມຢູ່ໃນຊຸດຂໍ້ມູນທີ່ສົ່ງຄືນ. ອາຄິວເມັ້ນນີ້ແມ່ນສະແດງອອກເປັນຄຳສັ່ງ SQL WHERE ໂດຍບໍ່ຕ້ອງມີຄຳຫຼັກ "WHERE". ຖ້າບໍ່ໄດ້ລະບຸອາຄິວເມັ້ນນີ້, ຕົວຕອງທີ່ໃຊ້ໃນຊຸດຂໍ້ມູນປັດຈຸບັນຈະຖືກນຳໃຊ້, ຖ້າບໍ່ດັ່ງນັ້ນ ຕົວຕອງປັດຈຸບັນຈະຖືກແທນທີ່ດ້ວຍອາຄິວເມັ້ນນີ້.

orderby: ລະບຸການຈັດລຽງຂອງຊຸດຂໍ້ມູນເປັນຄຳສັ່ງ SQL ORDER BY ໂດຍບໍ່ຕ້ອງມີຄຳຫຼັກ "ORDER BY". ຖ້າບໍ່ໄດ້ລະບຸອາຄິວເມັ້ນນີ້, ລຳດັບການຈັດລຽງທີ່ໃຊ້ໃນຊຸດຂໍ້ມູນປັດຈຸບັນຈະຖືກນຳໃຊ້, ຖ້າບໍ່ດັ່ງນັ້ນ ລຳດັບການຈັດລຽງປັດຈຸບັນຈະຖືກແທນທີ່ດ້ວຍອາຄິວເມັ້ນນີ້.

ຕົວຢ່າງ:

ໃນ Basic

      oDataset.Reload()
      oDataset.Reload(Filter := "[Name] = 'John'", OrderBy := "Age")
    
ໃນ Python

      dataset.Reload()
      dataset.Reload(Filter = "[Name] = 'John'", OrderBy = "Age")
    

Update

ອັບເດດຄ່າຂອງຟີວທີ່ລະບຸໃນລະບຽບຂໍ້ມູນປັດຈຸບັນ.

ວິທີນີ້ຈະສົ່ງຄືນຄ່າ True ເມື່ອສຳເລັດ.

ໄວຍາກອນ:

svc.Update(pvargs: any): bool

ພາຣາມິເຕີ:

pvargs: Dictionary ທີ່ບັນຈຸຄູ່ຂອງຊື່ຟີວ ແລະ ຄ່າຂອງພວກມັນ. ຫຼື ສາມາດລະບຸອາຄິວເມັ້ນເປັນຈຳນວນຄູ່ ໂດຍສະຫຼັບກັນລະຫວ່າງຊື່ຟີວ (ເປັນ String) ແລະ ຄ່າຂອງພວກມັນ.

ຕົວຢ່າງ:

ໃນ Basic

ຕົວຢ່າງລຸ່ມນີ້ອັບເດດລະບຽບຂໍ້ມູນປັດຈຸບັນໂດຍໃຊ້ Dictionary.


      oNewValues = CreateScriptService("Dictionary")
      oNewValues.Add("Age", 51)
      oNewValues.Add("City", "New York")
      oDataset.Update(oNewValues)
    

ຜົນລັບດຽວກັນສາມາດເຮັດໄດ້ໂດຍການສົ່ງຄູ່ຂອງຟີວ ແລະ ຄ່າທັງໝົດເປັນອາຄິວເມັ້ນ:


      oDataset.Update("Age", 51, "City", "New York")
    
ໃນ Python

      new_values = {"Age": 51, "City": "New York"}
      dataset.Update(new_values)
    

      dataset.Update("Age", 51, "City", "New York")
      dataset.Update(Age = 51, City = "New York")
    
warning

ຣູທີນ ຫຼື ຕົວລະບຸ Basic ຂອງ ScriptForge ທັງໝົດທີ່ຂຶ້ນຕົ້ນດ້ວຍເຄື່ອງໝາຍຂີດກ້ອງ "_" ແມ່ນສະຫງວນໄວ້ສຳລັບໃຊ້ພາຍໃນ. ພວກມັນບໍ່ໄດ້ມີໄວ້ໃຫ້ໃຊ້ໃນມາໂຄຣ Basic ຫຼື ສະຄຣິບ Python.