del método IVaryByCustomHandler.GetVaryByCustomString
Varía el resultado obtenido de una memoria caché dependiendo de los valores de las propiedades de la HttpContext de la solicitud actual y las propiedades de la actual HttpApplication.
Espacio de nombres: Microsoft.SharePoint.ApplicationRuntime
Ensamblado: Microsoft.SharePoint (en Microsoft.SharePoint.dll)
Sintaxis
'Declaración
Function GetVaryByCustomString ( _
app As HttpApplication, _
context As HttpContext, _
custom As String _
) As String
'Uso
Dim instance As IVaryByCustomHandler
Dim app As HttpApplication
Dim context As HttpContext
Dim custom As String
Dim returnValue As String
returnValue = instance.GetVaryByCustomString(app, _
context, custom)
string GetVaryByCustomString(
HttpApplication app,
HttpContext context,
string custom
)
Parámetros
app
Tipo: System.Web.HttpApplicationLa actual HttpApplication.
context
Tipo: System.Web.HttpContextUn objeto HttpContext contiene información sobre el contexto de la solicitud HTTP actual.
custom
Tipo: System.StringLa cadena personalizada que especifica qué página almacenada en caché o el control se utiliza para responder a la solicitud actual.
Valor devuelto
Tipo: System.String
String que contiene uno o más valores (que se convierten en cadenas delimitadas) de propiedades de los objetos context y app (o propiedades de uno de sus elementos secundarios) que son utilizados por el Administrador de caché, como los criterios para determinar qué versión de una página o control deben recuperarse de una memoria caché (o si se debe obtener una nueva versión).
Comentarios
Normalmente, custom es un conjunto delimitado de subcadenas, pero puede ser una sola cadena.
Normalmente, cada subcadena en custom es un alias para un nombre de propiedad completo de corto y descriptivo.
Cuando se recibe una solicitud para una página almacenable en caché o el control, el Administrador de caché inspecciona la salida de los valores de propiedad de GetVaryByCustomString(HttpContext, String). Si son exactamente lo mismo que una versión en caché de la página solicitada o el control, se devuelve la versión en caché. De lo contrario, una nueva versión se procesa, devuelto y en caché.
Notas para los implementadores
En general, el código debe agregar un valor (que se convierte en una cadena con un delimitador) en el valor devuelto para cada subcadena que sus directivas de código o @ OutputCache agregadas a custom antes de que se pasó a IVaryByCustomHandler.GetVaryByCustomString.
Advertencia
Otros proveedores de soluciones de Windows SharePoint Services 3.0 pueden utilizar sus propias directivas de código y @ OutputCache para agregar sus propias cadenas personalizadas a custom, con sus propios esquemas de delimitación. Por lo tanto, la implementación de IVaryByCustomHandler.GetVaryByCustomString debe escribirse para omitir subcadenas de custom que no son relevantes para su solución.