Partager via

VirtualPathUtility Classe

Définition

Espace de noms:
System.Web
Assembly:
System.Web.dll

Fournit des méthodes utilitaires pour les opérations courantes de chemin d’accès virtuel.

public ref class VirtualPathUtility abstract sealed
public static class VirtualPathUtility
type VirtualPathUtility = class
Public Class VirtualPathUtility
Héritage
Object
VirtualPathUtility

Exemples

L’exemple de code suivant montre comment utiliser la VirtualPathUtility classe et certaines de ses méthodes. Tout d’abord, la FilePath propriété génère le chemin d’accès virtuel à la page Web. Les GetFileNameméthodes et GetDirectory les méthodes GetExtensionretournent des informations sur le chemin d’accès virtuel. Ensuite, la CurrentExecutionFilePath propriété génère un chemin d’accès virtuel de la requête actuelle, qui peut être différent de la FilePath propriété, si une Redirect méthode a été appelée. Les IsAbsoluteméthodes et ToAppRelative les méthodes IsAppRelativeretournent des informations sur le chemin d’accès virtuel.

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

Remarques

La VirtualPathUtility classe fournit des méthodes utilitaires pour les opérations courantes impliquant des chemins virtuels. Pour ASP.NET contrôles serveur et le code du serveur, les chemins d’accès virtuels à l’aide de l’opérateur racine de l’application web, le tilde (~), sont couramment utilisés au lieu de chemins relatifs et absolus. Pour plus d’informations, consultez ASP.NET chemins d’accès aux projets web.

Utilisez la VirtualPathUtility classe lorsque vous devez convertir des chemins d’accès relatifs à l’application en chemins virtuels absolus, comme c’est le cas dans le développement d’un gestionnaire de service web personnalisé.

Un chemin virtuel absolu commence par la barre oblique littérale (/). Un chemin virtuel relatif est relatif au répertoire racine de l’application, s’il s’agit simplement d’un tilde (~) ou commence par le tilde et une double barre oblique inverse (~\\) ou le tilde et une barre oblique (~/). La création d’un chemin d’accès virtuel relatif rend le chemin indépendant de l’application.

Le répertoire virtuel de l’application peut être obtenu à partir des propriétés et ApplicationPath des AppDomainAppVirtualPath propriétés.

Note

La VirtualPathUtility classe n’est pas destinée à des fins de sécurité ou de canonisation. Pour plus d’informations sur la sécurité des applications web, consultez Vue d’ensemble des menaces de sécurité des applications web. Pour connaître la fonctionnalité de traitement d’URL générique, consultez Uri.

Méthodes

Nom Description
AppendTrailingSlash(String)

Ajoute la barre oblique littérale (/) à la fin du chemin d’accès virtuel, si elle n’existe pas déjà.
Combine(String, String)

Combine un chemin de base et un chemin relatif.
GetDirectory(String)

Retourne la partie répertoire d’un chemin d’accès virtuel.
GetExtension(String)

Récupère l’extension du fichier référencé dans le chemin d’accès virtuel.
GetFileName(String)

Récupère le nom de fichier du fichier référencé dans le chemin d’accès virtuel.
IsAbsolute(String)

Retourne une valeur booléenne indiquant si le chemin virtuel spécifié est absolu ; autrement dit, il commence par une barre oblique littérale (/).
IsAppRelative(String)

Retourne une valeur booléenne indiquant si le chemin d’accès virtuel spécifié est relatif à l’application.
MakeRelative(String, String)

Retourne le chemin virtuel relatif d’un chemin d’accès virtuel contenant l’opérateur racine (le tilde [~]) à un autre.
RemoveTrailingSlash(String)

Supprime une barre oblique de fin (/) d’un chemin d’accès virtuel.
ToAbsolute(String, String)

Convertit un chemin d’accès virtuel en chemin absolu d’application à l’aide du chemin d’accès d’application spécifié.
ToAbsolute(String)

Convertit un chemin d’accès virtuel en chemin absolu d’application.
ToAppRelative(String, String)

Convertit un chemin d’accès virtuel en chemin d’accès relatif à l’application à l’aide d’un chemin d’accès d’application spécifié.
ToAppRelative(String)

Convertit un chemin d’accès virtuel en chemin d’accès relatif à l’application à l’aide du chemin virtuel de l’application qui se trouve dans la AppDomainAppVirtualPath propriété.

S’applique à

Voir aussi