Bagikan melalui

VirtualPathUtility Kelas

  • Referensi

Definisi

Ruang nama:
System.Web
Rakitan:
System.Web.dll

Menyediakan metode utilitas untuk operasi jalur virtual umum.

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

Contoh

Contoh kode berikut menunjukkan cara menggunakan VirtualPathUtility kelas dan beberapa metodenya. Pertama, FilePath properti menghasilkan jalur virtual ke halaman Web. Metode GetFileName, GetExtension, dan GetDirectory mengembalikan informasi tentang jalur virtual. Selanjutnya, CurrentExecutionFilePath properti menghasilkan jalur virtual permintaan saat ini, yang mungkin berbeda dari FilePath properti , jika Redirect metode dipanggil. Metode IsAbsolute, IsAppRelative, dan ToAppRelative mengembalikan informasi tentang jalur virtual.

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

Keterangan

Kelas ini VirtualPathUtility menyediakan metode utilitas untuk operasi umum yang melibatkan jalur virtual. Untuk ASP.NET kontrol server dan kode server, jalur virtual menggunakan operator root aplikasi Web, tilde (~), biasanya digunakan alih-alih jalur relatif dan absolut. Untuk informasi selengkapnya, lihat ASP.NET Jalur Proyek Web.

VirtualPathUtility Gunakan kelas saat Anda perlu mengonversi jalur relatif aplikasi ke jalur virtual absolut, seperti yang mungkin terjadi dalam mengembangkan penangan layanan Web kustom.

Jalur virtual absolut dimulai dengan tanda garis miring harfiah (/). Jalur virtual relatif relatif terhadap direktori akar aplikasi, jika itu hanya tilde (~) atau dimulai dengan tilde dan garis miring terbalik ganda (~\\) atau tilde dan tanda garis miring (~/). Membuat jalur virtual relatif membuat jalur independen dari aplikasi.

Direktori virtual untuk aplikasi dapat diperoleh dari AppDomainAppVirtualPath properti dan ApplicationPath .

Catatan

Kelas VirtualPathUtility ini tidak ditujukan untuk tujuan keamanan atau kanonisisasi. Untuk informasi selengkapnya tentang keamanan aplikasi Web, lihat Gambaran Umum Ancaman Keamanan Aplikasi Web. Untuk fungsionalitas pemrosesan URL generik, lihat Uri.

Metode

AppendTrailingSlash(String)

Menambahkan tanda garis miring harfiah (/) ke akhir jalur virtual, jika belum ada.
Combine(String, String)

Menggabungkan jalur dasar dan jalur relatif.
GetDirectory(String)

Mengembalikan bagian direktori dari jalur virtual.
GetExtension(String)

Mengambil ekstensi file yang dirujuk di jalur virtual.
GetFileName(String)

Mengambil nama file file yang dirujuk di jalur virtual.
IsAbsolute(String)

Mengembalikan nilai Boolean yang menunjukkan apakah jalur virtual yang ditentukan bersifat absolut; artinya, dimulai dengan tanda garis miring harfiah (/).
IsAppRelative(String)

Mengembalikan nilai Boolean yang menunjukkan apakah jalur virtual yang ditentukan relatif terhadap aplikasi.
MakeRelative(String, String)

Mengembalikan jalur virtual relatif dari satu jalur virtual yang berisi operator akar (tilde [~]) ke jalur virtual lainnya.
RemoveTrailingSlash(String)

Menghapus tanda garis miring berikutnya (/) dari jalur virtual.
ToAbsolute(String)

Mengonversi jalur virtual ke jalur absolut aplikasi.
ToAbsolute(String, String)

Mengonversi jalur virtual ke jalur absolut aplikasi menggunakan jalur aplikasi yang ditentukan.
ToAppRelative(String)

Mengonversi jalur virtual ke jalur relatif aplikasi menggunakan jalur virtual aplikasi yang ada di AppDomainAppVirtualPath properti .
ToAppRelative(String, String)

Mengonversi jalur virtual ke jalur relatif aplikasi menggunakan jalur aplikasi tertentu.

Berlaku untuk

Lihat juga