SayehBanTools 2.0.8

dotnet add package SayehBanTools --version 2.0.8
                    
NuGet\Install-Package SayehBanTools -Version 2.0.8
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="SayehBanTools" Version="2.0.8" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="SayehBanTools" Version="2.0.8" />
                    
Directory.Packages.props
<PackageReference Include="SayehBanTools" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add SayehBanTools --version 2.0.8
                    
#r "nuget: SayehBanTools, 2.0.8"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package SayehBanTools@2.0.8
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=SayehBanTools&version=2.0.8
                    
Install as a Cake Addin
#tool nuget:?package=SayehBanTools&version=2.0.8
                    
Install as a Cake Tool

SayehBanTools - راهنمای استفاده

NuGet Downloads Target

SayehBanTools Logo

یک کتابخانه چندمنظوره برای توسعه‌دهندگان دات‌نت با قابلیت‌های متنوع

این پکیج به دلیل دارا بودن کنترل‌های WinForms، با Target Framework net11.0-windows منتشر می‌شود. برای پروژه‌های .NET Framework 4.8 نسخه‌ی SayehBanTools.Framework را نصب کنید (کد یکسان است).

فهرست مطالب

نصب

برای نصب کتابخانه از NuGet استفاده کنید:

dotnet add package SayehBanTools

یا در Visual Studio از طریق Package Manager Console:

Install-Package SayehBanTools

کلاس‌ها و قابلیت‌ها

IPAccess

بررسی محدوده IP:

bool isInRange = IPAccess.IsInRange("192.168.1.5", "192.168.1.1", "192.168.1.10");
// true اگر IP در محدوده باشد

Calculator

انجام محاسبات ریاضی:

// جمع
double sum = Calculator.Add(5, 10, 15); // 30

// ضرب
double product = Calculator.Multiply(2, 3, 4); // 24

// تخفیف
decimal discounted = Calculator.Discount(1000, 20); // 800

// مالیات
decimal taxed = Calculator.Taxation(1000, 9); // 1090

RabbitMQ

پیکربندی سرویس‌ها:
services.AddTransient<RabbitMQConnection, RabbitMQConnection>();
services.AddTransient<ISendMessages, RabbitMQMessageBus>();
ارسال پیام:
var message = new BaseMessage();
await _messageBus.SendMessageAsync(message, "exchange_name", "queue_name");

مدیریت فایل‌ها

var fileManager = new ManageFiles();

// آپلود فایل
string uploadedPath = await fileManager.UploadFileAsync("/uploads", file);

// حذف فایل
fileManager.DeleteFileServer("/uploads/file.txt");

تبدیل اعداد

// عدد به حروف
string words = ConvertNumToString.convert("123456789");
// "صد و بیست و سه میلیون و چهارصد و پنجاه و شش هزار و هفتصد و هشتاد و نه"

// عدد به رشته فارسی
string persianNumber = "123456".En2Fa(); // "۱۲۳۴۵۶"

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

// تبدیل اعداد انگلیسی به فارسی
string persianNum = "123".En2Fa(); // "۱۲۳"

// تبدیل اعداد فارسی به انگلیسی
string englishNum = "۱۲۳".Fa2En(); // "123"

// حذف تگ‌های HTML
string cleanHtml = "<div>Test</div>".HtmlTags(); // "Test"

رمزنگاری

// رمزنگاری
string encrypted = await StringEncryptor.EncryptAsync("text", "initVector", "passPhrase");

// رمزگشایی
string decrypted = await StringEncryptor.DecryptAsync(encrypted, "initVector", "passPhrase");

⚠️ هشدار: StringEncryptor رمزنگاری متقارن (Symmetric) است؛ یعنی initVector و passPhrase هر دو در سمت مصرف‌کننده لازم هستند و متن رمزشده بدون آن‌ها قابل بازیابی است. این روش برای امن‌سازی در برابر نگاه ساده (مثلاً رشته اتصال در Config) مناسب است، اما نه برای ذخیره رمز عبور کاربر — برای آن از Hashing (مثل BCrypt) استفاده کنید. تازگی Salt/IV در هر دو پکیج یکسان است؛ رشته رمزشده‌ای که با یک نسخه ساخته شده فقط با همان نسخه رمزگشایی می‌شود.

تولید مقادیر

// کد ملی معتبر
string nationalCode = NationalCode.GenerateRandom();

// کد تصادفی 16 رقمی
string randomValue = GenerateValues.Generate16ValueRandome();

ارسال پیامک

// ارسال پیامک پترن
var data = new Dictionary<string, object> { { "code", "12345" } };
var result = await SMS_System.SendPatternAsync(apiLink, apiKey, data, "pattern_code", "sender", "09123456789", null);

