Menu
CoddyTech

المسارات والمجلدات

جزء من قسم أساسيات C# و.NET في رحلة ASP.NET Core على Coddy. الدرس 18 من 20.

يشير المسار إلى ملف والمجلدات التي تعلوه. يفصل Windows بين الأجزاء باستخدام \، بينما يستخدم Linux وmacOS /، لذا أنشئ المسارات باستخدام Path.Combine، التي تستخدم الفاصل المناسب. يبدأ المسار النسبي مثل exports/a.csv من الدليل الحالي، أي المجلد الذي يعمل فيه البرنامج.

var folder = Path.Combine("backups", "2026");
Directory.CreateDirectory(folder);
var target = Path.Combine(folder, "photo.jpg");
Console.WriteLine(target);
Console.WriteLine(Path.GetExtension(target));
Console.WriteLine(Path.GetFileNameWithoutExtension(target));

يطبع هذا على Linux backups/2026/photo.jpg و.jpg وphoto. تؤدي الكتابة في مجلد غير موجود إلى طرح DirectoryNotFoundException. تنشئ Directory.CreateDirectory كل المجلدات المفقودة في المسار، ولا تفعل شيئًا إذا كانت موجودة. تكتب File.WriteAllLines(path, lines) سطرًا واحدًا لكل سلسلة نصية.

challenge icon

التحدي

سهل

أضف أمر export يكتب المصروفات بتنسيق CSV، وهو التنسيق الذي يقرأه import.

  1. أضف case "export": فوق default:. أنشئ المجلد exports، وأنشئ المسار exports/expenses.csv باستخدام Path.Combine.
  2. اكتب سطرًا واحدًا لكل مصروف باستخدام File.WriteAllLines: الاسم والمبلغ والفئة، مع الفصل بينها بفواصل. اكتب المبلغ باستخدام ToString("F2", CultureInfo.InvariantCulture)، ليحتوي على منزلتين عشريتين ونقطة على كل جهاز:
    Lunch,12.50,food
    Train,4.20,travel
    Groceries,31.80,food
  3. اطبع Exported 3 expenses to exports/expenses.csv. مع العدد والمسار.
  4. أضف ذراعًا إلى help: يطبع help export العبارة export: writes every expense to exports/expenses.csv.

جرّب ذلك: يقرأ الطرفية بجانب المحرر بالفعل dotnet run -- export، لذا اضغط على «تشغيل»: Exported 3 expenses to exports/expenses.csv. تعرض الطرفية ما يطبعه البرنامج، وليس الملفات التي يكتبها، لذا يفتح «تحقق» الملف ويتوقع الأسطر الثلاثة أعلاه. كما أنه يصدّر مرتين، لذلك سيجد التشغيل الثاني مجلدًا موجودًا بالفعل.

جرّب بنفسك

using System.Globalization;
using System.Text.Json;

var file = "expenses.json";
var expenses = new List<Expense>();
if (File.Exists(file))
{
    expenses = JsonSerializer.Deserialize<List<Expense>>(File.ReadAllText(file)) ?? new List<Expense>();
}
var budgets = new Dictionary<string, decimal>();
if (File.Exists("budgets.json"))
{
    budgets = JsonSerializer.Deserialize<Dictionary<string, decimal>>(File.ReadAllText("budgets.json")) ?? new Dictionary<string, decimal>();
}
var count = expenses.Count;
var total = expenses.Sum(e => e.Amount);

