SPHttpApplication.GetVaryByCustomString - Méthode
Fournit un moyen de sortie variable extraite d'un cache en fonction des valeurs de propriétés des propriétés du domaine d'application actuel Windows SharePoint Services 3.0 et l' HttpContext de la demande en cours.
Espace de noms : Microsoft.SharePoint.ApplicationRuntime
Assembly : Microsoft.SharePoint (dans Microsoft.SharePoint.dll)
Syntaxe
'Déclaration
Public Overrides NotOverridable Function GetVaryByCustomString ( _
context As HttpContext, _
custom As String _
) As String
'Utilisation
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
)
Paramètres
context
Type : System.Web.HttpContextUn objet HttpContext contenant des informations sur le contexte de la demande HTTP en cours.
custom
Type : System.StringLa chaîne personnalisée qui spécifie quelle page mise en cache ou un contrôle est utilisée pour répondre à la demande en cours.
Valeur renvoyée
Type : System.String
String qui contient une ou plusieurs valeurs (converties en chaînes délimitées) des propriétés de l'objet context et le domaine d'application (ou propriétés de l'un de leurs enfants) qui sont utilisées comme critères pour déterminer la version d'une page ou un contrôle doivent être récupérées à partir d'un cache (ou si une nouvelle version doit être extrait).
Remarques
En règle générale, custom est un jeu délimité de sous-chaînes, mais elle peut être une chaîne unique.
En règle générale, chaque sous-chaîne dans custom est un alias court et convivial pour un nom de propriété qualifié complet.
Lors de la réception d'une demande pour une page mise en cache ou d'un contrôle, le Gestionnaire de cache inspecte la sortie de valeurs de propriété par GetVaryByCustomString. S'ils sont exactement le même que les valeurs correspondantes dans une demande précédente de la page ou le contrôle et si la version retournée à ce moment est encore dans le cache, la version mise en cache est retournée vers le demandeur. Sinon, une nouvelle version est rendue retournée et mis en cache.
GetVaryByCustomString appelle la méthode IVaryByCustomHandler.GetVaryByCustomString pour chaque objet de IVaryByCustomHandler qui est enregistré dans RegisterGetVaryByCustomStringHandler. Les autres fournisseurs de solutions Windows SharePoint Services 3.0 peuvent enregistrer leurs propres objets IVaryByCustomHandler , afin que vous ne devez pas considérer que le String retourné par GetVaryByCustomString, ni, par conséquent, le comportement de mise en cache de l'application — est entièrement déterminé par votre solution.