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 die VirtualPathUtility -Klasse und einige ihrer Methoden verwendet werden. Zunächst generiert die FilePath -Eigenschaft den virtuellen Pfad zur Webseite. Die GetFileNameMethoden , GetExtensionund GetDirectory geben Informationen zum virtuellen Pfad zurück. Als Nächstes generiert die CurrentExecutionFilePath -Eigenschaft einen virtuellen Pfad der aktuellen Anforderung, der sich von der FilePath -Eigenschaft unterscheiden kann, wenn eine Redirect Methode aufgerufen wurde. Die IsAbsoluteMethoden , IsAppRelativeund ToAppRelative 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 Hilfsprogrammmethoden für allgemeine Vorgänge mit virtuellen Pfaden bereit. Für ASP.NET Serversteuerelemente und Servercode werden virtuelle Pfade mit dem Webanwendungsstammoperator, der Tilde (~), häufig anstelle von relativen und absoluten Pfaden 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 könnte.

Ein absoluter virtueller Pfad beginnt mit dem literalen Schrägstrich (/). Ein relativer virtueller Pfad ist relativ zum Anwendungsstammverzeichnis, wenn er nur eine Tilde (~) ist oder mit der Tilde und einem doppelten umgekehrten Schrägstrich (~\\) oder der Tilde und einem Schrägstrich (~/) beginnt. Durch relativieren eines virtuellen Pfads wird der Pfad unabhängig von der Anwendung.

Das virtuelle Verzeichnis für die Anwendung kann über die AppDomainAppVirtualPath Eigenschaften und ApplicationPath abgerufen werden.

Hinweis

Die VirtualPathUtility -Klasse ist nicht für Sicherheits- oder Kanonisierungszwecke vorgesehen. Weitere Informationen zur Sicherheit von Webanwendungen finden Sie unter Übersicht über Sicherheitsbedrohungen für Webanwendungen. Generische 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:

Freigeben über