if (args.Length == 0)
{
    Console.WriteLine("Expense Tracker");
    Console.WriteLine($"{count} expenses");
    Console.WriteLine($"Total: {total:F2}");
}
else
{
    switch (args[0])
    {
        case "add":
            if (args.Length < 3)
            {
                Console.Error.WriteLine("Usage: add <name> <amount> [category]");
                return 1;
            }
            if (!decimal.TryParse(args[2], CultureInfo.InvariantCulture, out var amount))
            {
                Console.Error.WriteLine($"Invalid amount: {args[2]}");
                return 1;
            }
            if (amount is <= 0 or > 10000)
            {
                Console.Error.WriteLine("The amount must be more than 0 and at most 10000.");
                return 1;
            }
            var category = args.Length > 3 ? args[3] : "other";
            var expense = new Expense(args[1], amount, category);
            expenses.Add(expense);
            File.WriteAllText(file, JsonSerializer.Serialize(expenses));
            Console.WriteLine($"Added {expense.Name}: {expense.Amount:F2} ({expense.Category})");
            if (budgets.TryGetValue(category, out var limit))
            {
                var spent = expenses.Where(e => e.Category == category).Sum(e => e.Amount);
                if (spent > limit)
                {
                    Console.WriteLine($"Over budget for {category}: {spent:F2} of {limit:F2}");
                }
            }
            break;
        case "remove":
            if (args.Length < 2)
            {
                Console.Error.WriteLine("Usage: remove <name>");
                return 1;
            }
            Expense? match = expenses.Find(e => e.Name == args[1]);
            if (match is null)
            {
                Console.Error.WriteLine($"No expense named {args[1]}.");
                return 1;
            }
            expenses.Remove(match);
            File.WriteAllText(file, JsonSerializer.Serialize(expenses));
            Console.WriteLine($"Removed {match.Name}: {match.Amount:F2}");
            break;
        case "list":
            var shown = args.Length > 1 ? expenses.Where(e => e.Category == args[1]).ToList() : expenses;
            if (shown.Count == 0)
            {
                Console.WriteLine("No expenses.");
                break;
            }
            foreach (var line in shown.Select(e => $"{e.Name}: {e.Amount:F2} ({e.Category})"))
            {
                Console.WriteLine(line);
            }
            break;
        case "top":
            var howMany = 3;
            if (args.Length > 1 && !int.TryParse(args[1], out howMany))
            {
                Console.Error.WriteLine($"Invalid number: {args[1]}");
                return 1;
            }
            var biggest = expenses.OrderByDescending(e => e.Amount).Take(howMany);
            foreach (var line in biggest.Select((e, i) => $"{i + 1}. {e.Name}: {e.Amount:F2} ({e.Category})"))
            {
                Console.WriteLine(line);
            }
            break;
        case "categories":
            var groups = expenses.GroupBy(e => e.Category).OrderByDescending(g => g.Sum(e => e.Amount));
            foreach (var g in groups)
            {
                Console.WriteLine($"{g.Key}: {g.Sum(e => e.Amount):F2} ({g.Count()})");
            }
            break;
        case "help":
            var topic = args.Length > 1 ? args[1] : "";
            var help = topic switch
            {
                "" => "Type help <command>, such as help add.",
                "add" => "add <name> <amount> [category]: saves an expense",
                "remove" => "remove <name>: deletes the first expense with that name",
                "list" => "list [category]: shows the saved expenses",
                "top" => "top [n]: shows the n biggest expenses, 3 by default",
                "categories" => "categories: shows the total of each category",
                "import" => "import <file>: adds the expenses in a CSV file",
                _ => $"No help for {topic}.",
            };
            Console.WriteLine(help);
            break;
        case "import":
            if (args.Length < 2)
            {
                Console.Error.WriteLine("Usage: import <file>");
                return 1;
            }
            if (!File.Exists(args[1]))
            {
                Console.Error.WriteLine($"No file named {args[1]}.");
                return 1;
            }
            var imported = 0;
            var lineNumber = 0;
            foreach (var row in File.ReadAllLines(args[1]))
            {
                lineNumber++;
                try
                {
                    var parts = row.Split(',');
                    if (parts.Length != 3)
                    {
                        throw new FormatException("A line needs a name, an amount and a category.");
                    }
                    expenses.Add(new Expense(parts[0], decimal.Parse(parts[1], CultureInfo.InvariantCulture), parts[2]));
                    imported++;
                }
                catch (FormatException ex)
                {
                    Console.Error.WriteLine($"Line {lineNumber} skipped: {ex.Message}");
                }
            }
            File.WriteAllText(file, JsonSerializer.Serialize(expenses));
            Console.WriteLine($"Imported {imported} expenses from {args[1]}.");
            break;
        default:
            Console.Error.WriteLine($"Unknown command: {args[0]}");
            return 1;
    }
}
return 0;

جميع دروس أساسيات C# و.NET