HostFileChangeMonitor Třída

Definice

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

Dědičnost

Object

ChangeMonitor

FileChangeMonitor

HostFileChangeMonitor

Příklady

Následující příklad vytvoří položku mezipaměti, která používá HostFileChangeMonitor objekt ke sledování stavu zdrojových dat (což je soubor) v systému souborů. Položka mezipaměti se definuje pomocí objektu, který CacheItemPolicy poskytuje podrobnosti o vyřazení a vypršení platnosti položky mezipaměti.

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

Poznámky

Třída HostFileChangeMonitor je konkrétní implementací FileChangeMonitor typu. Tato třída je zapečetěna, proto ji nelze rozšířit. Tato třída je užitečná, pokud chcete použít existující implementaci mezipaměti a monitorovat změny souborů a adresářů.

Pro každý zadaný soubor nebo cestu k adresáři HostFileChangeMonitor třída aktivuje oznámení o změně, pokud dojde k některé z následujících změn:

• Název monitorovaného souboru nebo adresáře se změní.

• Zadaný soubor nebo adresář v době vytvoření monitorování neexistoval, ale byl vytvořen později. Jinými slovy, soubor nebo adresář byl vytvořen v rozsahu monitorovaných položek.

• Velikost monitorovaného souboru se změnila.

• Změnil se obsah monitorovaného souboru nebo se změnil obsah monitorovaného adresáře.

• Změnil se seznam řízení přístupu (ACL) souboru nebo adresáře.

• Monitorovaný soubor nebo adresář byl odstraněn.

Pokud u monitorovaného souboru nebo adresáře dojde najednou k příliš mnoha změnám HostFileChangeMonitor , může instance ztratit přehled o konkrétních změnách. V tomto scénáři HostFileChangeMonitor třída aktivuje oznámení o změně. K tomuto scénáři pravděpodobně dojde, když HostFileChangeMonitor instance monitoruje adresář a v krátkém časovém období dojde v oboru adresářové struktury k mnoha změnám.

Vzhledem k tomu, že účelem HostFileChangeMonitor třídy je pouze signalizovat, že se něco změnilo mezi sadou monitorovaných souborů a adresářů, nepovažuje se za důležité, aby nebyly zaznamenány podrobnosti o konkrétní změně. Účelem HostFileChangeMonitor třídy je poskytnout oznámení, že se stav změnil, aby bylo možné vyřadit položku mezipaměti (nebo položky). Vzhledem k tomu, že HostFileChangeMonitor třída neuvádí, co se přesně změnilo, je přetečení sledování interních změn irelevantní.

Když zadáte cesty k HostFileChangeMonitor instanci, musí být cesta k adresáři nebo souboru úplná cesta k adresáři nebo souboru. Relativní cesty a zástupné znaky v cestách nejsou povoleny.

HostFileChangeMonitor Při použití třídy v aplikaci ASP.NET je identita Systému Windows, která se používá pro přístup k monitorovaným položkám, identitou aplikace pro ASP.NET aplikace. Jinými slovy, identita aplikace bude jedna z následujících:

• Identita procesu.

• Nakonfigurovaná identita aplikace.

• Přihlašovací údaje UNC, pokud je aplikace spuštěná ze sdílené složky UNC.

Když se HostFileChangeMonitor třída používá v aplikaci non-ASP.NET, FileSystemWatcher třída se používá interně k monitorování souborů. V důsledku toho se na identitu Windows aktuálního vlákna použije jakýkoli seznam řízení přístupu (ACL) pro monitorovaný soubor nebo adresář.

Konstruktory

Vlastnosti

Metody

Platí pro