VirtualPathUtility Sınıf

  • Başvuru

Tanım

Ad Alanı:
System.Web
Bütünleştirilmiş Kod:
System.Web.dll

Yaygın sanal yol işlemleri için yardımcı program yöntemleri sağlar.

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

Örnekler

Aşağıdaki kod örneğinde sınıfın ve bazı yöntemlerinin VirtualPathUtility nasıl kullanılacağı gösterilmektedir. İlk olarak, FilePath özelliği Web sayfasının sanal yolunu oluşturur. GetFileName, GetExtensionve GetDirectory yöntemleri sanal yol hakkında bilgi döndürür. Ardından, CurrentExecutionFilePath özelliği geçerli isteğin sanal yolunu oluşturur ve yöntem çağrıldığında Redirect özelliğinden FilePath farklı olabilir. IsAbsolute, IsAppRelativeve ToAppRelative yöntemleri sanal yol hakkında bilgi döndürür.

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

Açıklamalar

sınıfı, VirtualPathUtility sanal yollar içeren yaygın işlemler için yardımcı program yöntemleri sağlar. ASP.NET sunucu denetimleri ve sunucu kodu için, Web uygulaması kök işlecini kullanan sanal yollar, göreli ve mutlak yollar yerine yaygın olarak tilde (~) kullanılır. Daha fazla bilgi için bkz. ASP.NET Web Project Yolları.

Özel Web hizmeti işleyicisi VirtualPathUtility geliştirmede olduğu gibi, uygulama göreli yollarını mutlak sanal yollara dönüştürmeniz gerektiğinde sınıfını kullanın.

Mutlak sanal yol değişmez çizgi işaretiyle (/) başlar. Göreli sanal yol, yalnızca bir tilde () ise veya tilde ve çift ters eğik çizgiyle (~) veya tilde ve eğik çizgi işaretiyle (~\\~/) başlıyorsa, uygulama kök dizinine göredir. Bir sanal yolu göreli hale getirmek, yolu uygulamadan bağımsız hale getirir.

Uygulamanın sanal dizini ve ApplicationPath özelliklerinden alınabilirAppDomainAppVirtualPath.

Not

VirtualPathUtility sınıfı güvenlik veya kurallı hale getirme amacıyla tasarlanmamıştır. Web uygulaması güvenliği hakkında daha fazla bilgi için bkz. Web Uygulaması Güvenliği Tehditlerine Genel Bakış. Genel URL işleme işlevselliği için bkz Uri. .

Yöntemler

AppendTrailingSlash(String)

Henüz yoksa, sabit eğik çizgi işaretini (/) sanal yolun sonuna ekler.
Combine(String, String)

Temel yol ile göreli yolu birleştirir.
GetDirectory(String)

Sanal yolun dizin bölümünü döndürür.
GetExtension(String)

Sanal yolda başvuruda bulunılan dosyanın uzantısını alır.
GetFileName(String)

Sanal yolda başvuruda bulunılan dosyanın dosya adını alır.
IsAbsolute(String)

Belirtilen sanal yolun mutlak olup olmadığını belirten bir Boole değeri döndürür; yani, değişmez çizgi işaretiyle (/) başlar.
IsAppRelative(String)

Belirtilen sanal yolun uygulamaya göre olup olmadığını belirten bir Boole değeri döndürür.
MakeRelative(String, String)

Kök işlecini (tilde [~]) içeren bir sanal yoldan diğerine göreli sanal yolu döndürür.
RemoveTrailingSlash(String)

Bir sanal yoldan sondaki eğik çizgi işaretini (/) kaldırır.
ToAbsolute(String)

Sanal yolu uygulama mutlak yoluna dönüştürür.
ToAbsolute(String, String)

Belirtilen uygulama yolunu kullanarak sanal yolu bir uygulama mutlak yoluna dönüştürür.
ToAppRelative(String)

özelliğindeki AppDomainAppVirtualPath uygulama sanal yolunu kullanarak bir sanal yolu uygulama göreli yoluna dönüştürür.
ToAppRelative(String, String)

Belirtilen uygulama yolunu kullanarak sanal yolu uygulama göreli yoluna dönüştürür.

Şunlara uygulanır

Ayrıca bkz.