VirtualPathUtility Klasse

Referenz

Definition

Namespace:: System.Web

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt Dienstprogrammmethoden für allgemeine Operationen mit virtuellen Pfaden 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 veranschaulicht, wie Sie die VirtualPathUtility Klasse und einige ihrer Methoden verwenden. Zuerst generiert die FilePath Eigenschaft den virtuellen Pfad zur Webseite. Die GetFileName, GetExtensionund GetDirectory Methoden 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 IsAbsolute, IsAppRelativeund ToAppRelative Methoden 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 mit virtuellen Pfaden bereit. Für ASP.NET Serversteuerelemente und Servercode werden virtuelle Pfade mit dem Stammoperator der Webanwendung, der Tilde (~) häufig anstelle relativer und absoluter Pfade verwendet. Weitere Informationen finden Sie unter ASP.NET Web Project Pfade.

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

Ein absoluter virtueller Pfad beginnt mit dem Literal-Schrägstrich (/). 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 Und-Eigenschaften ApplicationPath abgerufen 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

AppendTrailingSlash(String)	Fügt das Schrägstrichliteral (/) am Ende des virtuellen Pfads an, falls es nicht bereits vorhanden ist.
Combine(String, String)	Kombiniert einen Basispfad und einen relativen Pfad.
GetDirectory(String)	Gibt den Verzeichnisabschnitt eines virtuellen Pfads zurück.
GetExtension(String)	Ruft die Erweiterung der Datei ab, auf die im virtuellen Pfad verwiesen wird.
GetFileName(String)	Ruft den Namen der Datei ab, auf die im virtuellen Pfad verwiesen wird.
IsAbsolute(String)	Gibt einen booleschen Wert zurück, der anzeigt, ob der angegebene virtuelle Pfad absolut ist, d. h. mit einem Schrägstrichliteral (/) beginnt.
IsAppRelative(String)	Gibt einen booleschen Wert zurück, der angibt, ob der angegebene virtuelle Pfad zur Anwendung relativ ist.
MakeRelative(String, String)	Gibt den relativen virtuellen Pfad von einem virtuellem Pfad mit Stammoperator (die Tilde [~]) zu einem anderen zurück.
RemoveTrailingSlash(String)	Entfernt einen nachgestellten Schrägstrich (/) aus einem virtuellen Pfad.
ToAbsolute(String)	Konvertiert einen virtuellen Pfad in den absoluten Pfad einer Anwendung.
ToAbsolute(String, String)	Konvertiert mit dem angegebenen Anwendungspfad einen virtuellen Pfad in den absoluten Pfad einer Anwendung.
ToAppRelative(String)	Konvertiert einen virtuellen Pfad in einen zur Anwendung relativen Pfad mithilfe des virtuellen Pfads der Anwendung, der in der AppDomainAppVirtualPath-Eigenschaft enthalten ist.
ToAppRelative(String, String)	Konvertiert mit dem angegebenen Anwendungspfad einen virtuellen Pfad in den zur Anwendung relativen Pfad.

Gilt für