Control::OpenFile Method (String^)


Gets a Stream used to read a file.

Namespace:   System.Web.UI
Assembly:  System.Web (in System.Web.dll)

public protected:
Stream^ OpenFile(
	String^ path


Type: System::String^

The path to the desired file.

Return Value

Type: System.IO::Stream^

A Stream that references the desired file.

Exception Condition

Access to the specified file was denied.

The OpenFile method returns a Stream object that can be used to read the contents of the file specified in the path parameter. The path parameter can be either a relative or root URL without a protocol (such as "~/mySite/myFile.txt), or a physical path, either local ("c:\mySite\myFile.txt") or UNC ("\\myServer\myFile.txt").

The OpenFile method uses file access security to control access to the specified file. If the current ASP.NET user does not have access to the file, then the file is not opened and an HttpException exception is thrown to indicate that access was denied. If the path parameter specified a relative path, the exception does not include information about the physical path to the requested file.

.NET Framework
Available since 2.0
Return to top