VirtualPathUtility Klass

Definition

Namnområde:
System.Web
Sammansättning:
System.Web.dll

Tillhandahåller verktygsmetoder för vanliga åtgärder för virtuella sökvägar.

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

Exempel

Följande kodexempel visar hur du VirtualPathUtility använder klassen och några av dess metoder. Först genererar egenskapen FilePath den virtuella sökvägen till webbsidan. Metoderna GetFileName, GetExtensionoch GetDirectory returnerar information om den virtuella sökvägen. CurrentExecutionFilePath Sedan genererar egenskapen en virtuell sökväg för den aktuella begäran, som kan skilja sig från FilePath egenskapen, om en Redirect metod anropades. Metoderna IsAbsolute, IsAppRelativeoch ToAppRelative returnerar information om den virtuella sökvägen.

<%@ 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>

Kommentarer

Klassen VirtualPathUtility tillhandahåller verktygsmetoder för vanliga åtgärder som involverar virtuella sökvägar. För ASP.NET serverkontroller och serverkod används virtuella sökvägar med rotoperatorn webbprogram, tilde (~), vanligtvis i stället för relativa och absoluta sökvägar. Mer information finns i ASP.NET Web Project Paths.

VirtualPathUtility Använd klassen när du behöver konvertera programrelativa sökvägar till absoluta virtuella sökvägar, vilket kan vara fallet när du utvecklar en anpassad webbtjänsthanterare.

En absolut virtuell sökväg börjar med den literala snedstrecksmarkeringen (/). En relativ virtuell sökväg är relativ till programmets rotkatalog, om den bara är en tilde (~) eller börjar med tilde och ett dubbelt omvänt snedstreck (~\\) eller tilde och ett snedstreck (~/). Att göra en virtuell sökväg relativ gör sökvägen oberoende av programmet.

Den virtuella katalogen för programmet kan hämtas från AppDomainAppVirtualPath egenskaperna och ApplicationPath .

Note

Klassen VirtualPathUtility är inte avsedd för säkerhets- eller kanoniseringsändamål. Mer information om säkerhet för webbprogram finns i Översikt över säkerhetshot för webbprogram. Allmänna funktioner för URL-bearbetning finns i Uri.

Metoder

Name Description
AppendTrailingSlash(String)

Lägger till literalstrecket (/) i slutet av den virtuella sökvägen, om det inte redan finns någon.
Combine(String, String)

Kombinerar en bassökväg och en relativ sökväg.
GetDirectory(String)

Returnerar katalogdelen av en virtuell sökväg.
GetExtension(String)

Hämtar filnamnstillägget som refereras till i den virtuella sökvägen.
GetFileName(String)

Hämtar filnamnet för filen som refereras till i den virtuella sökvägen.
IsAbsolute(String)

Returnerar ett booleskt värde som anger om den angivna virtuella sökvägen är absolut. det vill:et börjar med ett literalt snedstreck (/).
IsAppRelative(String)

Returnerar ett booleskt värde som anger om den angivna virtuella sökvägen är relativ till programmet.
MakeRelative(String, String)

Returnerar den relativa virtuella sökvägen från en virtuell sökväg som innehåller rotoperatorn (tilde [~]) till en annan.
RemoveTrailingSlash(String)

Tar bort ett avslutande snedstreck (/) från en virtuell sökväg.
ToAbsolute(String, String)

Konverterar en virtuell sökväg till en absolut sökväg för ett program med den angivna programsökvägen.
ToAbsolute(String)

Konverterar en virtuell sökväg till en absolut sökväg för ett program.
ToAppRelative(String, String)

Konverterar en virtuell sökväg till en programrelativ sökväg med en angiven programsökväg.
ToAppRelative(String)

Konverterar en virtuell sökväg till en programrelativ sökväg med hjälp av den virtuella sökvägen för programmet som finns i AppDomainAppVirtualPath egenskapen.

Gäller för

Se även