File.WriteAllLines Method (String, IEnumerable<String>, Encoding)
Creates a new file by using the specified encoding, writes a collection of strings to the file, and then closes the file.
Assembly: mscorlib (in mscorlib.dll)
public static void WriteAllLines( string path, IEnumerable<string> contents, Encoding encoding )
Parameters
- path
-
Type:
System.String
The file to write to.
- contents
-
Type:
System.Collections.Generic.IEnumerable<String>
The lines to write to the file.
- encoding
-
Type:
System.Text.Encoding
The character encoding to use.
| Exception | Condition |
|---|---|
| ArgumentException | path is a zero-length string, contains only white space, or contains one or more invalid characters defined by the GetInvalidPathChars method. |
| ArgumentNullException | Either path, contents, or encoding is null. |
| DirectoryNotFoundException | path is invalid (for example, it is on an unmapped drive). |
| IOException | An I/O error occurred while opening the file. |
| PathTooLongException | path exceeds the system-defined maximum length. For example, on Windows-based platforms, paths must be less than 248 characters and file names must be less than 260 characters. |
| NotSupportedException | path is in an invalid format. |
| SecurityException | The caller does not have the required permission. |
| UnauthorizedAccessException | path specifies a file that is read-only. -or- This operation is not supported on the current platform. -or- path is a directory. -or- The caller does not have the required permission. |
If the target file already exists, it is overwritten.
You can use this method to create a file that contains the following:
The results of a LINQ to Objects query on the lines of a file, as obtained by using the ReadLines method.
The contents of a collection that implements an IEnumerable<T> of strings.
Available since 10
.NET Framework
Available since 4.0
Silverlight
Available since 4.0