Dynamics 365 Business Central: การใช้งาน Dictionary Data Type ใน AL Programming

Dictionary ใน AL Programming เป็นชนิดข้อมูลที่ใช้สำหรับเก็บและจัดการข้อมูลที่มีความสัมพันธ์กันระหว่างตัวระบุ (Key) และข้อมูลที่เกี่ยวข้อง (Value) โดยที่ตัวระบุ (Key) จะต้องไม่ซ้ำกันภายใน Dictionary ซึ่งช่วยให้สามารถค้นหาและเข้าถึงข้อมูลได้อย่างรวดเร็วและมีประสิทธิภาพ การใช้งาน Dictionary เหมาะสำหรับสถานการณ์ที่ต้องการจัดการข้อมูลจำนวนมากที่สามารถอ้างอิงได้โดยใช้ตัวระบุเฉพาะ ทำให้การเพิ่ม, ลบ, แก้ไข, และดึงข้อมูลเป็นไปได้อย่างสะดวกและยืดหยุ่น Dictionary เป็นเครื่องมือที่ทรงพลังใน AL Programming ที่ช่วยให้นักพัฒนาสามารถสร้างระบบที่มีการจัดการข้อมูลอย่างมีประสิทธิภาพและมีความยืดหยุ่นสูง

รายละเอียดของแต่ละ Method พร้อมตัวอย่าง และการใช้งาน

1. Add(TKey, TValue)

คำอธิบาย: Method นี้ใช้ในการเพิ่มข้อมูลเข้าไปใน Dictionary โดยข้อมูลนี้จะถูกเก็บในรูปแบบที่มีตัวระบุ (Key) และค่าที่เกี่ยวข้อง (Value) หากตัวระบุตัวนี้มีอยู่แล้วใน Dictionary จะเกิดข้อผิดพลาด

ตัวอย่าง

การใช้งาน

ในตัวอย่างนี้ AddToDictionary จะเพิ่มข้อมูลใหม่ 1: 'Apple' และ 2: 'Banana' ลงใน Dictionary

2. ContainsKey(TKey)

คำอธิบาย: Method นี้ใช้ในการตรวจสอบว่าตัวระบุ (Key) ที่กำหนดมีอยู่ใน Dictionary หรือไม่ ถ้ามีจะคืนค่าเป็น true ถ้าไม่มีจะคืนค่าเป็น false

ตัวอย่าง

การใช้งาน

ในตัวอย่างนี้ CheckKeyExists จะตรวจสอบว่ามีตัวระบุ 1 และ 3 อยู่ใน Dictionary หรือไม่

3. Count()

คำอธิบาย: Method นี้ใช้ในการนับจำนวนรายการข้อมูลทั้งหมดใน Dictionary

ตัวอย่าง

การใช้งาน

ในตัวอย่างนี้ GetDictionaryCount จะคืนค่าจำนวนรายการข้อมูลใน Dictionary

4. Get(TKey, var TValue)

คำอธิบาย: Method นี้ใช้ในการดึงข้อมูลออกจาก Dictionary โดยใช้ตัวระบุ (Key) ที่กำหนด หากตัวระบุตัวนี้มีอยู่ ข้อมูลที่เกี่ยวข้อง (Value) จะถูกดึงออกมา และคืนค่าเป็น true มิฉะนั้นจะคืนค่าเป็น false

ตัวอย่าง

การใช้งาน

ในตัวอย่างนี้ GetValueFromDictionary จะดึงค่า Apple ออกมาเมื่อระบุคีย์ 1

5. Get(TKey)

คำอธิบาย: Method นี้คล้ายกับ Get(TKey, var TValue) แต่จะคืนค่าที่ตรงกับตัวระบุ (Key) ที่กำหนดโดยตรง โดยไม่ต้องใช้ตัวแปรส่งออก

ตัวอย่าง

การใช้งาน

