HostFileChangeMonitor Класс

Определение

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

Наследование

Object

ChangeMonitor

FileChangeMonitor

HostFileChangeMonitor

Примеры

В следующем примере создается элемент кэша, использующий HostFileChangeMonitor объект для мониторинга состояния исходных данных (который является файлом) в файловой системе. Запись кэша определяется с помощью объекта для предоставления сведений CacheItemPolicy о вытеснениях и истечении срока действия записи кэша.

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

Комментарии

Класс HostFileChangeMonitor представляет собой конкретную реализацию FileChangeMonitor типа. Этот класс запечатан, поэтому его нельзя расширить. Этот класс полезен, если вы хотите использовать существующую реализацию кэша и отслеживать файлы и каталоги для изменений.

Для каждого указанного пути к файлу или каталогу HostFileChangeMonitor класс активирует уведомление об изменении, если происходят какие-либо из следующих изменений:

• Имя отслеживаемого файла или каталога.

• Указанный файл или каталог не существовал во время создания монитора, но был создан позже. Другими словами, файл или каталог был создан в области отслеживаемых элементов.

• Размер отслеживаемого файла изменился.

• Содержимое отслеживаемого файла или содержимое отслеживаемого каталога изменилось.

• Список управления доступом (ACL) файла или каталога был изменен.

• Отслеживаемый файл или каталог удален.

Если слишком много изменений происходит для отслеживаемого файла или каталога одновременно, HostFileChangeMonitor экземпляр может потерять отслеживание конкретных изменений. В этом сценарии HostFileChangeMonitor класс активирует уведомление об изменении. Этот сценарий, скорее всего, возникает, когда HostFileChangeMonitor экземпляр отслеживает каталог, и многие изменения происходят в области структуры каталогов в течение короткого периода времени.

Поскольку цель HostFileChangeMonitor класса заключается только в том, чтобы сигнализировать о том, что что-то изменилось между набором отслеживаемых файлов и каталогов, не считается важным, что подробные сведения о конкретном изменении не фиксируются. Цель HostFileChangeMonitor класса — предоставить уведомление об изменении состояния, чтобы можно было вытеснить запись кэша (или записи). HostFileChangeMonitor Так как класс не указывает точно, что изменилось, переполнение внутреннего отслеживания изменений не имеет значения.

При предоставлении путей HostFileChangeMonitor экземпляру каталог и пути к файлам должны быть полными путями к каталогу или файлу. Относительные пути и подстановочные знаки в путях не допускаются.

Если класс HostFileChangeMonitor используется в приложении ASP.NET, Windows удостоверение, используемое для доступа к отслеживаемых элементов, является удостоверением приложения для приложения ASP.NET. Другими словами, удостоверение приложения будет одним из следующих вариантов:

• Удостоверение процесса.

• Настроенное удостоверение приложения.

• Учетные данные UNC, если приложение работает из UNC-ресурса.

Если класс HostFileChangeMonitor используется в приложении, отличном от ASP.NET, класс FileSystemWatcher используется для мониторинга файлов. В результате любой список управления доступом (ACL) применяется к отслеживаемому файлу или каталогу, который применяется к идентификатору Windows текущего потока.