Complete Guide to Redirecting Console Output to Text Files in C#

Fundamental Principles of Console Output Redirection

In C# programming, console output is typically achieved through the Console.WriteLine method, which by default displays content in the command-line interface. However, in practical applications, it is often necessary to save this output to files for subsequent analysis or logging. Redirection technology changes the target of the standard output stream, ensuring all console output is automatically written to a specified file.

Implementing Redirection Using Console.SetOut Method

The core method is Console.SetOut, which accepts a TextWriter parameter and redirects standard output to that writer. Below is a complete implementation example:

using System;
using System.IO;

class Program
{
    static void Main()
    {
        FileStream fileStream = null;
        StreamWriter streamWriter = null;
        TextWriter originalOutput = Console.Out;
        
        try
        {
            fileStream = new FileStream("./output.txt", FileMode.OpenOrCreate, FileAccess.Write);
            streamWriter = new StreamWriter(fileStream);
            Console.SetOut(streamWriter);
            
            // All Console.WriteLine output will be written to the file
            Console.WriteLine("This is the first line of text");
            Console.WriteLine("Everything written to Console.WriteLine");
            Console.WriteLine("will be saved to the output file");
        }
        catch (Exception ex)
        {
            Console.SetOut(originalOutput);
            Console.WriteLine($"Cannot open file for writing: {ex.Message}");
            return;
        }
        finally
        {
            Console.SetOut(originalOutput);
            streamWriter?.Close();
            fileStream?.Close();
            Console.WriteLine("Redirection completed");
        }
    }
}

Analysis of Key Technical Points

File Stream Creation: Use FileStream to specify the file path, open mode, and access permissions. FileMode.OpenOrCreate ensures the file is opened if it exists or created if it does not.

Stream Writer Configuration: StreamWriter wraps the file stream, providing text writing functionality. Setting AutoFlush = true ensures data is written to the file promptly, avoiding buffer delays.

Output Stream Backup and Restoration: Save the original Console.Out before redirection and restore it after operations to ensure subsequent console output displays normally.

Exception Handling and Resource Management

File operations may throw exceptions such as IOException or UnauthorizedAccessException. Complete exception handling should include:

try
{
    // File operation code
}
catch (IOException ioEx)
{
    Console.WriteLine($"IO Error: {ioEx.Message}");
}
catch (UnauthorizedAccessException authEx)
{
    Console.WriteLine($"Permission Error: {authEx.Message}");
}
finally
{
    // Ensure resource release
}

Supplementary Implementation Approaches

In addition to the primary method, a simplified implementation can be used:

using (FileStream fs = new FileStream("out.txt", FileMode.Create))
using (StreamWriter sw = new StreamWriter(fs))
{
    sw.AutoFlush = true;
    Console.SetOut(sw);
    Console.SetError(sw); // Also redirect error output
    
    // Program output logic
    Console.WriteLine("Output content");
}

This approach uses the using statement to automatically manage resource disposal, resulting in cleaner and safer code.

Practical Application Scenarios

This technique is suitable for scenarios such as log recording, saving batch job outputs, and collecting automated test results. When analyzing log files as in the original question, analysis results can be directly saved to files for subsequent processing.

Performance and Considerations

Frequent file I/O operations may impact performance; it is advisable to enable redirection only when necessary and restore promptly afterward. Additionally, pay attention to file path permissions and disk space to ensure stable program operation.