File.WriteAllText Method (String, String, Encoding)
Microsoft Silverlight will reach end of support after October 2021. Learn more.
When it is called by trusted applications, creates a new file, writes the specified string to the file using the specified encoding, and then closes the file. If the target file already exists, it is overwritten.
Namespace: System.IO
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
<SecuritySafeCriticalAttribute> _
Public Shared Sub WriteAllText ( _
path As String, _
contents As String, _
encoding As Encoding _
)
[SecuritySafeCriticalAttribute]
public static void WriteAllText(
string path,
string contents,
Encoding encoding
)
Parameters
- path
Type: System.String
The file to write to.
- contents
Type: System.String
The string to write to the file.
- encoding
Type: System.Text.Encoding
An Encoding object that represents the encoding to apply to the string.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentException | path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by GetInvalidPathChars. |
| ArgumentNullException | path is nulla null reference (Nothing in Visual Basic) or contents string is empty. |
| PathTooLongException | The specified path, file name, or both exceed 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. |
| DirectoryNotFoundException | The specified path is invalid (for example, it is on an unmapped drive). |
| IOException | An I/O error occurred while opening the file. |
| UnauthorizedAccessException | path specified a file that is read-only. -or- This operation is not supported on the current platform. -or- path specified a directory. -or- The caller does not have the required permission. |
| FileNotFoundException | The file specified in path was not found. |
| NotSupportedException | path is in an invalid format. |
| SecurityException | The caller does not have the required permission. |
Version Information
Silverlight
Supported in: 5, 4
Platforms
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.