del método SPHttpApplication.GetVaryByCustomString
Proporciona un medio para distintos resultados recuperados de una caché dependiendo de los valores de las propiedades de la HttpContext de la solicitud actual y las propiedades del dominio de aplicación actual Windows SharePoint Services 3.0 .
Espacio de nombres: Microsoft.SharePoint.ApplicationRuntime
Ensamblado: Microsoft.SharePoint (en Microsoft.SharePoint.dll)
Sintaxis
'Declaración
Public Overrides NotOverridable Function GetVaryByCustomString ( _
context As HttpContext, _
custom As String _
) As String
'Uso
Dim instance As SPHttpApplication
Dim context As HttpContext
Dim custom As String
Dim returnValue As String
returnValue = instance.GetVaryByCustomString(context, _
custom)
public override sealed string GetVaryByCustomString(
HttpContext context,
string custom
)
Parámetros
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 las propiedades del objeto context y el dominio de aplicación (o propiedades de uno de sus elementos secundarios) que se utilizan 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 versión totalmente nueva).
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. Si son exactamente iguales a los valores correspondientes en una solicitud anterior de la misma página o control y si devuelve la versión en ese momento está todavía en la memoria caché, la versión en caché se devuelve al solicitante. De lo contrario, una nueva versión se procesa, devuelto y en caché.
GetVaryByCustomString , se llama al método IVaryByCustomHandler.GetVaryByCustomString para cada objeto de IVaryByCustomHandler que se registra con RegisterGetVaryByCustomStringHandler. Otros proveedores de soluciones Windows SharePoint Services 3.0 pueden registrar sus propios objetos IVaryByCustomHandler , por lo que no debe suponer que la String devuelta por GetVaryByCustomString— o, por lo tanto, el comportamiento de almacenamiento en caché de la aplicación, está totalmente controlada por la solución.