Share via


OpenWrite Method

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

Opens an existing file or creates a new file for writing.

Namespace:  System.IO
Assembly:  System.IO (in System.IO.dll)

Syntax

'Declaration
Public Shared Function OpenWrite ( _
    path As String _
) As FileStream
public static FileStream OpenWrite(
    string path
)
public:
static FileStream^ OpenWrite(
    String^ path
)
static member OpenWrite : 
        path:string -> FileStream 
public static function OpenWrite(
    path : String
) : FileStream

Parameters

Return Value

Type: System.IO. . :: . .FileStream
An unshared FileStream object on the specified path with Write access.

Remarks

The OpenWrite method opens a file if one already exists for the file path, or creates a new file if one does not exist. For an existing file, it does not append the new text to the existing text. Instead, it overwrites the existing characters with the new characters. If you overwrite a longer string (such as “This is a test of the OpenWrite method”) with a shorter string (such as “Second run”), the file will contain a mix of the strings (“Second runtest of the OpenWrite method”).

The path parameter may specify relative or absolute path information. Relative path information is interpreted as relative to the current working directory. To obtain the current working directory, use the GetCurrentDirectory method.

.NET Framework Security

See Also

Reference

File Class

System.IO Namespace