File.CreateText() Method in C# with Examples
File.CreateText() is an inbuilt File class method that is used to overwrite the contents of the existing file with the given UTF-8 encoded text and if the file is not created already, this function will create a new file with the specified contents.
public static System.IO.StreamWriter CreateText (string path);
Parameter: This function accepts a parameter which is illustrated below:
- Path: This is the file where UTF-8 encoded texts are going to be overwritten. The file is created if it doesn’t already exist.
- UnauthorizedAccessException: The caller does not have the required permission. OR the path specified a file that is read-only. OR the path specified a file that is hidden.
- ArgumentException: The path is a zero-length string, contains only white space, or one or more invalid characters.
- ArgumentNullException: The path is null.
- PathTooLongException: The specified path, file name, or both exceed the system-defined maximum length.
- DirectoryNotFoundException: The specified path is invalid i.e, it is on an unmapped drive.
- NotSupportedException: The path is in an invalid format.
Return Value: Returns a StreamWriter that writes to the specified file using UTF-8 encoding.
Below are the programs to illustrate the File.CreateText() method.
Before running the below code, a file file.txt is created with some contents which is shown below:
mcs -out:main.exe main.cs mono main.exe GeeksforGeeks is a computer science portal.
After running the above code, above output is shown and the existing file file.txt becomes like below:
Program 2: Initially, no file is created and hence below code itself create a file named as file.txt
mcs -out:main.exe main.cs mono main.exe Geeks GFG GeeksforGeeks
After running the above code, a new file file.txt is created which is shown below: