Control.TemplateSourceDirectory-Eigenschaft

Ruft das virtuelle Verzeichnis der Page oder des UserControl ab, in dem das aktuelle Serversteuerelement enthalten ist.

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

Syntax

'Declaration
Public Overridable ReadOnly Property TemplateSourceDirectory As String
'Usage
Dim instance As Control
Dim value As String

value = instance.TemplateSourceDirectory

public virtual string TemplateSourceDirectory { get; }

public:
virtual property String^ TemplateSourceDirectory {
    String^ get ();
}

/** @property */
public String get_TemplateSourceDirectory ()

public function get TemplateSourceDirectory () : String

Eigenschaftenwert

Das virtuelle Verzeichnis der Seite oder des Benutzersteuerelements, das das Serversteuerelement enthält.

Hinweise

Die TemplateSourceDirectory-Eigenschaft gibt den Pfad zu der Seite oder dem Benutzersteuerelement an, in denen das aktuelle Steuerelement enthalten ist. Wenn sich die Webseite z. B. unter https://www.contoso.com/application/subdirectory befindet, gibt die TemplateSourceDirectory-Eigenschaft einen Wert "application/subdirectory" zurück.

Verwenden Sie die AppRelativeTemplateSourceDirectory-Eigenschaft, um den virtuellen anwendungsrelativen Pfad ("~/subdirectory") zurückzugeben.

Beispiel

Im folgenden Beispiel wird die TemplateSourceDirectory-Eigenschaft zweimal verwendet. Zuerst wird sie beim Aufruf der Control.MapPathSecure-Methode verwendet, um den Pfad zu dem Verzeichnis abzurufen, in dem sich das Steuerelement befindet. Das zweite Mal wird sie beim Aufruf der Directory.GetFiles-Methode verwendet, um die Liste aller in diesem Verzeichnis enthaltenen Dateien abzurufen.

' 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

// 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(get_TemplateSourceDirectory()) + "<br>");

// Get all the files from the absolute path of 'MyControl';
// using TemplateSourceDirectory which gives the virtual Directory.
String myFiles[] = Directory.GetFiles(MapPathSecure(
    get_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.get_Item(i) + "<br>");
}  

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Control-Klasse
Control-Member
System.Web.UI-Namespace
Page
UserControl