Aracılığıyla paylaş

VirtualPathUtility Sınıf

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ği, sınıfının ve bazı yöntemlerinin VirtualPathUtility nasıl kullanılacağını gösterir. İ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 bir yöntem çağrıldığında Redirect özelliğinden farklı olabilecek geçerli isteğin FilePath sanal yolunu oluşturur. 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şleci, tilde (~) kullanan sanal yollar genellikle göreli ve mutlak yollar yerine kullanılır. Daha fazla bilgi için bkz. ASP.NET Web Projesi Yolları.

Özel bir 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 eğik çizgi işaretiyle (/) başlar. Göreli sanal yol, yalnızca bir tilde (~) ise veya tilde ve çift ters eğik çizgi (~\\) veya tilde ve eğik çizgi (~/) ile başlıyorsa, uygulama kök dizinine göredir. Bir sanal yolun göreli hale getirilmesi, yolun uygulamadan bağımsız olmasını sağlar.

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

Uyarı

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

Yöntemler

Name Description
AppendTrailingSlash(String)

Sanal yolun sonuna sabit eğik çizgi işaretini (/) ekler( yoksa).
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 bir eğik ç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, String)

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

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

Belirtilen uygulama yolunu kullanarak sanal yolu uygulama göreli 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.

Şunlara uygulanır

Ayrıca bkz.