VB.NET වලින් PDF ගොනු සෑදීමේ මූලික ක්‍රම

VB.NET යෙදුමකින් PDF ගොනුවක් සෑදීම වාර්තා, ඉන්වොයිස්, ලකුණු පත්‍ර, සහ මුද්‍රණයට සුදුසු ලේඛන ස්වයංක්‍රීයව සකස් කිරීමට ප්‍රයෝජනවත් වේ. පරිශීලකයා පෝරමයකට ඇතුළත් කරන තොරතුරු PDF ආකාරයට සුරැකීම මෙහි සාමාන්‍ය භාවිතයකි.

PDF සෑදීමට VB.NET තුළ සෘජු, සම්පූර්ණ පහසුකමක් නොමැති නිසා බාහිර පුස්තකාලයක් භාවිත කළ යුතුය. iTextSharp සහ PdfSharp වැනි පුස්තකාල ආරම්භකයන්ට හොඳ විකල්ප වන අතර, පෙළ, රූප, වගු සහ පිටු සැකසීමට ඒවා උපකාරී වේ.

ගොනු සැකසීමේ මූලික සංකල්ප හොඳින් තේරුම් ගැනීම වැදගත්ය. Arduino වැනි ව්‍යාපෘතිවල දත්ත සටහන් කර පසුව වාර්තාවක් ලෙස PDF කිරීමේදීද මේ දැනුම භාවිත කළ හැක. ඒ සඳහා Arduino පාඩම් සමඟ ගොනු සහ දත්ත හැසිරවීමේ මූලික කරුණුද අධ්‍යයනය කළ හැක.

අවශ්‍ය පුස්තකාලය තෝරා ගැනීම

සරල PDF ලේඛන සඳහා iTextSharp බොහෝ VB.NET ඉගෙනුම්කරුවන් භාවිත කරන පුස්තකාලයකි. Visual Studio හි NuGet Package Manager විවෘත කර iTextSharp යන පැකේජය ස්ථාපනය කළ පසු එහි පන්ති ව්‍යාපෘතියට ලබාගත හැක.

නව ව්‍යාපෘතියක් ආරම්භ කරන විට .NET Framework අනුවාදය සහ පුස්තකාලයේ ගැළපීම පරීක්ෂා කරන්න. පැකේජ ස්ථාපනයේදී ඇතිවන දෝෂ සොයා බැලීමට තාක්ෂණික ලිපි එකතුව වැනි වෙබ් සම්පත්ද භාවිත කළ හැකි නමුත්, කේතය ක්‍රියාත්මක කිරීමට පෙර එහි බලපත්‍ර සහ අනුවාද විස්තර පරීක්ෂා කිරීම සුදුසුය.

සරල PDF ගොනුවක් සෑදීම

පළමුව Document වස්තුවක් සහ PdfWriter වස්තුවක් සකස් කළ යුතුය. FileStream මඟින් නව PDF ගොනුව සුරැකෙන ස්ථානය සඳහන් කරයි. පහත උදාහරණය කෙටි පෙළක් සහිත PDF එකක් සාදයි.

Imports System.IO
Imports iTextSharp.text
Imports iTextSharp.text.pdf

Dim filePath As String = "C:\Reports\sample.pdf"

Using stream As New FileStream(filePath, FileMode.Create)
    Dim document As New Document(PageSize.A4)
    PdfWriter.GetInstance(document, stream)

    document.Open()
    document.Add(New Paragraph("VB.NET PDF වාර්තාව"))
    document.Add(New Paragraph("මෙය සරල උදාහරණයකි."))
    document.Close()
End Using

Document විවෘත නොකර පෙළ එක් කළහොත් දෝෂයක් ඇති වේ. එසේම, අවසානයේ Close() ක්‍රමය කැඳවීම අමතක කළහොත් ගොනුව සම්පූර්ණයෙන් සුරැකී නොතිබිය හැක.

අකුරු සහ සිංහල පෙළ

PDF පුස්තකාල බොහෝවිට පෙරනිමියෙන් ලතින් අකුරු පමණක් පෙන්වයි. සිංහල පෙළ නිවැරදිව පෙන්වීමට සිංහල අකුරු සහිත .ttf ෆොන්ටයක් තෝරාගෙන එය BaseFont මඟින් ලියාපදිංචි කළ යුතුය. Noto Sans Sinhala වැනි ෆොන්ටයක් මේ සඳහා භාවිත කළ හැක.

ෆොන්ටය PDF තුළ ඇතුළත් කිරීම වැදගත්ය. එසේ නොකළහොත් වෙනත් පරිගණකයකදී අකුරු කොටු හෝ වැරදි සංකේත ලෙස දිස්විය හැක. ෆොන්ටයේ මාර්ගය නිවැරදිද, ගොනුවට කියවීමේ අවසර තිබේද යන්නද පරීක්ෂා කරන්න.

