Writing Text to Files in C# - Using StreamWriter and File.WriteAllText

Writing text to files is one of the most common tasks in application development. Whether you are logging application activity, saving user data, exporting reports, or storing configuration settings, C# file handling provides powerful and flexible tools to accomplish this task efficiently.

In this comprehensive guide, you will learn how to write text to files in C# using two widely used approaches:

• StreamWriter in C#
• File.WriteAllText in C#

This article is designed for beginners to intermediate C# developers and follows Google Helpful Content Guidelines by focusing on practical, real-world examples and clear explanations.

Understanding File Writing in C#

C# provides file handling capabilities through the System.IO namespace. This namespace includes classes that allow developers to create, read, write, and manage files and directories.

Common Scenarios for Writing Text to Files

• Saving application logs
• Storing user input or form data
• Generating text-based reports
• Exporting data to text files
• Writing configuration or settings files

Key Classes for Writing Text Files

Writing Text to Files Using StreamWriter in C#

StreamWriter is ideal when you need fine-grained control over file writing, especially for large files or scenarios where data is written incrementally.

Basic StreamWriter Example

📄

using System;
using System.IO;

class Program
{
    static void Main()
    {
        using (StreamWriter writer = new StreamWriter("example.txt"))
        {
            writer.WriteLine("Hello, World!");
            writer.WriteLine("Writing text to a file using StreamWriter.");
        }

        Console.WriteLine("File written successfully.");
    }
}

Explanation of the Code

• The using statement ensures the file is properly closed after writing.
• StreamWriter writes text line by line.
• The file is created automatically if it does not exist.

Appending Text Using StreamWriter

To add text to an existing file without overwriting it, you can enable append mode.

📄

using (StreamWriter writer = new StreamWriter("example.txt", true))
{
    writer.WriteLine("This line is appended.");
}

Real-World Use Case: Application Logging

StreamWriter is commonly used for logging because logs are written continuously over time.

📄

void LogMessage(string message)
{
    using (StreamWriter writer = new StreamWriter("app.log", true))
    {
        writer.WriteLine($"{DateTime.Now}: {message}");
    }
}

Writing Text to Files Using File.WriteAllText in C#

File.WriteAllText is a simpler and more concise method for writing text to files. It is best suited for smaller files where all content can be written in one operation.

Basic File.WriteAllText Example

📄

using System;
using System.IO;

class Program
{
    static void Main()
    {
        string content = "This file was created using File.WriteAllText.";
        File.WriteAllText("simple.txt", content);

        Console.WriteLine("File created successfully.");
    }
}

Explanation of the Code

• Writes all text to the file in one operation.
• Automatically creates the file if it does not exist.
• Overwrites existing content by default.

Real-World Use Case: Saving User Preferences

📄

string settings = "Theme=Dark\nFontSize=14";
File.WriteAllText("settings.config", settings);

This approach is ideal for configuration or settings files.

StreamWriter vs File.WriteAllText: Which Should You Use?

Common Errors and How to Avoid Them

• UnauthorizedAccessException: Ensure proper file permissions.
• DirectoryNotFoundException: Verify the file path exists.
• IOException: Avoid writing to files already in use.

Writing text to files in C# is a fundamental skill that every developer should master. By understanding when to use StreamWriter versus File.WriteAllText, you can write efficient, maintainable, and scalable applications.

StreamWriter offers flexibility and performance for large or continuous writing tasks, while File.WriteAllText provides simplicity and speed for smaller operations. Choosing the right approach ensures better performance and cleaner code.

Frequently Asked Questions (FAQs)

1. What is the best way to write text to a file in C#?

The best method depends on your use case. Use StreamWriter for large or incremental writing and File.WriteAllText for small, simple files.

2. Does File.WriteAllText overwrite existing files?

Yes, it overwrites the file by default. Existing content will be replaced.

3. Can StreamWriter append text to a file?

Yes, by setting the append parameter to true.

4. Which method is faster for large files?

StreamWriter is more efficient and memory-friendly for large files.

5. Do I need to close files manually in C#?

When using the using statement, files are closed automatically, which is the recommended approach.