Control.TemplateSourceDirectory Property

Definition

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

[System.ComponentModel.Browsable(false)]
public virtual string TemplateSourceDirectory { get; }

Property Value

The virtual directory of the page or user control that contains the server control.

Attributes

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.

// 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>");

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.

Applies to

Product Versions
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

See also