මාතෘකා සහ හැඩතල යෙදීම

වාර්තාවක් වඩාත් පැහැදිලි කිරීමට වෙනස් ෆොන්ට් ප්‍රමාණ, තද අකුරු සහ වර්ණ යොදාගත හැක. FontFactory හෝ Font පන්තිය මඟින් මාතෘකාවට විශාල ප්‍රමාණයක්ද, සාමාන්‍ය පෙළට කුඩා ප්‍රමාණයක්ද සකස් කළ හැක.

Dim titleFont As Font = FontFactory.GetFont(
    FontFactory.HELVETICA_BOLD, 18, BaseColor.BLUE)

Dim bodyFont As Font = FontFactory.GetFont(
    FontFactory.HELVETICA, 11, BaseColor.BLACK)

document.Add(New Paragraph("මාසික වාර්තාව", titleFont))
document.Add(New Paragraph("ගෙවීම් සහ විකුණුම් විස්තර මෙහි ඇතුළත් වේ.", bodyFont))

නිර්මාණාත්මක වාර්තා සකස් කරන අය සඳහා CorelDRAW මූලික පාඩම් ද ප්‍රයෝජනවත් විය හැක. PDF තුළ ඇතුළත් කරන ලාංඡන, රූප සහ ශීර්ෂක කලින් සැලසුම් කිරීමෙන් අවසාන ලේඛනය වෘත්තීය පෙනුමක් ගනී.

වගු සහ දත්ත ඇතුළත් කිරීම

භාණ්ඩ ලැයිස්තු, ලකුණු සහ ගනුදෙනු වාර්තා සඳහා PdfPTable පන්තිය භාවිත කළ හැක. තීරු ගණන සඳහන් කර සෑම කොටුවකටම PdfPCell හෝ පෙළක් එක් කළ හැක. දත්ත ප්‍රමාණය වැඩි නම් පිටු මාරුව ස්වයංක්‍රීයව සිදු වේ.

උදාහරණයක් ලෙස, ගණනය කිරීම් ඇතුළත් වාර්තාවක් සෑදීමේදී ගණනය කිරීමේ ක්‍රම පිළිබඳ දත්තද වගුවකට ඇතුළත් කළ හැක. මුදල් අගයන්ට දශම ස්ථාන නියමිත ආකාරයට පෙන්වීම සහ තීරු පළල නිවැරදිව සකස් කිරීම වැදගත්ය.

රූප සහ ගොනු නාම කළමනාකරණය

PDF එකකට ලාංඡනයක් හෝ ඡායාරූපයක් එක් කිරීමට Image.GetInstance() ක්‍රමය භාවිත කළ හැක. රූපයේ ප්‍රමාණය ඉතා විශාල නම් PDF ගොනුවද විශාල වේ. එබැවින් අවශ්‍ය ප්‍රමාණයට රූපය සම්පීඩනය කර භාවිත කිරීම වඩාත් සුදුසුය.

පරිශීලකයා තෝරන ස්ථානයකට ගොනුව සුරැකීමට SaveFileDialog භාවිත කළ හැක. ගොනු නාමයට විශේෂ සංකේත ඇතුළත් නොකිරීම, දැනටමත් තිබෙන ගොනුවක් නැවත ලිවීමට පෙර අනතුරු ඇඟවීම, සහ මාර්ගගත ආරක්ෂක කරුණු පිළිබඳ අවධානය යොමු කිරීම ආරක්ෂිත යෙදුමකට වැදගත් වේ.

දෝෂ පාලනය සහ පරීක්ෂාව

PDF සෑදීමේ කේතය Try...Catch කොටසක් තුළ තැබීමෙන් ෆෝල්ඩරය නොමැති වීම, ගොනුව භාවිතයේ තිබීම හෝ අවසර නොමැති වීම වැනි දෝෂ පාලනය කළ හැක. දෝෂ පණිවිඩය පරිශීලකයාට තේරුම්ගත හැකි ආකාරයට පෙන්වන්න.

අවසාන පරීක්ෂාවේදී සිංහල අකුරු, පිටු ප්‍රමාණය, දිගු වගු, හිස් දත්ත සහ විශාල රූප පරීක්ෂා කරන්න. PDF එක Adobe Reader සහ වෙබ් බ්‍රවුසරයක විවෘත කර බැලීමෙන් අනුකූලතා ගැටලු කලින් හඳුනාගත හැක.

මෙම මූලික ක්‍රම අනුගමනය කරමින් VB.NET යෙදුමකින් වාර්තා, ඉන්වොයිස් සහ දත්ත සාරාංශ PDF ලෙස සෑදීම ආරම්භ කරන්න. පසුව ෆොන්ට්, වගු, රූප සහ පිටු අංක එකතු කර ඔබේම ප්‍රායෝගික ව්‍යාපෘතියක් ගොඩනඟන්න.