Method CreateTempFile

CreateTempFile(String, String)

Creates a new empty file in a random subdirectory of , using the given prefix and suffix strings to generate its name.

Declaration
public static FileInfo CreateTempFile(string prefix, string suffix)
Parameters
Type Name Description
System.String prefix

The prefix string to be used in generating the file's name; must be at least three characters long
System.String suffix

The suffix string to be used in generating the file's name; may be null, in which case a random suffix will be generated
Returns
Type Description
FileInfo

A instance representing the temp file that was created.
Remarks

If this method returns successfully then it is guaranteed that:

  1. The file denoted by the returned abstract pathname did not exist before this method was invoked, and
  2. Neither this method nor any of its variants will return the same abstract pathname again in the current invocation of the virtual machine.
This method provides only part of a temporary-file facility. However, the file will not be deleted automatically, it must be deleted by the caller.

The prefix argument must be at least three characters long. It is recommended that the prefix be a short, meaningful string such as "hjb" or "mail".

The suffix argument may be null, in which case a random suffix will be used.

Both prefix and suffix must be provided with valid characters for the underlying system, as specified by .

If the directory argument is null then the system-dependent default temporary-file directory will be used, with a random subdirectory name. The default temporary-file directory is specified by the method. On UNIX systems the default value of this property is typically "/tmp" or "/var/tmp"; on Microsoft Windows systems it is typically "C:\Users\[UserName]\AppData\Local\Temp".

CreateTempFile(String, String, DirectoryInfo)

Creates a new empty file in the specified directory, using the given prefix and suffix strings to generate its name.

Declaration
public static FileInfo CreateTempFile(string prefix, string suffix, DirectoryInfo directory)
Parameters
Type Name Description
System.String prefix

The prefix string to be used in generating the file's name; must be at least three characters long
System.String suffix

The suffix string to be used in generating the file's name; may be null, in which case a random suffix will be generated
DirectoryInfo directory

The directory in which the file is to be created, or null if the default temporary-file directory is to be used
Returns
Type Description
FileInfo

A instance representing the temp file that was created.
Remarks

If this method returns successfully then it is guaranteed that:

  1. The file denoted by the returned abstract pathname did not exist before this method was invoked, and
  2. Neither this method nor any of its variants will return the same abstract pathname again in the current invocation of the virtual machine.
This method provides only part of a temporary-file facility. However, the file will not be deleted automatically, it must be deleted by the caller.

The prefix argument must be at least three characters long. It is recommended that the prefix be a short, meaningful string such as "hjb" or "mail".

The suffix argument may be null, in which case a random suffix will be used.

Both prefix and suffix must be provided with valid characters for the underlying system, as specified by .

If the directory argument is null then the system-dependent default temporary-file directory will be used, with a random subdirectory name. The default temporary-file directory is specified by the method. On UNIX systems the default value of this property is typically "/tmp" or "/var/tmp"; on Microsoft Windows systems it is typically "C:\Users\[UserName]\AppData\Local\Temp".