File.Move Method
Microsoft Silverlight will reach end of support after October 2021. Learn more.
When it is called by trusted applications, moves a specified file to a new location, providing the option to specify a new file name.
Namespace: System.IO
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
<SecuritySafeCriticalAttribute> _
Public Shared Sub Move ( _
sourceFileName As String, _
destFileName As String _
)
[SecuritySafeCriticalAttribute]
public static void Move(
string sourceFileName,
string destFileName
)
Parameters
- sourceFileName
Type: System.String
The name of the file to move.
- destFileName
Type: System.String
The new path for the file.
Exceptions
Exception | Condition |
---|---|
IOException | The destination file already exists. |
ArgumentNullException | sourceFileName or destFileName is nulla null reference (Nothing in Visual Basic). |
ArgumentException | sourceFileName or destFileName is a zero-length string, contains only white space, or contains invalid characters as defined in GetInvalidPathChars. |
UnauthorizedAccessException | The caller does not have the required permission. |
FileNotFoundException | sourceFileName was not found. |
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 path specified in sourceFileName or destFileName is invalid, (for example, it is on an unmapped drive). |
NotSupportedException | sourceFileName or destFileName is in an invalid format. |
Remarks
For more information about trusted applications, see Trusted Applications.
Platform Notes
Silverlight for Windows Phone
This member has a SecurityCriticalAttribute attribute on Silverlight for Windows Phone, because the attribute was present in Silverlight 3. This attribute restricts this member to internal use. Application code that uses this member throws a MethodAccessException.
Version Information
Silverlight
Supported in: 5, 4, 3
Silverlight for Windows Phone
Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0
XNA Framework
Supported in: Xbox 360, Windows Phone OS 7.0
Platforms
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.