ในตัวอย่างนี้ GetValueDirectFromDictionary จะดึงค่า Apple ออกมาเมื่อระบุคีย์ 1 และคืนค่ากลับมาโดยตรง

6. Keys()

คำอธิบาย: Method นี้ใช้ในการดึงรายการตัวระบุ (Key) ทั้งหมดที่มีอยู่ใน Dictionary

ตัวอย่าง

การใช้งาน

ในตัวอย่างนี้ GetAllKeys จะดึงรายการตัวระบุทั้งหมดใน Dictionary และแสดงผลคีย์แต่ละตัว

7. Remove(TKey)

คำอธิบาย: Method นี้ใช้ในการลบข้อมูลที่ตรงกับตัวระบุ (Key) ที่กำหนดออกจาก Dictionary

ตัวอย่าง

การใช้งาน

ในตัวอย่างนี้ RemoveFromDictionary จะลบข้อมูล 1: 'Apple' ออกจาก Dictionary

8. Set(TKey, TValue)

คำอธิบาย: Method นี้ใช้ในการเปลี่ยนหรือเพิ่มข้อมูลใน Dictionary โดยใช้ตัวระบุ (Key) ที่กำหนด หากตัวระบุ (Key) มีอยู่แล้ว ข้อมูลที่เกี่ยวข้อง (Value) จะถูกแทนที่ด้วยค่าที่ใหม่

ตัวอย่าง

การใช้งาน

ในตัวอย่างนี้ SetDictionaryValue จะเปลี่ยนค่าที่คีย์ 1 จาก Apple เป็น Orange

9. Set(TKey, TValue, var TValue)

คำอธิบาย: Method นี้ใช้ในการเปลี่ยนหรือเพิ่มข้อมูลใน Dictionary โดยใช้ตัวระบุ (Key) ที่กำหนด และยังคืนค่าข้อมูลเก่าที่ถูกแทนที่กลับมา

ตัวอย่าง

การใช้งาน

ในตัวอย่างนี้ SetDictionaryValueWithOld จะเปลี่ยนค่าที่คีย์ 1 จาก Apple เป็น Orange และคืนค่าเดิม Apple กลับมา

10. Values()

คำอธิบาย: Method นี้ใช้ในการดึงค่าข้อมูลทั้งหมดที่มีอยู่ใน Dictionary

ตัวอย่าง

การใช้งาน

ในตัวอย่างนี้ GetAllValues จะดึงค่าข้อมูลทั้งหมดใน Dictionary และแสดงผลค่าแต่ละตัว

ตัวอย่างเพิ่มเติม

คำอธิบาย

  • VendorLedgerEntry.SetRange(“Open”, true);: กำหนดให้เลือกเฉพาะรายการที่ยังไม่ถูกปิด (Open Entries)
  • VendorOutstandingDict.ContainsKey(VendorNo): ตรวจสอบว่ามี Vendor No. อยู่ใน Dictionary แล้วหรือไม่
  • VendorOutstandingDict.Set(VendorNo, OutstandingAmount);: อัปเดตยอดค้างชำระรวมสำหรับผู้ขายที่มีอยู่ใน Dictionary
  • VendorOutstandingDict.Add(VendorNo, VendorLedgerEntry.Amount);: เพิ่มผู้ขายใหม่พร้อมยอดค้างชำระเข้าไปใน Dictionary

สรุป

การใช้งาน Dictionary ใน AL Programming ช่วยให้คุณสามารถจัดการข้อมูลที่ต้องการเข้าถึงอย่างรวดเร็วและมีประสิทธิภาพ การใช้ Method ต่าง ๆ ที่มีใน Dictionary ช่วยให้สามารถเพิ่ม, ลบ, อัปเดต, และดึงข้อมูลได้อย่างสะดวกและมีประสิทธิภาพ ซึ่งทำให้การพัฒนาแอปพลิเคชันที่มีการจัดการข้อมูลจำนวนมากเป็นไปได้อย่างมีประสิทธิภาพและยืดหยุ่น

Leave a comment