VirtualPathUtility VirtualPathUtility VirtualPathUtility VirtualPathUtility Class

Definition

Stellt Dienstprogrammmethoden für allgemeine Operationen mit virtuellen Pfaden bereit.Provides utility methods for common virtual path operations.

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

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die VirtualPathUtility -Klasse und einige ihrer Methoden verwendet werden.The following code example demonstrates how to use the VirtualPathUtility class and some of its methods. Zuerst generiert die FilePath -Eigenschaft den virtuellen Pfad zur Webseite.First, the FilePath property generates the virtual path to the Web page. Die GetFileNameMethoden GetExtension, undGetDirectory geben Informationen über den virtuellen Pfad zurück.The GetFileName, GetExtension, and GetDirectory methods return information about the virtual path. Als nächstes generiert CurrentExecutionFilePath die-Eigenschaft einen virtuellen Pfad der aktuellen Anforderung, der sich von der FilePath -Eigenschaft unterscheiden kann, Redirect wenn eine-Methode aufgerufen wurde.Next, the CurrentExecutionFilePath property generates a virtual path of the current request, which might be different from the FilePath property, if a Redirect method was called. Die IsAbsoluteMethoden IsAppRelative, undToAppRelative geben Informationen über den virtuellen Pfad zurück.The IsAbsolute, IsAppRelative, and ToAppRelative methods return information about the virtual path.

<%@ 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 bereit, die virtuelle Pfade betreffen.The VirtualPathUtility class provides utility methods for common operations involving virtual paths. Für ASP.NET-Server Steuerelemente und Servercode werden virtuelle Pfade, die den Webanwendungs Stamm Operator verwenden, die Tilde (~) häufig anstelle von relativen und absoluten Pfaden verwendet.For ASP.NET server controls and server code, virtual paths using the Web application root operator, the tilde (~), commonly are used instead of relative and absolute paths. Weitere Informationen finden Sie unter ASP.net Web Project Path.For more information, see ASP.NET Web Project Paths.

Verwenden Sie VirtualPathUtility die-Klasse, wenn Sie Anwendungs relative Pfade zu absoluten virtuellen Pfaden konvertieren müssen, wie es bei der Entwicklung eines benutzerdefinierten Webdienst Handlers der Fall sein kann.Use the VirtualPathUtility class when you need to convert application-relative paths to absolute virtual paths, as might be the case in developing a custom Web service handler.

Ein absoluter virtueller Pfad beginnt mit dem literalen Schrägstrich (/).An absolute virtual path starts with the literal slash mark (/). Ein relativer virtueller Pfad ist relativ zum Stammverzeichnis der Anwendung, wenn es sich nur um eine Tilde~() handelt oder mit der Tilde und einem doppelten umgekehrten schräg~Strich (\\) oder der Tilde und einem schräg~Strich (/) beginnt.A relative virtual path is relative to the application root directory, if it is just a tilde (~) or starts with the tilde and a double backslash (~\\) or the tilde and a slash mark (~/). Durch die relative Erstellung eines virtuellen Pfades wird der Pfad unabhängig von der Anwendung.Making a virtual path relative makes the path independent of the application.

Das virtuelle Verzeichnis für die Anwendung kann aus den AppDomainAppVirtualPath Eigenschaften und ApplicationPath abgerufen werden.The virtual directory for the application can be obtained from the AppDomainAppVirtualPath and ApplicationPath properties.

Hinweis

Die VirtualPathUtility -Klasse ist nicht für Sicherheits-oder Kanonisierungszwecke vorgesehen.The VirtualPathUtility class is not intended for security or canonicalization purposes. Weitere Informationen zur Webanwendungs Sicherheit finden Sie unter Übersicht über Sicherheitsbedrohungen für Webanwendungen.For more information about Web application security, see Overview of Web Application Security Threats. Informationen zur generischen URL-Verarbeitung Urifinden Sie unter.For generic URL processing functionality, see Uri.

Methoden

AppendTrailingSlash(String) AppendTrailingSlash(String) AppendTrailingSlash(String) AppendTrailingSlash(String)

Fügt das Schrägstrichliteral (/) am Ende des virtuellen Pfads an, falls es nicht bereits vorhanden ist.Appends the literal slash mark (/) to the end of the virtual path, if one does not already exist.

Combine(String, String) Combine(String, String) Combine(String, String) Combine(String, String)

Kombiniert einen Basispfad und einen relativen Pfad.Combines a base path and a relative path.

GetDirectory(String) GetDirectory(String) GetDirectory(String) GetDirectory(String)

Gibt den Verzeichnisabschnitt eines virtuellen Pfads zurück.Returns the directory portion of a virtual path.

GetExtension(String) GetExtension(String) GetExtension(String) GetExtension(String)

Ruft die Erweiterung der Datei ab, auf die im virtuellen Pfad verwiesen wird.Retrieves the extension of the file that is referenced in the virtual path.

GetFileName(String) GetFileName(String) GetFileName(String) GetFileName(String)

Ruft den Namen der Datei ab, auf die im virtuellen Pfad verwiesen wird.Retrieves the file name of the file that is referenced in the virtual path.

IsAbsolute(String) IsAbsolute(String) IsAbsolute(String) IsAbsolute(String)

Gibt einen booleschen Wert zurück, der anzeigt, ob der angegebene virtuelle Pfad absolut ist, d. h. mit einem Schrägstrichliteral (/) beginnt.Returns a Boolean value indicating whether the specified virtual path is absolute; that is, it starts with a literal slash mark (/).

IsAppRelative(String) IsAppRelative(String) IsAppRelative(String) IsAppRelative(String)

Gibt einen booleschen Wert zurück, der angibt, ob der angegebene virtuelle Pfad zur Anwendung relativ ist.Returns a Boolean value indicating whether the specified virtual path is relative to the application.

MakeRelative(String, String) MakeRelative(String, String) MakeRelative(String, String) MakeRelative(String, String)

Gibt den relativen virtuellen Pfad von einem virtuellem Pfad mit Stammoperator (die Tilde [~]) zu einem anderen zurück.Returns the relative virtual path from one virtual path containing the root operator (the tilde [~]) to another.

RemoveTrailingSlash(String) RemoveTrailingSlash(String) RemoveTrailingSlash(String) RemoveTrailingSlash(String)

Entfernt einen nachgestellten Schrägstrich (/) aus einem virtuellen Pfad.Removes a trailing slash mark (/) from a virtual path.

ToAbsolute(String) ToAbsolute(String) ToAbsolute(String) ToAbsolute(String)

Konvertiert einen virtuellen Pfad in den absoluten Pfad einer Anwendung.Converts a virtual path to an application absolute path.

ToAbsolute(String, String) ToAbsolute(String, String) ToAbsolute(String, String) ToAbsolute(String, String)

Konvertiert mit dem angegebenen Anwendungspfad einen virtuellen Pfad in den absoluten Pfad einer Anwendung.Converts a virtual path to an application absolute path using the specified application path.

ToAppRelative(String) ToAppRelative(String) ToAppRelative(String) 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.Converts a virtual path to an application-relative path using the application virtual path that is in the AppDomainAppVirtualPath property.

ToAppRelative(String, String) ToAppRelative(String, String) ToAppRelative(String, String) ToAppRelative(String, String)

Konvertiert mit dem angegebenen Anwendungspfad einen virtuellen Pfad in den zur Anwendung relativen Pfad.Converts a virtual path to an application-relative path using a specified application path.

Gilt für:

Siehe auch