LogArchiveSnapshot Klasse

Definition

Namespace:

System.IO.Log

Assembly:

System.IO.Log.dll

Stellt eine Momentaufnahme der LogStore Instanz dar, die zum Generieren eines Archivs verwendet werden kann.

public ref class LogArchiveSnapshot sealed

public sealed class LogArchiveSnapshot

type LogArchiveSnapshot = class

Public NotInheritable Class LogArchiveSnapshot

Vererbung

Object

LogArchiveSnapshot

Beispiele

Das folgende Beispiel zeigt, wie sie die LogArchiveSnapshot Klasse zum Archivieren eines LogStore XML-Dokuments verwenden.

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

Hinweise

Ein LogArchiveSnapshot Objekt enthält die informationen, die zum Generieren einer konsistenten Sicherung der Daten in einem LogStore. Die tatsächlichen Daten sind in der aufzählbaren Auflistung von FileRegion Objekten enthalten, die von der ArchiveRegions Eigenschaft zurückgegeben werden. Jede FileRegion Instanz stellt eine Abfolge von Bytes in einer Datei dar, die archiviert werden muss.

Die ArchiveTailEigenschaften BaseSequenceNumberund LastSequenceNumber Eigenschaften dienen nur informationszwecken. Sie können zusammen mit den Archivdaten aufgezeichnet werden, um optionale Informationen bereitzustellen, sind jedoch nicht erforderlich, um die Daten wiederherzustellen.

Eigenschaften

Name	Beschreibung
ArchiveRegions	Ruft eine aufzählbare Auflistung von FileRegion Instanzen ab, die die tatsächlichen Archivierungsdaten enthalten.
ArchiveTail	Ruft die Sequenznummer des LogStore Archivschwanzs zum Zeitpunkt der Aufnahme der Momentaufnahme ab.
BaseSequenceNumber	Ruft die Basissequenznummer des LogStore Zeitpunkts ab, zu dem die Momentaufnahme erstellt wurde.
LastSequenceNumber	Ruft die letzte Sequenznummer des LogStore Zeitpunkts der Momentaufnahme ab.

Methoden

Name	Beschreibung
Equals(Object)	Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object)
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)