VirtualPathUtility Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Fornisce metodi di utilità per le operazioni comuni relative ai percorsi virtuali.

public ref class VirtualPathUtility abstract sealed

public static class VirtualPathUtility

type VirtualPathUtility = class

Public Class VirtualPathUtility

Ereditarietà: Object
VirtualPathUtility

Esempio

Nell'esempio di codice seguente viene illustrato come usare la VirtualPathUtility classe e alcuni dei relativi metodi. Innanzitutto, la FilePath proprietà genera il percorso virtuale della pagina Web. I GetFileNamemetodi , GetExtensione GetDirectory restituiscono informazioni sul percorso virtuale. CurrentExecutionFilePath La proprietà genera quindi un percorso virtuale della richiesta corrente, che potrebbe essere diverso dalla FilePath proprietà , se è stato chiamato un Redirect metodo . I IsAbsolutemetodi , IsAppRelativee ToAppRelative restituiscono informazioni sul percorso virtuale.

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

Commenti

La VirtualPathUtility classe fornisce metodi di utilità per le operazioni comuni che coinvolgono percorsi virtuali. Per ASP.NET controlli server e codice server, i percorsi virtuali che usano l'operatore radice dell'applicazione Web, la tilde (~), in genere vengono usati anziché percorsi relativi e assoluti. Per altre informazioni, vedere percorsi ASP.NET Web Project.

Usare la VirtualPathUtility classe quando è necessario convertire i percorsi relativi all'applicazione in percorsi virtuali assoluti, come potrebbe essere il caso nello sviluppo di un gestore di servizi Web personalizzato.

Un percorso virtuale assoluto inizia con il segno di barra letterale (/). Un percorso virtuale relativo è relativo alla directory radice dell'applicazione, se è solo una tilde (~) o inizia con la tilde e una doppia barra rovesciata (~\\) o la tilde e una barra (~/). La creazione di un percorso virtuale rende il percorso indipendente dall'applicazione.

La directory virtuale per l'applicazione può essere ottenuta dalle AppDomainAppVirtualPath proprietà e ApplicationPath .

Nota

La VirtualPathUtility classe non è destinata a scopi di sicurezza o canonizzazione. Per altre informazioni sulla sicurezza delle applicazioni Web, vedere Panoramica delle minacce alla sicurezza delle applicazioni Web. Per la funzionalità di elaborazione degli URL generici, vedere Uri.

Metodi

AppendTrailingSlash(String)	Accoda la barra (/) alla fine del percorso virtuale, se non esiste già.
Combine(String, String)	Combina un percorso base e uno relativo.
GetDirectory(String)	Restituisce la parte di directory di un percorso virtuale.
GetExtension(String)	Recupera l'estensione del file cui viene fatto riferimento nel percorso virtuale.
GetFileName(String)	Recupera il nome del file cui viene fatto riferimento nel percorso virtuale.
IsAbsolute(String)	Restituisce un valore booleano indicante se il percorso virtuale specificato è assoluto, ovvero inizia con una barra (/).
IsAppRelative(String)	Restituisce un valore booleano indicante se il percorso virtuale specificato è relativo all'applicazione.
MakeRelative(String, String)	Restituisce il percorso virtuale relativo da un percorso virtuale contenente il carattere tilde (~) che rappresenta la directory radice a un altro.
RemoveTrailingSlash(String)	Rimuove la barra (/) finale da un percorso virtuale.
ToAbsolute(String)	Converte un percorso virtuale in un percorso assoluto dell'applicazione.
ToAbsolute(String, String)	Converte un percorso virtuale in un percorso assoluto dell'applicazione utilizzando il percorso applicazione specificato.
ToAppRelative(String)	Converte un percorso virtuale in uno percorso relativo all'applicazione utilizzando il percorso virtuale dell'applicazione presente nella proprietà AppDomainAppVirtualPath.
ToAppRelative(String, String)	Converte un percorso virtuale in un percorso relativo all'applicazione utilizzando un percorso applicazione specificato.

Si applica a