// بررسی اعتبار
var credit = await SMS_System.GetCreditAsync(apiLink, apiKey);

مدیریت تاریخ

// تبدیل میلادی به شمسی
string shamsiDate = ConvertDateTime.MiladiToShamsi(DateTime.Now);

// تبدیل شمسی به میلادی
DateTime miladiDate = ConvertDateTime.ShamsiToMiladi("1402/05/15");

ترجمه

var translator = new TranslateTexts(new HttpClient());
var request = new TranslationRequest
{
    OriginalText = "Hello",
    InputLanguage = "en",
    OutputLanguage = "fa"
};

var response = await translator.TranslateTextAsync(request);
// response.Translations[0] = "سلام"

صفحه‌بندی

var query = dbContext.Products.AsQueryable();
var pager = new Pager(totalItems: 100, currentPage: 2, pageSize: 10);

var pagedResults = query.PagedResult(pager.CurrentPage, pager.PageSize, out int totalCount);

مثال‌های کد

مثال کامل RabbitMQ

// Startup.cs
services.Configure<RabbitMqConnectionSettings>(Configuration.GetSection("RabbitMQ"));
services.AddTransient<RabbitMQConnection>();
services.AddTransient<ISendMessages, RabbitMQMessageBus>();

// Controller
public class MessageController : Controller
{
    private readonly ISendMessages _messageBus;
    
    public MessageController(ISendMessages messageBus)
    {
        _messageBus = messageBus;
    }
    
    [HttpPost]
    public async Task<IActionResult> Send([FromBody] MessageDto message)
    {
        var baseMessage = new BaseMessage();
        await _messageBus.SendMessageAsync(baseMessage, "notifications", "emails");
        return Ok();
    }
}

مثال مدیریت فایل

[HttpPost]
public async Task<IActionResult> Upload(IFormFile file)
{
    var fileManager = new ManageFiles();
    string path = await fileManager.UploadFileAsync("wwwroot/uploads", file);
    return Ok(new { Path = path });
}

کارت‌خوان PC-POS

اتصال به کارت‌خوان‌های PC-POS بانکی (پروتکل CPML) از طریق پورت سریال یا شبکه. پورت‌شده از پروژه PC-POS Aramestan.

using SayehBanTools.PCPOS;

// تنظیمات اتصال
var settings = new PosConnectionSettings
{
    Brand = PosBrand.SayanKart,            // برند دستگاه
    ConnectionType = PosConnectionType.SerialPort,
    SerialPort = "COM3",
    BaudRate = 38400,
    SerialTimeout = 30
    // یا حالت شبکه:
    // ConnectionType = PosConnectionType.Lan,
    // LanIp = "192.168.1.100",
    // LanPort = 16028,                     // پورت پیش‌فرض CPML
    // LanTimeout = 60
};

// راه اول: از طریق Singleton
var pos = PosCommander.Instance;
if (pos.Init(settings))
{
    Response result = pos.Purchase("فاکتور ۱۲۳", "50000", print: true);
    if (result.Success && result.TransactionInfo != null)
        Console.WriteLine($"خرید موفق - RRN: {result.TransactionInfo.RRN}، مبلغ: {result.TransactionInfo.Amount}");
}
else
{
    Console.WriteLine("اتصال به کارت‌خوان برقرار نشد");
}

// راه دوم: از طریق Factory (بدون Singleton) - مناسب تزریق وابستگی
IPosProtocol protocol = PosProtocolFactory.Create(PosBrand.SayanKart, settings);
Response info = protocol.GetPosInfo();
Console.WriteLine($"ترمینال: {info.PosInformation.TerminalId}");

سایر عملیات: BalanceInquiry، BillPayment، LastTransaction، LastPcPosTransaction، PrintText، PrintBarcode. کدهای خطای Response.ErrorCode: 201 عدم اتصال، 202 خطای ارسال، 203 پاسخ خالی، 204 پاسخ نامعتبر.

کمکی‌های فرم ویندوزی (Helper)

