HostFileChangeMonitor Klass

Definition

public ref class HostFileChangeMonitor sealed : System::Runtime::Caching::FileChangeMonitor

public sealed class HostFileChangeMonitor : System.Runtime.Caching.FileChangeMonitor

type HostFileChangeMonitor = class
    inherit FileChangeMonitor

Public NotInheritable Class HostFileChangeMonitor
Inherits FileChangeMonitor

Arv

Object

ChangeMonitor

FileChangeMonitor

HostFileChangeMonitor

Exempel

I följande exempel skapas ett cacheobjekt som använder ett HostFileChangeMonitor objekt för att övervaka tillståndet för källdata (som är en fil) i filsystemet. Cacheposten definieras med hjälp av ett CacheItemPolicy objekt för att tillhandahålla borttagnings- och förfalloinformation för cacheposten.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Runtime.Caching;
using System.IO;

public partial class _Default : System.Web.UI.Page
{

    protected void Button1_Click1(object sender, EventArgs e)
    {
        ObjectCache cache = MemoryCache.Default;
        string fileContents = cache["filecontents"] as string;

        if (fileContents == null)
        {
            CacheItemPolicy policy = new CacheItemPolicy();
            policy.AbsoluteExpiration =
                DateTimeOffset.Now.AddSeconds(10.0);

            List<string> filePaths = new List<string>();
            string cachedFilePath = Server.MapPath("~") +
                "\\cacheText.txt";

            filePaths.Add(cachedFilePath);

            policy.ChangeMonitors.Add(new
                HostFileChangeMonitor(filePaths));

            // Fetch the file contents.
            fileContents = File.ReadAllText(cachedFilePath) + "\n"
                + DateTime.Now.ToString();

            cache.Set("filecontents", fileContents, policy);
        }

        Label1.Text = fileContents;
    }
}

Imports System.Runtime.Caching
Imports System.IO

Partial Class _Default
    Inherits System.Web.UI.Page

    Protected Sub Button1_Click(ByVal sender As Object, _
            ByVal e As System.EventArgs) Handles Button1.Click
        Dim cache As ObjectCache = MemoryCache.Default
        Dim fileContents As String = TryCast(cache("filecontents"), _
            String)
        If fileContents Is Nothing Then
            Dim policy As New CacheItemPolicy()
            policy.AbsoluteExpiration = _
                DateTimeOffset.Now.AddSeconds(10.0)
            Dim filePaths As New List(Of String)()
            Dim cachedFilePath As String = Server.MapPath("~") & _
                "\cacheText.txt"
            filePaths.Add(cachedFilePath)
            policy.ChangeMonitors.Add(New  _
                HostFileChangeMonitor(filePaths))

            ' Fetch the file contents.
            fileContents = File.ReadAllText(cachedFilePath) & _
                vbCrLf & DateTime.Now.ToString()
            cache.Set("filecontents", fileContents, policy)
        End If
        Label1.Text = fileContents
    End Sub

End Class

Kommentarer

Klassen HostFileChangeMonitor är en konkret implementering av typen FileChangeMonitor . Den här klassen är förseglad och kan därför inte utökas. Den här klassen är användbar om du vill använda en befintlig cacheimplementering och övervaka filer och kataloger för ändringar.

För varje angiven fil- eller katalogsökväg HostFileChangeMonitor utlöser klassen ett ändringsmeddelande om någon av följande ändringar inträffar:

• Namnet på den övervakade filen eller katalogändringarna.

• Den angivna filen eller katalogen fanns inte när övervakaren skapades, men skapades senare. Med andra ord skapades en fil eller katalog i omfånget för de övervakade objekten.

• Storleken på en övervakad fil har ändrats.

• Innehållet i en övervakad fil har ändrats eller innehållet i en övervakad katalog har ändrats.

• Åtkomstkontrollistan (ACL) för filen eller katalogen ändrades.

• Den övervakade filen eller katalogen har tagits bort.

Om för många ändringar sker för den övervakade filen eller katalogen samtidigt kan instansen HostFileChangeMonitor förlora kontrollen över specifika ändringar. I det här scenariot HostFileChangeMonitor utlöser klassen ett ändringsmeddelande. Det här scenariot är mer sannolikt när instansen HostFileChangeMonitor övervakar en katalog och många ändringar sker i katalogstrukturens omfång på kort tid.

Eftersom syftet med HostFileChangeMonitor klassen bara är att signalera att något har ändrats bland uppsättningen övervakade filer och kataloger anses det inte vara viktigt att information om en specifik ändring inte samlas in. Syftet med HostFileChangeMonitor klassen är att meddela att tillståndet har ändrats så att en cachepost (eller poster) kan avlägsnas. HostFileChangeMonitor Eftersom klassen inte anger exakt vad som har ändrats är intern ändringsspårningsspill irrelevant.

När du anger sökvägar till en HostFileChangeMonitor instans måste katalog- och filsökvägarna vara fullständiga sökvägar till katalogen eller filen. Relativa sökvägar och jokertecken i sökvägar tillåts inte.

När klassen HostFileChangeMonitor används i ett ASP.NET program är den Windows identitet som används för åtkomst till övervakade objekt programidentiteten för det ASP.NET programmet. Med andra ord blir programidentiteten något av följande:

• Processidentiteten.

• Den konfigurerade programidentiteten.

• UNC-autentiseringsuppgifterna om programmet körs från en UNC-resurs.

När klassen HostFileChangeMonitor används i ett program som inte är ASP.NET används klassen FileSystemWatcher internt för att övervaka filer. Det innebär att den åtkomstkontrollista (ACL) som gäller för en övervakad fil eller katalog tillämpas på den aktuella trådens Windows identitet.