LogStore Klas

Definitie

public ref class LogStore sealed : IDisposable

public sealed class LogStore : IDisposable

type LogStore = class
    interface IDisposable

Public NotInheritable Class LogStore
Implements IDisposable

Overname

Object

LogStore

Implementeringen

IDisposable

Voorbeelden

In het volgende voorbeeld ziet u hoe u een LogStore xml-document kunt archiveren.

class LogBackup
{
    static void ArchiveToXML(LogStore logStore, string fileName)
    {
        LogArchiveSnapshot snapshot = logStore.CreateLogArchiveSnapshot();

        XmlTextWriter writer = new XmlTextWriter(fileName, Encoding.ASCII);

        writer.WriteStartElement("logArchive");
        foreach(FileRegion region in snapshot.ArchiveRegions)
        {
            writer.WriteStartElement("fileRegion");
            writer.WriteElementString("path", region.Path);
            writer.WriteElementString("length", region.FileLength.ToString());
            writer.WriteElementString("offset", region.Offset.ToString());
            using(Stream dataStream = region.GetStream())
            {
                byte[] data = new byte[dataStream.Length];
                dataStream.Read(data, 0, data.Length);
                writer.WriteElementString("data", Convert.ToBase64String(data));
            }
            writer.WriteEndElement();
        }
        writer.WriteEndElement();
        writer.Close();
        logStore.SetArchiveTail(snapshot.LastSequenceNumber);
    }
    static void RestoreFromXML(string fileName)
    {
        using(XmlTextReader reader = new XmlTextReader(fileName))
        {
            reader.ReadStartElement("logArchive");
            while(reader.IsStartElement())
            {
                string path = reader.ReadElementString("path");
                long length = Int64.Parse(reader.ReadElementString("length"));
                long offset = Int64.Parse(reader.ReadElementString("offset"));
                string dataString = reader.ReadElementString("data");
                byte[] data = Convert.FromBase64String(dataString);
                FileStream fileStream;
                using(fileStream = new FileStream(path, FileMode.OpenOrCreate, FileAccess.Write))
                {
                    fileStream.SetLength(length);
                    fileStream.Position = offset; fileStream.Write(data, 0, data.Length);
                }
            }
        reader.ReadEndElement();
        }
    }
}

Friend Class LogBackup
    Private Shared Sub ArchiveToXML(ByVal logStore As LogStore, ByVal fileName As String)
        Dim snapshot As LogArchiveSnapshot = logStore.CreateLogArchiveSnapshot()

        Dim writer As New XmlTextWriter(fileName, Encoding.ASCII)

        writer.WriteStartElement("logArchive")
        For Each region As FileRegion In snapshot.ArchiveRegions
            writer.WriteStartElement("fileRegion")
            writer.WriteElementString("path", region.Path)
            writer.WriteElementString("length", region.FileLength.ToString())
            writer.WriteElementString("offset", region.Offset.ToString())
            Using dataStream As Stream = region.GetStream()
                Dim data(dataStream.Length - 1) As Byte
                dataStream.Read(data, 0, data.Length)
                writer.WriteElementString("data", Convert.ToBase64String(data))
            End Using
            writer.WriteEndElement()
        Next region
        writer.WriteEndElement()
        writer.Close()
        logStore.SetArchiveTail(snapshot.LastSequenceNumber)

    End Sub
    Private Shared Sub RestoreFromXML(ByVal fileName As String)
        Using reader As New XmlTextReader(fileName)
            reader.ReadStartElement("logArchive")
            Do While reader.IsStartElement()
                Dim path = reader.ReadElementString("path")
                Dim length = Int64.Parse(reader.ReadElementString("length"))
                Dim offset = Int64.Parse(reader.ReadElementString("offset"))
                Dim dataString = reader.ReadElementString("data")
                Dim data() = Convert.FromBase64String(dataString)
                Dim fileStream As FileStream
                fileStream = New FileStream(path, FileMode.OpenOrCreate, FileAccess.Write)
                Using fileStream
                    fileStream.SetLength(length)
                    fileStream.Position = offset
                    fileStream.Write(data, 0, data.Length)
                End Using
            Loop
            reader.ReadEndElement()
        End Using
    End Sub
End Class

Opmerkingen

De LogRecordSequence klasse biedt een implementatie van de recordreeksinterface boven op een CLFS-logboek (Common Log File System). Het werkt met de LogStore klasse, die een interface biedt voor het rechtstreeks bewerken en beheren van een CLFS-logboekbestand. Een logboekarchief biedt opslag voor alleen toevoegbewerkingen voor een set schijven. De LogStore klasse vertegenwoordigt deze opslag en biedt methoden voor het toevoegen en verwijderen van containers, het instellen van beleid en het maken van archieven. Het biedt geen methoden voor het lezen van en schrijven naar de opslag; deze methoden worden geleverd door de LogRecordSequence klasse.

De relatie tussen de LogStore klasse en de LogRecordSequence klasse is vergelijkbaar met de relatie tussen een schijfbestand en een FileStream object. Het schijfbestand biedt de werkelijke opslag en heeft kenmerken zoals lengte en laatste toegangstijd, terwijl het FileStream object een weergave biedt van het bestand dat kan worden gebruikt om van het bestand te lezen en ernaar te schrijven. Op dezelfde manier heeft de LogStore klasse kenmerken zoals een beleid en een verzameling schijflengten en biedt de LogRecordSequence klasse een recordgeoriënteerd mechanisme voor het lezen en schrijven van gegevens.

In tegenstelling tot de bestandsrecordreeks die wordt vertegenwoordigd door de FileRecordSequence klasse, slaat een LogStore exemplaar de gegevens op in een verzameling schijflengten, vertegenwoordigd door LogExtent exemplaren. De gebieden in een bepaald LogStore exemplaar zijn allemaal uniform en ruimte wordt toegevoegd aan en verwijderd uit een LogStore instantie in stappen. Als u logboeken wilt toevoegen en verwijderen, gebruikt u de Add en Remove methoden van het LogExtentCollection object, die door de Extents eigenschap kunnen worden geretourneerd.

Aan een LogStore exemplaar kan beleid zijn gekoppeld. Deze worden vertegenwoordigd door LogPolicy exemplaren die kunnen worden geretourneerd door de Policy eigenschap. Een beleid bepaalt regels die door het logboek worden gevolgd, zoals het maximum aantal gebieden en de minimale grootte, en instructies voor het vergroten of verkleinen van de LogStore onder bepaalde voorwaarden. Daarnaast kunt u opgeven of een LogStore exemplaar kan worden gearchiveerd. Beleidsregels worden per logboek ingesteld en zijn vluchtig, wat betekent dat zodra elke ingang voor het logboek is gesloten, het beleid niet meer bestaat.