VirtualPathUtility Osztály

Definíció

Névtér:
System.Web
Szerelvény:
System.Web.dll

Segédprogram-metódusokat biztosít a gyakori virtuális elérésiút-műveletekhez.

public ref class VirtualPathUtility abstract sealed
public static class VirtualPathUtility
type VirtualPathUtility = class
Public Class VirtualPathUtility
Öröklődés
Object
VirtualPathUtility

Példák

Az alábbi példakód bemutatja, hogyan használható az VirtualPathUtility osztály és néhány metódusa. Először a FilePath tulajdonság létrehozza a weblap virtuális elérési útját. A GetFileName, GetExtensionés GetDirectory metódusok a virtuális útvonalra vonatkozó információkat ad vissza. Ezután a CurrentExecutionFilePath tulajdonság létrehozza az aktuális kérés virtuális elérési útját, amely eltérő lehet a FilePath tulajdonságtól, ha metódust Redirect hívtak meg. A IsAbsolute, IsAppRelativeés ToAppRelative metódusok a virtuális útvonalra vonatkozó információkat ad vissza.

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

Megjegyzések

Az VirtualPathUtility osztály segédprogram-metódusokat biztosít a virtuális útvonalakat érintő gyakori műveletekhez. A ASP.NET kiszolgálóvezérlők és kiszolgálókódok esetében a webalkalmazás gyökéroperátorát használó virtuális elérési utakat általában a tilde (~) használja relatív és abszolút elérési utak helyett. További információ: ASP.NET Webes Project elérési utak.

Akkor használja az VirtualPathUtility osztályt, ha az alkalmazás relatív elérési útjait abszolút virtuális elérési utakká kell konvertálnia, ahogyan az egyéni webszolgáltatás-kezelők fejlesztésénél is előfordulhat.

Az abszolút virtuális elérési út a literál perjellel (/) kezdődik. A relatív virtuális elérési út az alkalmazás gyökérkönyvtárához képest van, ha csak egy tilde (~) vagy a tilde és a dupla fordított perjel (~\) vagy a tilde és a perjel (~/). A virtuális elérési út relatívvá tétele függetleníti az elérési utat az alkalmazástól.

Az alkalmazás virtuális könyvtára a tulajdonságokból és AppDomainAppVirtualPath a ApplicationPath tulajdonságokból kérhető le.

Note

Az VirtualPathUtility osztály nem biztonsági vagy canonicalizálási célokra készült. A webalkalmazások biztonságával kapcsolatos további információkért tekintse meg a webalkalmazások biztonsági fenyegetéseinek áttekintését. Általános URL-feldolgozási funkciókért lásd: Uri.

Metódusok

Name Description
AppendTrailingSlash(String)

Hozzáfűzi a literál perjelet (/) a virtuális elérési út végéhez, ha még nem létezik.
Combine(String, String)

Egy alap elérési utat és egy relatív elérési utat egyesít.
GetDirectory(String)

A virtuális elérési út könyvtárrészét adja vissza.
GetExtension(String)

Lekéri a virtuális elérési úton hivatkozott fájl kiterjesztését.
GetFileName(String)

Lekéri a virtuális elérési úton hivatkozott fájl nevét.
IsAbsolute(String)

Logikai értéket ad vissza, amely azt jelzi, hogy a megadott virtuális elérési út abszolút-e; vagyis egy literális perjellel (/) kezdődik.
IsAppRelative(String)

Logikai értéket ad vissza, amely azt jelzi, hogy a megadott virtuális elérési út az alkalmazáshoz képest van-e.
MakeRelative(String, String)

A gyökér operátort (a tilde [~]) tartalmazó virtuális elérési út relatív virtuális elérési útját adja vissza egy másikhoz.
RemoveTrailingSlash(String)

Eltávolít egy záró perjelet (/) egy virtuális útvonalról.
ToAbsolute(String, String)

A megadott alkalmazáselérési út használatával a virtuális elérési utat abszolút elérési útmá alakítja át.
ToAbsolute(String)

Egy virtuális elérési utat abszolút elérési útmá alakít át.
ToAppRelative(String, String)

Egy virtuális elérési utat egy alkalmazás relatív elérési útjának alakít át egy megadott alkalmazáselérési út használatával.
ToAppRelative(String)

A virtuális elérési utat alkalmazás-relatív elérési úttá alakítja a AppDomainAppVirtualPath tulajdonságban található alkalmazás virtuális elérési útjának használatával.

A következőre érvényes:

Lásd még