VirtualPathUtility Classe

Définition

Fournit des méthodes utilitaires pour les opérations de chemin d'accès virtuel communes.Provides utility methods for common virtual path operations.

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

Exemples

L’exemple de code suivant montre comment utiliser la classe VirtualPathUtility et certaines de ses méthodes.The following code example demonstrates how to use the VirtualPathUtility class and some of its methods. Tout d’abord, la propriété FilePath génère le chemin d’accès virtuel à la page Web.First, the FilePath property generates the virtual path to the Web page. Les méthodes GetFileName, GetExtensionet GetDirectory retournent des informations sur le chemin d’accès virtuel.The GetFileName, GetExtension, and GetDirectory methods return information about the virtual path. Ensuite, la propriété CurrentExecutionFilePath génère un chemin d’accès virtuel de la requête actuelle, qui peut être différent de la propriété FilePath, si une méthode de Redirect a été appelée.Next, the CurrentExecutionFilePath property generates a virtual path of the current request, which might be different from the FilePath property, if a Redirect method was called. Les méthodes IsAbsolute, IsAppRelativeet ToAppRelative retournent des informations sur le chemin d’accès virtuel.The IsAbsolute, IsAppRelative, and ToAppRelative methods return information about the virtual path.

<%@ 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 classe VirtualPathUtility fournit des méthodes utilitaires pour les opérations courantes impliquant des chemins d’accès virtuels.The VirtualPathUtility class provides utility methods for common operations involving virtual paths. Pour les contrôles serveur et le code serveur ASP.NET, les chemins d’accès virtuels utilisant l’opérateur racine de l’application Web, le tilde (~), sont généralement utilisés à la place des chemins d’accès relatifs et absolus.For ASP.NET server controls and server code, virtual paths using the Web application root operator, the tilde (~), commonly are used instead of relative and absolute paths. Pour plus d’informations, consultez ASP.NET Web Project Paths.For more information, see ASP.NET Web Project Paths.

Utilisez la classe VirtualPathUtility lorsque vous devez convertir des chemins d’accès relatifs à l’application en chemins d’accès virtuels absolus, comme cela peut être le cas pour le développement d’un gestionnaire de services Web personnalisé.Use the VirtualPathUtility class when you need to convert application-relative paths to absolute virtual paths, as might be the case in developing a custom Web service handler.

Un chemin d’accès virtuel absolu commence par la marque de barre oblique littérale (/).An absolute virtual path starts with the literal slash mark (/). Un chemin d’accès 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 (~/).A relative virtual path is relative to the application root directory, if it is just a tilde (~) or starts with the tilde and a double backslash (~\\) or the tilde and a slash mark (~/). La création d’un chemin d’accès virtuel relatif rend le chemin d’accès indépendant de l’application.Making a virtual path relative makes the path independent of the application.

Le répertoire virtuel de l’application peut être obtenu à partir des propriétés AppDomainAppVirtualPath et ApplicationPath.The virtual directory for the application can be obtained from the AppDomainAppVirtualPath and ApplicationPath properties.

Notes

La classe VirtualPathUtility n’est pas destinée à des fins de sécurité ou de canonisation.The VirtualPathUtility class is not intended for security or canonicalization purposes. Pour plus d’informations sur la sécurité des applications Web, consultez vue d’ensemble des menaces de sécurité des applications Web.For more information about Web application security, see Overview of Web Application Security Threats. Pour obtenir des fonctionnalités de traitement des URL génériques, consultez Uri.For generic URL processing functionality, see Uri.

Méthodes

AppendTrailingSlash(String)

Ajoute la marque de barre oblique littérale (/) à la fin du chemin d'accès virtuel, si elle n'y figure pas encore.Appends the literal slash mark (/) to the end of the virtual path, if one does not already exist.

Combine(String, String)

Combine un chemin d'accès de base et un chemin d'accès relatif.Combines a base path and a relative path.

GetDirectory(String)

Retourne la partie répertoire d'un chemin d'accès virtuel.Returns the directory portion of a virtual path.

GetExtension(String)

Récupère l'extension du fichier référencé dans le chemin d'accès virtuel.Retrieves the extension of the file that is referenced in the virtual path.

GetFileName(String)

Récupère le nom du fichier référencé dans le chemin d'accès virtuel.Retrieves the file name of the file that is referenced in the virtual path.

IsAbsolute(String)

Retourne une valeur Boolean qui indique si le chemin d'accès virtuel spécifié est absolu, c'est-à-dire s'il commence par une marque de barre oblique littérale (/).Returns a Boolean value indicating whether the specified virtual path is absolute; that is, it starts with a literal slash mark (/).

IsAppRelative(String)

Retourne une valeur Boolean qui indique si le chemin d'accès virtuel spécifié est relatif à l'application.Returns a Boolean value indicating whether the specified virtual path is relative to the application.

MakeRelative(String, String)

Retourne le chemin d'accès virtuel relatif d'un chemin d'accès virtuel qui contient l'opérateur de racine (le tilde [~]) à un autre.Returns the relative virtual path from one virtual path containing the root operator (the tilde [~]) to another.

RemoveTrailingSlash(String)

Supprime une marque de barre oblique (/) de fin dans un chemin d'accès virtuel.Removes a trailing slash mark (/) from a virtual path.

ToAbsolute(String)

Convertit un chemin d'accès virtuel en un chemin d'accès d'application absolu.Converts a virtual path to an application absolute path.

ToAbsolute(String, String)

Convertit un chemin d'accès virtuel en un chemin d'accès d'application absolu à l'aide du chemin d'accès d'application spécifié.Converts a virtual path to an application absolute path using the specified application path.

ToAppRelative(String)

Convertit un chemin d'accès virtuel en un chemin d'accès relatif à l'application à l'aide du chemin d'accès virtuel d'application qui figure dans la propriété AppDomainAppVirtualPath.Converts a virtual path to an application-relative path using the application virtual path that is in the AppDomainAppVirtualPath property.

ToAppRelative(String, String)

Convertit un chemin d'accès virtuel en un chemin d'accès relatif à une application à l'aide du chemin d'accès d'application spécifié.Converts a virtual path to an application-relative path using a specified application path.

S’applique à

Voir aussi