Freigeben über

VirtualPathUtility Klasse

Definition

Namespace:
System.Web
Assembly:
System.Web.dll

Stellt Hilfsmethoden für allgemeine virtuelle Pfadvorgänge bereit.

public ref class VirtualPathUtility abstract sealed
public static class VirtualPathUtility
type VirtualPathUtility = class
Public Class VirtualPathUtility
Vererbung
Object
VirtualPathUtility

Beispiele

Im folgenden Codebeispiel wird die Verwendung der VirtualPathUtility Klasse und einiger seiner Methoden veranschaulicht. Zuerst generiert die FilePath Eigenschaft den virtuellen Pfad zur Webseite. Die Methoden GetExtension, und GetDirectory die GetFileNameMethoden geben Informationen zum virtuellen Pfad zurück. Als Nächstes generiert die CurrentExecutionFilePath Eigenschaft einen virtuellen Pfad der aktuellen Anforderung, die sich möglicherweise von der FilePath Eigenschaft unterscheidet, wenn eine Redirect Methode aufgerufen wurde. Die Methoden IsAppRelative, und ToAppRelative die IsAbsoluteMethoden geben Informationen zum virtuellen Pfad zurück.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
  protected void Page_Load(object sender, EventArgs e)
  {
    // <Snippet2> 
    StringBuilder sb = new StringBuilder();
    String pathstring = Context.Request.FilePath.ToString();
    sb.Append("Current file path = " + pathstring + "<br />");
    sb.Append("File name = " + VirtualPathUtility.GetFileName(pathstring).ToString() + "<br />");
    sb.Append("File extension = " + VirtualPathUtility.GetExtension(pathstring).ToString() + "<br />");
    sb.Append("Directory = " + VirtualPathUtility.GetDirectory(pathstring).ToString() + "<br />");
    Response.Write(sb.ToString());
    // </Snippet2>
    
    // <Snippet3>
    StringBuilder sb2 = new StringBuilder();
    String pathstring1 = Context.Request.CurrentExecutionFilePath.ToString();
    sb2.Append("Current Executing File Path = " + pathstring1.ToString() + "<br />");
    sb2.Append("Is Absolute = " + VirtualPathUtility.IsAbsolute(pathstring1).ToString() + "<br />");
    sb2.Append("Is AppRelative = " + VirtualPathUtility.IsAppRelative(pathstring1).ToString() + "<br />");
    sb2.Append("Make AppRelative = " + VirtualPathUtility.ToAppRelative(pathstring1).ToString() + "<br />");
    Response.Write(sb2.ToString());
    // </Snippet3>
}
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>VirtualPathUtility Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
    
    </div>
    </form>
</body>
</html>

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
    
    ' <Snippet2>
    Dim sb As New StringBuilder()
    Dim pathstring As String = Context.Request.FilePath.ToString()
    sb.Append("Current file path = " & pathstring & "<br />")
    sb.Append("File name = " & VirtualPathUtility.GetFileName(pathstring).ToString() & "<br />")
    sb.Append("File extension = " & VirtualPathUtility.GetExtension(pathstring).ToString() & "<br />")
    sb.Append("Directory = " & VirtualPathUtility.GetDirectory(pathstring).ToString() & "<br />")
    Response.Write(sb.ToString())
    ' </Snippet2>
    
    ' <Snippet3>
    Dim sb2 As New StringBuilder()
    Dim pathstring1 As String = Context.Request.CurrentExecutionFilePath.ToString()
    sb2.Append("Current Executing File Path = " & pathstring1.ToString() & "<br />")
    sb2.Append("Is Absolute = " & VirtualPathUtility.IsAbsolute(pathstring1).ToString() & "<br />")
    sb2.Append("Is AppRelative = " & VirtualPathUtility.IsAppRelative(pathstring1).ToString() & "<br />")
    sb2.Append("Make AppRelative = " & VirtualPathUtility.ToAppRelative(pathstring1).ToString() & "<br />")
    Response.Write(sb2.ToString())
    ' </Snippet3>

  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>VirtualPathUtility Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
    </div>
    </form>
