Control.TemplateSourceDirectory Property

Definition

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

public:
 virtual property System::String ^ TemplateSourceDirectory { System::String ^ get(); };
[System.ComponentModel.Browsable(false)]
public virtual string TemplateSourceDirectory { get; }
[<System.ComponentModel.Browsable(false)>]
member this.TemplateSourceDirectory : string
Public Overridable ReadOnly Property TemplateSourceDirectory As String

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

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

See also