.NET Framework Class Library
Control..::.TemplateSourceDirectory Property

Gets the virtual directory of the Page or UserControl that contains the current server control.

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

Visual Basic (Declaration)
<BrowsableAttribute(False)> _
Public Overridable ReadOnly Property TemplateSourceDirectory As String
Visual Basic (Usage)
Dim instance As Control
Dim value As String

value = instance.TemplateSourceDirectory
C#
[BrowsableAttribute(false)]
public virtual string TemplateSourceDirectory { get; }
Visual C++
[BrowsableAttribute(false)]
public:
virtual property String^ TemplateSourceDirectory {
    String^ get ();
}
JScript
public function get TemplateSourceDirectory () : String

Property Value

Type: System..::.String
The virtual directory of the page or user control that contains the server control.
Remarks

The TemplateSourceDirectory property specifies the path to the page or user control that contains the current control. For example, if the Web page resides at http://www.contoso.com/application/subdirectory, the TemplateSourceDirectory property returns "application/subdirectory".

To return the application-relative virtual path ("~/subdirectory"), use the AppRelativeTemplateSourceDirectory property.

Examples

The following example uses the TemplateSourceDirectory property twice. The first time it is used in a Control..::.MapPathSecure method call to obtain the path to the directory in which the control resides. The second time it is in a Directory..::.GetFiles method call to obtain the list of all the files contained within that directory.

Visual Basic
' An HttpException occurs if the server control does not,;
' have permissions to read the resulting mapped file.
output.Write("The Actual Path of the virtual directory : " & _
            MapPathSecure(TemplateSourceDirectory) & "<br>")

' Get all the files from the absolute path of 'MyControl';
' using TemplateSourceDirectory which gives the virtual Directory.
Dim myFiles As String() = Directory.GetFiles(MapPathSecure(TemplateSourceDirectory))
output.Write("The files in this Directory are <br>")

' List all the files.
Dim i As Integer
For i = 0 To myFiles.Length - 1
   output.Write(myFiles(i) & "<br>")
Next i
C#
// An HttpException occurs if the server control does not,;
// have permissions to read the resulting mapped file. 
     output.Write("The Actual Path of the virtual directory : "+
     MapPathSecure(TemplateSourceDirectory)+"<br>");

    // Get all the files from the absolute path of 'MyControl';
    // using TemplateSourceDirectory which gives the virtual Directory.
        string [] myFiles=
        Directory.GetFiles(MapPathSecure(TemplateSourceDirectory));
        output.Write("The files in this Directory are <br>");

         // List all the files.
         for (int i=0;i<myFiles.Length;i++)
            output.Write(myFiles[i]+"<br>");
Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0
See Also

Reference

Tags :


Page view tracker