</body>
</html>

Hinweise

Die VirtualPathUtility Klasse stellt Hilfsmethoden für allgemeine Vorgänge bereit, die virtuelle Pfade umfassen. Für ASP.NET Serversteuerelemente und Servercode werden virtuelle Pfade mithilfe des Webanwendungsstammoperators, der Tilde (~), häufig anstelle relativer und absoluter Pfade verwendet. Weitere Informationen finden Sie unter ASP.NET Webprojektpfade.

Verwenden Sie die VirtualPathUtility Klasse, wenn Sie anwendungsrelative Pfade in absolute virtuelle Pfade konvertieren müssen, wie dies bei der Entwicklung eines benutzerdefinierten Webdiensthandlers der Fall sein kann.

Ein absoluter virtueller Pfad beginnt mit dem Literalstrich (/). Ein relativer virtueller Pfad ist relativ zum Anwendungsstammverzeichnis, wenn es sich nur um eine Tilde (~) handelt oder mit der Tilde und einem doppelten umgekehrten Schrägstrich (~\\) oder der Tilde und einem Schrägstrich (~/) beginnt. Das Relative Erstellen eines virtuellen Pfads macht den Pfad unabhängig von der Anwendung.

Das virtuelle Verzeichnis für die Anwendung kann aus den AppDomainAppVirtualPath Eigenschaften abgerufen ApplicationPath werden.

Hinweis

Die VirtualPathUtility Klasse ist nicht für Sicherheits- oder Kanonisierungszwecke vorgesehen. Weitere Informationen zur Webanwendungssicherheit finden Sie unter Übersicht über Webanwendungssicherheitsbedrohungen. Allgemeine URL-Verarbeitungsfunktionen finden Sie unter Uri.

Methoden

Name Beschreibung
AppendTrailingSlash(String)

Fügt das Literal-Schrägstrich (/) an das Ende des virtuellen Pfads an, sofern noch nicht vorhanden.
Combine(String, String)

Kombiniert einen Basispfad und einen relativen Pfad.
GetDirectory(String)

Gibt den Verzeichnisteil eines virtuellen Pfads zurück.
GetExtension(String)

Ruft die Erweiterung der Datei ab, auf die im virtuellen Pfad verwiesen wird.
GetFileName(String)

Ruft den Dateinamen der Datei ab, auf die im virtuellen Pfad verwiesen wird.
IsAbsolute(String)

Gibt einen booleschen Wert zurück, der angibt, ob der angegebene virtuelle Pfad absolut ist; das heißt, sie beginnt mit einem Literalstrich (/).
IsAppRelative(String)

Gibt einen booleschen Wert zurück, der angibt, ob der angegebene virtuelle Pfad relativ zur Anwendung ist.
MakeRelative(String, String)

Gibt den relativen virtuellen Pfad von einem virtuellen Pfad zurück, der den Stammoperator (die Tilde [~]) enthält, zu einem anderen.
RemoveTrailingSlash(String)

Entfernt ein nachfolgendes Schrägstrichzeichen (/) aus einem virtuellen Pfad.
ToAbsolute(String, String)

Wandelt einen virtuellen Pfad mithilfe des angegebenen Anwendungspfads in einen absoluten Anwendungspfad um.
ToAbsolute(String)

Konvertiert einen virtuellen Pfad in einen absoluten Anwendungspfad.
ToAppRelative(String, String)

Konvertiert einen virtuellen Pfad mithilfe eines angegebenen Anwendungspfads in einen anwendungsrelativen Pfad.
ToAppRelative(String)

Wandelt einen virtuellen Pfad mithilfe des virtuellen Anwendungspfads in einen anwendungsrelativen Pfad um, der sich in der AppDomainAppVirtualPath Eigenschaft befindet.

Gilt für:

Weitere Informationen