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 ✓AdvancedProfessional

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() { }
}
SyntaxMeaning
public class BankAccountDefines 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 consoledotnet 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

CodeWhat it means
public class BankAccountDefines 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

  1. Open Visual Studio or run dotnet new console -n LearnFileClass.
  2. Paste the lesson example into Program.cs (or a new file).
  3. Run the program and confirm the output matches your expectation.
  4. Read the real-world section and name which part of a banking or e-commerce API would use this topic.
  5. Change one line (amount, loop bound, or method name) and run again.
  6. Read the real-world section and identify which layer (API, service, domain) uses this topic.
  7. Run dotnet build and dotnet run locally — confirm output.
  8. 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.
Questions on this lesson 0

Sign in to ask a question or upvote helpful answers.

No questions yet — be the first to ask!

C# Programming Tutorial
Course syllabus
Module 1: Introduction & Environment Setup
Module 2: C# Basics
Module 3: Functions & Strings
Module 4: Memory & Runtime
Module 5: OOP in C#
Module 6: OOP Real-Time Examples
Module 7: Exception Handling
Module 8: Delegates, Events & Lambda
Module 9: Multithreading
Module 10: Collections & Generics
Module 11: File Handling
Module 12: Async Programming
Module 13: Parallel Programming
Module 14: AutoMapper & Advanced Features
Module 15: Advanced C# Features
Module 16: C# 7 to C# 14 Features
Module 17: Enterprise Architecture
Toolliyo Assistant
Ask about tutorials, ebooks, training, pricing, mentor services, and support. I use public site content only—not admin or internal tools.

care@toolliyo.com

Need callback? Share your details