کلاس‌های کمکی عمومی برای برنامه‌های Windows Forms (namespace SayehBanTools.Utilities.win.Helper و SayehBanTools.Utilities.Helper):

  • GhahShomar — تقویم شمسی با نام روز هفته، مناسبت‌های رسمی ایران و تاریخ ساده: new GhahShomar(DateTime.Now).SimpleDate()
  • InventoryUi — پیام‌های راست‌به‌چپ (Info/Warn/Error/Ask)، تبدیل شمسی ↔ میلادی، بازه UTC، مالیات و تخفیف درصدی اعشاری و تجزیه عدد از متن فارسی (ParseDecimal، ParsePercent)
  • FormValidation — قواعد مشترک اعتبارسنجی فرم (کامبو، موبایل، نام کاربری، رمز و تکرار، تصویر) با نمایش خطای RTL
  • DateInput — ورود تاریخ شمسی/میلادی در SmartTextBox با چک‌باکس تعیین نوع تاریخ؛ میلادی خودکار به شمسی تبدیل می‌شود
  • TimeInput — ورود ساعت HH:mm با پذیرش فرمت‌های 8، 08:30، 0830 و ارقام فارسی
  • DocumentNumber — پیشوند شماره اسناد (سال / سال‌وماه / سال‌وماه‌وروز) با تقویم شمسی؛ فرمت با DocumentNumber.FormatSelector انتخاب می‌شود
  • GridRightAlign — راست‌چین کردن داده‌های همه جدول‌ها (به‌ویژه در فرم‌های RTL)؛ استثنا با Tag ستون «NoRightAlign»
  • EnterNavigation — حرکت با Enter بین کنترل‌ها و خانه‌های جدول (DGV و cmbbox سایه‌بان را هم می‌شناسد)
  • ScreenFit — جا شدن فرم در صفحه‌های کوچک (اسکرول و وسط‌چین) و AddFittedForm<TForm>() برای ثبت فرم در DI با اتصال خودکار ScreenFit + EnterNavigation + AccessControl
  • AccessControl — کنترل دسترسی (RBAC) مبتنی بر منوی اصلی: همگام‌سازی درخت دسترسی، مخفی‌سازی منو و غیرفعال‌سازی دکمه‌ها. پیاده‌سازی:
    AccessControl.ServiceFactory = () => myPermissionService;   // پیاده‌سازی IPermissionService
    AccessControl.Map = new[] { ("MnUsers", "FrmUsers", "SEDP") }; // منو ← فرم ← عملیات‌ها
    await AccessControl.InitializeAsync(mainMenuStrip, userId);
    bool ok = AccessControl.Can("MnUsers", "Save");
    
  • PlayerSlider — نوار کشویی باریک (زمان فیلم و صدا) با رویداد Scrubbing/ValueCommitted

پخش فیلم آموزشی

LearningVideo + FrmLearningPlayer (namespace SayehBanTools.Utilities.win.Learning) با موتور VLC تقریباً همه فرمت‌ها را پخش می‌کند و محل توقف فیلم را برای ادامه‌ی دوباره ذخیره می‌کند:

LearningVideo.FormsNamespace = "MyApp.Forms";   // پیشوند namespace فرم‌های برنامه شما
LearningVideo.Show(this);                       // پوشه Learning کنار exe، با مسیر فرم

الزامات: موتور بومی VLC باید در پوشه libvlc\win-x64 (یا win-x86) کنار exe باشد. برای این کار بسته VideoLAN.LibVLC.Windows را به برنامه مصرف‌کننده اضافه کنید:

<PackageReference Include="VideoLAN.LibVLC.Windows" Version="3.0.21" />

پکیج SayehBanTools خودش به LibVLCSharp و LibVLCSharp.WinForms وابسته است (این بسته‌ها نativه ندارند)؛ اگر پوشه libvlc نباشد فقط هنگام پخش فیلم پیام خطا می‌دهد و بقیه کتابخانه سالم است.

مشارکت

مشارکت‌های شما استقبال می‌شود! برای مشارکت:

  1. ریپوی را Fork کنید
  2. شاخه جدید ایجاد کنید (git checkout -b feature/AmazingFeature)
  3. تغییرات را Commit کنید (git commit -m 'Add some AmazingFeature')
  4. Push به شاخه (git push origin feature/AmazingFeature)
  5. Pull Request باز کنید

مجوز

این پروژه تحت مجوز MIT منتشر شده است. برای اطلاعات بیشتر فایل LICENSE را مطالعه کنید.


📧 برای ارتباط: sdvp1991david@gmail.com
🌍 وبسایت: https://sayehban.ir
💻 مخزن کد: https://github.com/SayyehBan/SayehBanTools

Product Compatible and additional computed target framework versions.
.NET net11.0-windows7.0 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2.0.8 50 11/18/2026
2.0.7 136 9/18/2026
2.0.6 195 12/20/2025
2.0.5 272 12/19/2025
2.0.4 315 12/16/2025
2.0.3 318 12/16/2025
2.0.2 301 12/15/2025
2.0.1 225 11/27/2025
2.0.0 202 11/23/2025
1.8.9 207 11/23/2025
1.8.8 446 11/19/2025
1.8.7 281 11/16/2025
1.8.6 328 11/12/2025
1.8.5 316 11/12/2025
1.8.4 333 11/11/2025
1.8.3 196 11/8/2025
1.8.2 243 11/4/2025
1.8.1 239 11/3/2025
1.8.0 233 11/2/2025
1.7.10 165 11/1/2025
Loading failed