VirtualPathUtility Třída

Reference

Definice

Obor názvů:: System.Web

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Poskytuje metody nástrojů pro běžné operace virtuální cesty.

public ref class VirtualPathUtility abstract sealed

public static class VirtualPathUtility

type VirtualPathUtility = class

Public Class VirtualPathUtility

Dědičnost: Object
VirtualPathUtility

Příklady

Následující příklad kódu ukazuje, jak používat VirtualPathUtility třídu a některé její metody. FilePath Nejprve vlastnost vygeneruje virtuální cestu k webové stránce. Funkce GetFileName, GetExtensiona GetDirectory metody vrací informace o virtuální cestě. CurrentExecutionFilePath Dále vlastnost vygeneruje virtuální cestu aktuálního požadavku, která se může lišit od FilePath vlastnosti, pokud Redirect byla volána metoda. Funkce IsAbsolute, IsAppRelativea ToAppRelative metody vrací informace o virtuální cestě.

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

Poznámky

Třída VirtualPathUtility poskytuje pomocné metody pro běžné operace zahrnující virtuální cesty. U ASP.NET serverových ovládacích prvků a kódu serveru se místo relativních a absolutních cest používají virtuální cesty, které používají kořenový operátor webové aplikace, vlnovku (~). Další informace najdete v tématu ASP.NET Cesty k webovému Project.

Třídu VirtualPathUtility použijte v případě, že potřebujete převést cesty relativní k aplikaci na absolutní virtuální cesty, jak může být případ při vývoji vlastní obslužné rutiny webové služby.

Absolutní virtuální cesta začíná značkou lomítka literálu (/). Relativní virtuální cesta je relativní vzhledem ke kořenovému adresáři aplikace, pokud se jedná pouze o tildu (~) nebo začíná vlnovkou a dvojitým zpětným lomítkem (\~\) nebo vlnovkou a lomítkem (~/). Když nastavíte relativní virtuální cestu, bude cesta nezávislá na aplikaci.

Virtuální adresář aplikace lze získat z AppDomainAppVirtualPath vlastností a ApplicationPath vlastností.

Poznámka

Třída VirtualPathUtility není určena pro účely zabezpečení nebo kanonizace. Další informace o zabezpečení webových aplikací najdete v tématu Přehled hrozeb zabezpečení webových aplikací. Obecné funkce zpracování adres URL naleznete v tématu Uri.

Metody

AppendTrailingSlash(String)	Připojí k konci virtuální cesty značku lomítka literálu (/), pokud ještě neexistuje.
Combine(String, String)	Kombinuje základní cestu a relativní cestu.
GetDirectory(String)	Vrátí část adresáře virtuální cesty.
GetExtension(String)	Načte příponu souboru, na který se odkazuje ve virtuální cestě.
GetFileName(String)	Načte název souboru, na který odkazuje virtuální cesta.
IsAbsolute(String)	Vrátí logickou hodnotu označující, jestli je zadaná virtuální cesta absolutní. to znamená, že začíná znakem lomítka literálu (/).
IsAppRelative(String)	Vrátí logickou hodnotu označující, jestli je zadaná virtuální cesta relativní k aplikaci.
MakeRelative(String, String)	Vrátí relativní virtuální cestu z jedné virtuální cesty obsahující kořenový operátor (tilda [~]) do jiné.
RemoveTrailingSlash(String)	Odebere koncové lomítko (/) z virtuální cesty.
ToAbsolute(String)	Převede virtuální cestu na absolutní cestu aplikace.
ToAbsolute(String, String)	Převede virtuální cestu na absolutní cestu aplikace pomocí zadané cesty aplikace.
ToAppRelative(String)	Převede virtuální cestu na cestu relativní k aplikaci pomocí virtuální cesty aplikace, která je ve AppDomainAppVirtualPath vlastnosti.
ToAppRelative(String, String)	Převede virtuální cestu na cestu relativní k aplikaci pomocí zadané cesty aplikace.

Platí pro

Share via