Tutorials C# Programming Tutorial
StreamReader & StreamWriter — Complete Guide
StreamReader & StreamWriter — Complete Guide: free step-by-step lesson with examples, common mistakes, and interview tips — part of C# Programming Tutorial on Toolliyo Academy.
On this page
C# Programming Tutorial · Lesson 148 of 240
File Class
Beginner ✓ → Intermediate ✓ → Advanced → Professional
Advanced · 3 — Production C# · ~22 min read · Module 11: File Handling
1. Introduction
Advanced topic: File Class. This is what .NET teams use on live systems — banking APIs, e-commerce backends, SaaS services. Try changing one line at a time in the example. File Class is a core part of C# and .NET development. In plain terms: it helps you model domain objects so business rules live in one clear place. You will see File Class in console apps, Web APIs, background workers, and unit tests. Skipping it makes later modules (OOP, async, collections) much harder.
Stream large files — do not read gigabytes into a single string.
2. Real-world story
At IRCTC ticket reservation engine, engineers use File Class to model domain objects so business rules live in one clear place. This code shows the same pattern you will see in code reviews — simplified for learning, but structurally similar to production services deployed to Azure or on-prem IIS/Kestrel.
3. Problem without this concept
If you ignore File Class, this is what teams struggle with:
- Global variables for every customer field → name collisions
- No encapsulation → anyone changes balance incorrectly
4. Definition
File Class is a core part of C# and .NET development. In plain terms: it helps you model domain objects so business rules live in one clear place.
5. Why do we need it?
You will see File Class in console apps, Web APIs, background workers, and unit tests. Skipping it makes later modules (OOP, async, collections) much harder. For imports, exports, config files, and audit logs on disk.
6. Where is it used?
- GST CSV exports
- Bank statement imports
- App configuration
- GST invoice exports and bank statement CSVs use StreamReader for large files.
- Never load a 2 GB log file entirely into memory — stream line by line.
7. How it works
- Read the example top to bottom.
- Each line connects to File Class.
- Run it with dotnet run, then change one value and predict the output before you save.
8. Syntax
Core syntax pattern for File Class:
public class ClassName
{
public Type Property { get; set; }
public ReturnType Method() { }
}
| Syntax | Meaning |
|---|---|
public class BankAccount | Defines a type — blueprint for objects or contracts. |
{ | Part of the File Class example — read with surrounding lines. |
public string AccountNumber { get; } | Part of the File Class example — read with surrounding lines. |
public decimal Balance { get; private set; } | Part of the File Class example — read with surrounding lines. |
public BankAccount(string number, decimal openingBalance) | Method declaration — reusable block of logic. |
{ | Part of the File Class example — read with surrounding lines. |
9. Beginner example
Copy into a console project (dotnet new console → dotnet run).
public class BankAccount
{
public string AccountNumber { get; }
public decimal Balance { get; private set; }
public BankAccount(string number, decimal openingBalance)
{
AccountNumber = number;
Balance = openingBalance;
}
public bool TryDebit(decimal amount)
{
if (amount <= 0 || amount > Balance) return false;
Balance -= amount;
return true;
}
}
var account = new BankAccount("HDFC-001", 10000m);
Console.WriteLine(account.TryDebit(2500) ? $"Paid. Balance: ₹{account.Balance}" : "Declined");
Line-by-line
| Code | What it means |
|---|---|
public class BankAccount | Defines a type — blueprint for objects or contracts. |
{ | Part of the File Class example — read with surrounding lines. |
public string AccountNumber { get; } | Part of the File Class example — read with surrounding lines. |
public decimal Balance { get; private set; } | Part of the File Class example — read with surrounding lines. |
public BankAccount(string number, decimal openingBalance) | Method declaration — reusable block of logic. |
{ | Part of the File Class example — read with surrounding lines. |
AccountNumber = number; | Part of the File Class example — read with surrounding lines. |
Balance = openingBalance; | Part of the File Class example — read with surrounding lines. |
} | Closes a block started earlier. |
public bool TryDebit(decimal amount) | Method declaration — reusable block of logic. |
{ | Part of the File Class example — read with surrounding lines. |
if (amount <= 0 || amount > Balance) return false; | Conditional — runs different code based on a true/false check. |
Balance -= amount; | Part of the File Class example — read with surrounding lines. |
return true; | Sends a value back to the caller. |
10. Real project example
At IRCTC ticket reservation engine, engineers use File Class to model domain objects so business rules live in one clear place. This code shows the same pattern you will see in code reviews — simplified for learning, but structurally similar to production services deployed to Azure or on-prem IIS/Kestrel.
Production-style C#
// IRCTC ticket reservation engine — domain model using File Class
public sealed class TransferRequest
{
public required string FromAccount { get; init; }
public required string ToAccount { get; init; }
public decimal Amount { get; init; }
}
public class TransferService
{
private readonly Dictionary<string, decimal> _balances = new();
public bool Execute(TransferRequest req)
{
if (!_balances.TryGetValue(req.FromAccount, out var bal) || bal < req.Amount)
return false;
_balances[req.FromAccount] = bal - req.Amount;
_balances[req.ToAccount] = _balances.GetValueOrDefault(req.ToAccount) + req.Amount;
return true;
}
}
Why teams use this: Teams that master File Class ship fewer production incidents and pass code review faster on IRCTC-scale systems.
11. Visual understanding
Customer (class blueprint)
│
├── Customer object: Ravi
├── Customer object: Priya
└── Customer object: Amit
Each object shares the same fields/methods defined on the class.
12. Internal working
- Roslyn compiler checks syntax and types before your program runs.
- CLR executes IL and provides services (GC, exceptions, threading).
- For this lesson, focus on behavior first — runtime details matter more as apps grow.
13. Advantages
- Models real business entities (Account, Order, Patient)
- Encapsulation protects invariants like balance ≥ 0
- Polymorphism lets you add payment types without rewriting callers
14. Disadvantages
- Deep inheritance trees become hard to change
- Not every problem needs a class — sometimes a function is enough
15. Best practices
- Prefer composition over deep inheritance
- Keep fields private; expose behavior via methods
- One class — one main responsibility
16. Common mistakes
- Copy-pasting without typing — your fingers need to remember File Class syntax.
- Skipping error messages when the compiler fails — the red text usually tells you exactly what to fix.
17. Interview questions
What is File Class in simple words?
File Class is explained above — focus on the "what" paragraph and the lesson example.
Do I need File Class for ASP.NET Core jobs?
Yes for most backend roles — this course builds toward Web APIs and services using the same C# fundamentals.
Explain File Class to a non-technical teammate in 30 seconds.
Focus on the problem it solves — use a bank transfer or shopping cart analogy, not jargon.
Junior interview: give one code example using File Class.
Use the beginner example from this lesson — be able to write it on a whiteboard without looking.
What goes wrong if you misuse File Class?
Mention one mistake from the Common mistakes section and how you would fix it in a code review.
Do this on your computer
- Open Visual Studio or run dotnet new console -n LearnFileClass.
- Paste the lesson example into Program.cs (or a new file).
- Run the program and confirm the output matches your expectation.
- Read the real-world section and name which part of a banking or e-commerce API would use this topic.
- Change one line (amount, loop bound, or method name) and run again.
- Read the real-world section and identify which layer (API, service, domain) uses this topic.
- Run dotnet build and dotnet run locally — confirm output.
- Change one value and predict the result before saving.
Experiments — try changing this
- Change a number or string in the example and run again — predict output first.
- Introduce a deliberate error (remove a semicolon) and read the compiler message.
- Open dotnet docs for File Class and compare one keyword with the lesson example.
18. Summary
- File Class is used to model domain objects so business rules live in one clear place.
- Practice by editing the example yourself.
- Move to the next lesson when you can explain this topic in your own words.
Sign in to ask a question or upvote helpful answers.
No questions yet — be the first to ask!