VirtualPathProvider Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona un conjunto de métodos que permiten a una aplicación Web recuperar los recursos de un sistema de archivos virtual.
public ref class VirtualPathProvider abstract : MarshalByRefObjectpublic abstract class VirtualPathProvider : MarshalByRefObjecttype VirtualPathProvider = class
inherit MarshalByRefObjectPublic MustInherit Class VirtualPathProvider
Inherits MarshalByRefObject- Herencia
Ejemplos
El ejemplo de código siguiente es una VirtualPathProvider implementación de clase que crea un sistema de archivos virtual mediante la información almacenada en un DataSet objeto . El ejemplo de código funciona con los ejemplos de código de las VirtualFile clases y VirtualDirectory para proporcionar recursos virtuales de un almacén de datos que se carga en un DataSet objeto .
Este ejemplo tiene cuatro partes: la implementación de la VirtualPathProvider clase, un archivo de datos XML utilizado para rellenar el DataSet objeto, un AppStart objeto que contiene un AppInitialize método utilizado para registrar la VirtualPathProvider clase con el sistema de compilación y una página de ASP.NET que proporciona vínculos a los archivos virtuales.
Para usar este código de ejemplo en una aplicación, siga estos pasos.
Cree una aplicación de ejemplo en el servidor web.
Copie el código fuente del objeto personalizado VirtualPathProvider (consulte a continuación) en un archivo del directorio de
App_Codela aplicación.Copie el código fuente del objeto personalizado VirtualDirectory (consulte la sección Ejemplo del tema de información general de la VirtualDirectory clase) en un archivo del directorio de
App_Codela aplicación.Copie el código fuente del objeto personalizado VirtualFile (consulte la sección Ejemplo del tema de información general de la VirtualFile clase) en un archivo del directorio de
App_Codela aplicación.Copie el código fuente del
AppStartobjeto (consulte a continuación) en un archivo en el directorio deApp_Codela aplicación.Copie los datos XML (vea a continuación) en un archivo denominado
XMLData.xmlen un archivo del directorio deApp_Datala aplicación.Copie el
default.aspxarchivo (consulte a continuación) en el directorio raíz de la aplicación de ejemplo. Use un explorador web para abrir eldefault.aspxarchivo y, a continuación, haga clic en los vínculos de la página para ver el contenido de los archivos virtuales.
El primer ejemplo es una clase personalizada VirtualPathProvider . Los DirectoryExists métodos y FileExists se invalidan para indicar si un directorio solicitado está presente en el sistema de archivos virtual. Los GetDirectory métodos y GetFile se invalidan para devolver instancias personalizadas VirtualDirectory y VirtualFile que contienen información del sistema de archivos virtual.
La clase también proporciona un GetVirtualData método utilizado por las VirtualDirectory clases y VirtualFile para tener acceso al DataSet objeto que contiene los datos del sistema de archivos virtual. En una implementación de producción, este método normalmente se implementaría en un objeto de negocio responsable de interactuar con el almacén de datos.
using System;
using System.Data;
using System.Security.Permissions;
using System.Web;
using System.Web.Caching;
using System.Web.Hosting;
namespace Samples.AspNet.CS
{
[AspNetHostingPermission(SecurityAction.Demand, Level = AspNetHostingPermissionLevel.Medium)]
[AspNetHostingPermission(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.High)]
public class SamplePathProvider : VirtualPathProvider
{
private string dataFile;
public SamplePathProvider()
: base()
{
}
protected override void Initialize()
{
// Set the datafile path relative to the application's path.
dataFile = HostingEnvironment.ApplicationPhysicalPath + "App_Data\\XMLData.xml";
}
/// <summary>
/// Data set provider for the SampleVirtualDirectory and
/// SampleVirtualFile classes. In a production application
/// this method would be on a provider class that accesses
/// the virtual resource data source.
/// </summary>
/// <returns>
/// The System.Data.DataSet containing the virtual resources
/// provided by the SamplePathProvider.
/// </returns>
public DataSet GetVirtualData()
{
// Get the data from the cache.
DataSet ds = (DataSet)HostingEnvironment.Cache.Get("VPPData");
if (ds == null)
{
// Data not in cache. Read XML file.
ds = new DataSet();
ds.ReadXml(dataFile);
// Make DataSet dependent on XML file.
CacheDependency cd = new CacheDependency(dataFile);
// Put DataSet into cache for maximum of 20 minutes.
HostingEnvironment.Cache.Add("VPPData", ds, cd,
Cache.NoAbsoluteExpiration,
new TimeSpan(0, 20, 0),
CacheItemPriority.Default, null);
// Set data timestamp.
DateTime dataTimeStamp = DateTime.Now;
// Cache it so we can get the timestamp in later calls.
HostingEnvironment.Cache.Insert("dataTimeStamp", dataTimeStamp, null,
Cache.NoAbsoluteExpiration,
new TimeSpan(0, 20, 0),
CacheItemPriority.Default, null);
}
return ds;
}
/// <summary>
/// Determines whether a specified virtual path is within
/// the virtual file system.
/// </summary>
/// <param name="virtualPath">An absolute virtual path.</param>
/// <returns>
/// true if the virtual path is within the
/// virtual file sytem; otherwise, false.
/// </returns>
private bool IsPathVirtual(string virtualPath)
{
String checkPath = VirtualPathUtility.ToAppRelative(virtualPath);
return checkPath.StartsWith("~/vrdir", StringComparison.InvariantCultureIgnoreCase);
}
public override bool FileExists(string virtualPath)
{
if (IsPathVirtual(virtualPath))
{
SampleVirtualFile file = (SampleVirtualFile)GetFile(virtualPath);
return file.Exists;
}
else
{
return Previous.FileExists(virtualPath);
}
}
public override bool DirectoryExists(string virtualDir)
{
if (IsPathVirtual(virtualDir))
{
SampleVirtualDirectory dir = (SampleVirtualDirectory)GetDirectory(virtualDir);
return dir.Exists;
}
else
{
return Previous.DirectoryExists(virtualDir);
}
}
public override VirtualFile GetFile(string virtualPath)
{
if (IsPathVirtual(virtualPath))
return new SampleVirtualFile(virtualPath, this);
else
return Previous.GetFile(virtualPath);
}
public override VirtualDirectory GetDirectory(string virtualDir)
{
if (IsPathVirtual(virtualDir))
return new SampleVirtualDirectory(virtualDir, this);
else
return Previous.GetDirectory(virtualDir);
}
public override CacheDependency GetCacheDependency(
string virtualPath,
System.Collections.IEnumerable virtualPathDependencies,
DateTime utcStart)
{
if (IsPathVirtual(virtualPath))
{
System.Collections.Specialized.StringCollection fullPathDependencies = null;
// Get the full path to all dependencies.
foreach (string virtualDependency in virtualPathDependencies)
{
if (fullPathDependencies == null)
fullPathDependencies = new System.Collections.Specialized.StringCollection();
fullPathDependencies.Add(virtualDependency);
}
if (fullPathDependencies == null)
return null;
// Copy the list of full-path dependencies into an array.
string[] fullPathDependenciesArray = new string[fullPathDependencies.Count];
fullPathDependencies.CopyTo(fullPathDependenciesArray, 0);
// Copy the virtual path into an array.
string[] virtualPathArray = new string[1];
virtualPathArray[0] = virtualPath;
return new CacheDependency(virtualPathArray, fullPathDependenciesArray, utcStart);
}
else
{
return Previous.GetCacheDependency(virtualPath, virtualPathDependencies, utcStart);
}
}
}
}
Imports System.Data
Imports System.Security.Permissions
Imports System.Web
Imports System.Web.Caching
Imports System.Web.Hosting
Namespace Samples.AspNet.VB
<AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Medium), _
AspNetHostingPermission(SecurityAction.InheritanceDemand, level:=AspNetHostingPermissionLevel.High)> _
Public Class SamplePathProvider
Inherits VirtualPathProvider
Private dataFile As String
Public Sub New()
MyBase.New()
End Sub
Protected Overrides Sub Initialize()
' Set the datafile path relative to the application's path.
dataFile = HostingEnvironment.ApplicationPhysicalPath & _
"App_Data\XMLData.xml"
End Sub
' Data set provider for the SampleVirtualFile and
' SampleVirtualDirectory classes. In a production application
' this method would be on a provider class that accesses
' the virtual resource data source.
' The System.Data.DataSet containing the virtual resources
' provided by the SamplePathProvider.
Public Function GetVirtualData() As DataSet
' Get the data from the cache.
Dim ds As DataSet
ds = CType(HostingEnvironment.Cache.Get("VPPData"), DataSet)
If ds Is Nothing Then
' Data set not in cache. Read XML file.
ds = New DataSet
ds.ReadXml(dataFile)
' Make DataSet dependent on XML file.
Dim cd As CacheDependency
cd = New CacheDependency(dataFile)
' Put DataSet into cache for maximum of 20 minutes.
HostingEnvironment.Cache.Add("VPPData", ds, cd, _
Cache.NoAbsoluteExpiration, _
New TimeSpan(0, 20, 0), _
CacheItemPriority.Default, Nothing)
' Set data timestamp.
Dim dataTimeStamp As DateTime
dataTimeStamp = DateTime.Now
' Cache it so we can get the timestamp in later calls.
HostingEnvironment.Cache.Add("dataTimeStamp", dataTimeStamp, Nothing, _
Cache.NoAbsoluteExpiration, _
New TimeSpan(0, 20, 0), _
CacheItemPriority.Default, Nothing)
End If
Return ds
End Function
Private Function IsPathVirtual(ByVal virtualPath As String) As Boolean
Dim checkPath As String
checkPath = VirtualPathUtility.ToAppRelative(virtualPath)
Return checkPath.StartsWith("~/vrdir", StringComparison.InvariantCultureIgnoreCase)
End Function
Public Overrides Function FileExists(ByVal virtualPath As String) As Boolean
If (IsPathVirtual(virtualPath)) Then
Dim file As SampleVirtualFile
file = CType(GetFile(virtualPath), SampleVirtualFile)
Return file.Exists
Else
Return Previous.FileExists(virtualPath)
End If
End Function
Public Overrides Function DirectoryExists(ByVal virtualDir As String) As Boolean
If (IsPathVirtual(virtualDir)) Then
Dim dir As SampleVirtualDirectory
dir = CType(GetDirectory(virtualDir), SampleVirtualDirectory)
Return dir.exists
Else
Return Previous.DirectoryExists(virtualDir)
End If
End Function
Public Overrides Function GetFile(ByVal virtualPath As String) As VirtualFile
If (IsPathVirtual(virtualPath)) Then
Return New SampleVirtualFile(virtualPath, Me)
Else
Return Previous.GetFile(virtualPath)
End If
End Function
Public Overrides Function GetDirectory(ByVal virtualDir As String) As VirtualDirectory
If (IsPathVirtual(virtualDir)) Then
Return New SampleVirtualDirectory(virtualDir, Me)
Else
Return Previous.GetDirectory(virtualDir)
End If
End Function
Public Overrides Function GetCacheDependency(ByVal virtualPath As String, ByVal virtualPathDependencies As IEnumerable, ByVal utcStart As Date) As CacheDependency
If (IsPathVirtual(virtualPath)) Then
Dim fullPathDependencies As System.Collections.Specialized.StringCollection
fullPathDependencies = Nothing
' Get the full path to all dependencies.
For Each virtualDependency As String In virtualPathDependencies
If fullPathDependencies Is Nothing Then
fullPathDependencies = New System.Collections.Specialized.StringCollection
End If
fullPathDependencies.Add(virtualDependency)
Next
If fullPathDependencies Is Nothing Then
Return Nothing
End If
Dim fullPathDependenciesArray As String()
fullPathDependencies.CopyTo(fullPathDependenciesArray, 0)
Return New CacheDependency(fullPathDependenciesArray, utcStart)
Else
Return Previous.GetCacheDependency(virtualPath, virtualPathDependencies, utcStart)
End If
End Function
End Class
End Namespace
El segundo ejemplo es el archivo de datos XML utilizado para rellenar el DataSet objeto devuelto por el objeto personalizado VirtualPathProvider . Estos datos XML se usan para demostrar el uso de los VirtualPathProviderobjetos , VirtualDirectoryy VirtualFile para recuperar datos de datos externos y no está pensado para representar un almacén de datos de calidad de producción.
<?xml version="1.0" encoding="utf-8" ?>
<resource type="dir"
path="/vrDir"
parentPath=""
content="">
<resource type="file"
path="/vrDir/Level1FileA.vrf"
parentPath="/vrDir"
content="This is the content of file Level1FileA.">
</resource>
<resource type="file"
path="/vrDir/Level1FileB.vrf"
parentPath="/vrDir"
content="This is the content of file Level1FileB.">
</resource>
<resource type="dir"
path="/vrDir/Level2DirA"
parentPath="/vrDir"
content="">
<resource type="file"
path="/vrDir/Level2DirA/Level2FileA.vrf"
parentPath="/vrDir/Level2DirA"
content="This is the content of file Level2FileA.">
</resource>
<resource type="file"
path="/vrDir/Level2DirA/Level2FileB.vrf"
parentPath="/vrDir/Level2DirA"
content="This is the content of file Level2FileB.">
</resource>
</resource>
<resource type="dir"
path="/vrDir/Level2DirB"
parentPath="/vrDir"
content="">
<resource type="file"
path="/vrDir/Level2DirB/Level2FileA.vrf"
parentPath="/vrDir/Level2DirB"
content="This is the content of file Level2FileA.">
</resource>
<resource type="file"
path="/vrDir/Level2DirB/Level2FileB.vrf"
parentPath="/vrDir/Level2DirB"
content="This is the content of file Level2FileB.">
</resource>
</resource>
</resource>
En el tercer ejemplo se proporciona un AppStart objeto que contiene un AppInitialize método . Se llama a este método durante la inicialización de una aplicación de ASP.NET para realizar cualquier inicialización personalizada necesaria. En este caso, registra el objeto personalizado VirtualPathProvider con el sistema de compilación ASP.NET.
using System.Web.Hosting;
namespace Samples.AspNet.CS
{
/// <summary>
/// Contains the application initialization method
/// for the sample application.
/// </summary>
public static class AppStart
{
public static void AppInitialize()
{
SamplePathProvider sampleProvider = new SamplePathProvider();
HostingEnvironment.RegisterVirtualPathProvider(sampleProvider);
}
}
}
Imports System.Web.Hosting
Namespace Samples.AspNet.VB
Public Class AppStart
Public Shared Sub AppInitialize()
Dim sampleProvider As SamplePathProvider = New SamplePathProvider()
HostingEnvironment.RegisterVirtualPathProvider(sampleProvider)
End Sub
End Class
End Namespace
El último ejemplo es una página de ASP.NET que contiene vínculos a los archivos virtuales contenidos en el sistema de archivos virtuales.
<%@ 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">
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
<meta http-equiv="Content-Type" content="text/html" />
<title>Virtual Path Provider Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:HyperLink ID="hyperLink1" runat="server" NavigateUrl="vrDir/Level1FileA.vrf" Text="Level 1, File A" /><br />
<asp:HyperLink ID="hyperLink2" runat="server" NavigateUrl="vrDir/Level1FileB.vrf" Text="Level 1, File B" /><br />
<asp:HyperLink ID="hyperLink3" runat="server" NavigateUrl="vrDir/Level2DirA/Level2FileA.vrf" Text="Level 2a, File A" /><br />
<asp:HyperLink ID="hyperLink4" runat="server" NavigateUrl="vrDir/Level2DirA/Level2FileB.vrf" Text="Level 2a, File B" /><br />
<asp:HyperLink ID="hyperLink5" runat="server" NavigateUrl="vrDir/Level2DirB/Level2FileA.vrf" Text="Level 2b, File A" /><br />
<asp:HyperLink ID="hyperLink6" runat="server" NavigateUrl="vrDir/Level2DirB/Level2FileB.vrf" Text="Level 2b, File B" /><br />
</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">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<meta http-equiv="Content-Type" content="text/html" />
<title>Virtual Path Provider Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:HyperLink ID="hyperLink1" runat="server" NavigateUrl="vrDir/Level1FileA.vrf" Text="Level 1, File A" /><br />
<asp:HyperLink ID="hyperLink2" runat="server" NavigateUrl="vrDir/Level1FileB.vrf" Text="Level 1, File B" /><br />
<asp:HyperLink ID="hyperLink3" runat="server" NavigateUrl="vrDir/Level2DirA/Level2FileA.vrf" Text="Level 2a, File A" /><br />
<asp:HyperLink ID="hyperLink4" runat="server" NavigateUrl="vrDir/Level2DirA/Level2FileB.vrf" Text="Level 2a, File B" /><br />
<asp:HyperLink ID="hyperLink5" runat="server" NavigateUrl="vrDir/Level2DirB/Level2FileA.vrf" Text="Level 2b, File A" /><br />
<asp:HyperLink ID="hyperLink6" runat="server" NavigateUrl="vrDir/Level2DirB/Level2FileB.vrf" Text="Level 2b, File B" /><br />
</form>
</body>
</html>
Comentarios
La VirtualPathProvider clase proporciona un conjunto de métodos para implementar un sistema de archivos virtual para una aplicación web. En un sistema de archivos virtual, los archivos y directorios se administran mediante un almacén de datos distinto del sistema de archivos proporcionado por el sistema operativo del servidor. Por ejemplo, puede usar un sistema de archivos virtual para almacenar contenido en una base de datos de SQL Server.
Puede almacenar cualquier archivo que se procese a petición en un sistema de archivos virtual. Esto incluye:
ASP.NET páginas, páginas maestras, controles de usuario y otros objetos.
Páginas web estándar con extensiones como .htm y .jpg.
Cualquier extensión personalizada asignada a una BuildProvider instancia de .
Cualquier tema con nombre en la
App_Themecarpeta.
No puede almacenar ASP.NET carpetas o archivos de aplicación que generen ensamblados de nivel de aplicación en un sistema de archivos virtual. Esto incluye:
El archivo Global.asax.
Web.config archivos.
Archivos de datos de mapa de sitio usados por .XmlSiteMapProvider
Directorios que contienen ensamblados de aplicación o que generan ensamblados de aplicación:
Bin,App_Code,App_GlobalResources, cualquierApp_LocalResources.La carpeta de datos de la aplicación,
App_Data.
Nota
Si un sitio web está precompilado para la implementación, el contenido proporcionado por una VirtualPathProvider instancia no se compila y el sitio precompilado no VirtualPathProvider usa ninguna instancia.
Registro de un virtualPathProvider
Una instancia personalizada VirtualPathProvider debe registrarse con el sistema de compilación de ASP.NET mediante el HostingEnvironment.RegisterVirtualPathProvider método antes de que la aplicación web realice cualquier análisis o compilación de páginas.
Normalmente, una VirtualPathProvider instancia se registra en un AppInitialize método definido en el App_Code directorio o durante el Application_Start evento en el Global.asax archivo. Para obtener un ejemplo de cómo registrar una VirtualPathProvider instancia en un AppInitialize método, vea la sección Ejemplo.
Puede registrar una VirtualPathProvider instancia durante otros eventos, pero las páginas compiladas y almacenadas en caché antes de que se registre la VirtualPathProvider instancia no se invalidarán, aunque la nueva VirtualPathProvider instancia proporcione ahora el origen de la página compilada anteriormente.
Notas a los implementadores
Al heredar de VirtualPathProvider, es necesario invalidar los miembros siguientes:.
Si la clase personalizada VirtualPathProvider admite directorios en el sistema de archivos virtual, debe invalidar los siguientes miembros.
-
Nota: Si el sistema de archivos virtual contendrá temas para el sitio web (mediante la creación de un directorio virtual
App_Themes), la clase personalizada VirtualPathProvider debe admitir directorios.Una clase personalizada VirtualPathProvider funciona con clases derivadas de las VirtualFile clases y VirtualDirectory . Debe implementar clases derivadas de estos tipos para proporcionar información de archivos y directorios del sistema de archivos virtual. Para obtener un ejemplo de una implementación personalizada VirtualFile , vea la sección Ejemplo del tema de información general de la VirtualFile clase. Para obtener un ejemplo de una implementación personalizada VirtualDirectory , vea la sección Ejemplo del tema de información general de la VirtualDirectory clase.
Constructores
| VirtualPathProvider() |
Inicializa la clase para que la use una instancia de la clase heredada. A este constructor sólo lo puede llamar una clase heredada. |
Propiedades
| Previous |
Obtiene una referencia a un objeto VirtualPathProvider previamente registrado del sistema de compilación. |
Métodos
| CombineVirtualPaths(String, String) |
Combina una ruta de acceso base con una ruta de acceso relativa para devolver una ruta de acceso completa a un recurso virtual. |
| CreateObjRef(Type) |
Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject) |
| DirectoryExists(String) |
Obtiene un valor que indica si existe un directorio en el sistema de archivos virtual. |
| Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
| FileExists(String) |
Obtiene un valor que indica si existe un archivo en el sistema de archivos virtual. |
| GetCacheDependency(String, IEnumerable, DateTime) |
Crea una dependencia de caché basada en las rutas de acceso virtuales especificadas. |
| GetCacheKey(String) |
Devuelve una clave de caché que se va a utilizar para la ruta de acceso virtual especificada. |
| GetDirectory(String) |
Recibe un directorio virtual del sistema de archivos virtual. |
| GetFile(String) |
Recibe un archivo virtual del sistema de archivos virtual. |
| GetFileHash(String, IEnumerable) |
Devuelve un código hash de las rutas de acceso virtuales especificadas. |
| GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
| GetLifetimeService() |
Obsoletos.
Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Heredado de MarshalByRefObject) |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| Initialize() |
Inicializa la instancia VirtualPathProvider. |
| InitializeLifetimeService() |
Concede al objeto VirtualPathProvider una duración infinita ya que impide que se genere una concesión. |
| MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
| MemberwiseClone(Boolean) |
Crea una copia superficial del objeto MarshalByRefObject actual. (Heredado de MarshalByRefObject) |
| OpenFile(String) |
Devuelve una secuencia de un archivo virtual. |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
Se aplica a
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de