FileRecordSequence.Append Metodo

Definizione

Spazio dei nomi:: System.IO.Log

Assembly:: System.IO.Log.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Scrive un record di log in FileRecordSequence.

Overload

Nome	Descrizione
Append(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions)	Scrive un record di log in FileRecordSequence. Questo metodo non può essere ereditato.
Append(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions)	Scrive un record di log in FileRecordSequence. Questo metodo non può essere ereditato.
Append(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection)	Scrive un record di log in FileRecordSequence, usando lo spazio precedentemente riservato nella sequenza. Questo metodo non può essere ereditato.
Append(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection)	Scrive un record di log in FileRecordSequence, usando lo spazio precedentemente riservato nella sequenza. Questo metodo non può essere ereditato.

Esempio

Nell'esempio seguente viene creata una sequenza di record, viene aggiunto un record e infine vengono letti i record.


using System;
using System.IO;
using System.IO.Log;
using System.Collections.Generic;
using System.Text;

namespace MyFileRecordSequence
{

class ReadRecordsSample
{
    static SequenceNumber AppendRecord(IRecordSequence sequence, string message, SequenceNumber user, SequenceNumber previous)
    {
        MemoryStream data = new MemoryStream();
        BinaryWriter writer = new BinaryWriter(data);
        writer.Write(message); ArraySegment<byte>[] segments;
        segments = new ArraySegment<byte>[1];
        segments[0] = new ArraySegment<byte>(data.GetBuffer(), 0, (int)data.Length);
        return sequence.Append(segments, user, previous,RecordAppendOptions.None);
    }
    public static void Main(string[] args)
    {
        IRecordSequence sequence;
        sequence = new FileRecordSequence(args[0]);
        SequenceNumber a, b, c, d;
        a = AppendRecord(sequence, "This is record A", SequenceNumber.Invalid, SequenceNumber.Invalid);
        Console.WriteLine("Record A has sequence number System.IO.Log", a);
        b = AppendRecord(sequence, "This is record B", a, a);
        Console.WriteLine("Record B has sequence number System.IO.Log", b);
        c = AppendRecord(sequence, "This is record C", a, a);
        Console.WriteLine("Record C has sequence number System.IO.Log", c);
        d = AppendRecord(sequence, "This is record D", b, c);
        Console.WriteLine("Record D has sequence number System.IO.Log", d);
        foreach(LogRecord record in sequence.ReadLogRecords(a,LogRecordEnumeratorType.Next))
        {
            BinaryReader reader = new BinaryReader(record.Data);
            Console.WriteLine("System.IO.Log: T:System.IO.Log.IRecordSequence", record.SequenceNumber, reader.ReadString());
        }
        foreach(LogRecord record in sequence.ReadLogRecords(d, LogRecordEnumeratorType.User))
        {
            BinaryReader reader = new BinaryReader(record.Data);
            Console.WriteLine("System.IO.Log: T:System.IO.Log.IRecordSequence", record.SequenceNumber, reader.ReadString());
        }
        foreach(LogRecord record in sequence.ReadLogRecords(d, LogRecordEnumeratorType.Previous))
        {
            BinaryReader reader = new BinaryReader(record.Data);
            Console.WriteLine("System.IO.Log: T:System.IO.Log.IRecordSequence", record.SequenceNumber, reader.ReadString());
        }
    }
}

Imports System.IO
Imports System.IO.Log
Imports System.Collections.Generic
Imports System.Text


Namespace MyFileRecordSequence


Friend Class ReadRecordsSample
    Private Shared Function AppendRecord(ByVal sequence As IRecordSequence, ByVal message As String, ByVal user As SequenceNumber, ByVal previous As SequenceNumber) As SequenceNumber
        Dim data As New MemoryStream()
        Dim writer As New BinaryWriter(data)
        writer.Write(message)
        Dim segments() As ArraySegment(Of Byte)
        segments = New ArraySegment(Of Byte)(0){}
        segments(0) = New ArraySegment(Of Byte)(data.GetBuffer(), 0, CInt(Fix(data.Length)))
        Return sequence.Append(segments, user, previous,RecordAppendOptions.None)
    End Function
    Public Shared Sub Main(ByVal args() As String)
        Dim sequence As IRecordSequence
        sequence = New FileRecordSequence(args(0))
        Dim a, b, c, d As SequenceNumber
        a = AppendRecord(sequence, "This is record A", SequenceNumber.Invalid, SequenceNumber.Invalid)
        Console.WriteLine("Record A has sequence number System.IO.Log", a)
        b = AppendRecord(sequence, "This is record B", a, a)
        Console.WriteLine("Record B has sequence number System.IO.Log", b)
        c = AppendRecord(sequence, "This is record C", a, a)
        Console.WriteLine("Record C has sequence number System.IO.Log", c)
        d = AppendRecord(sequence, "This is record D", b, c)
        Console.WriteLine("Record D has sequence number System.IO.Log", d)
            For Each record In sequence.ReadLogRecords(a, LogRecordEnumeratorType.Next)
                Dim reader As New BinaryReader(record.Data)
                Console.WriteLine("System.IO.Log: T:System.IO.Log.IRecordSequence", record.SequenceNumber, reader.ReadString())
            Next record
            For Each record In sequence.ReadLogRecords(d, LogRecordEnumeratorType.User)
                Dim reader As New BinaryReader(record.Data)
                Console.WriteLine("System.IO.Log: T:System.IO.Log.IRecordSequence", record.SequenceNumber, reader.ReadString())
            Next record
            For Each record In sequence.ReadLogRecords(d, LogRecordEnumeratorType.Previous)
                Dim reader As New BinaryReader(record.Data)
                Console.WriteLine("System.IO.Log: T:System.IO.Log.IRecordSequence", record.SequenceNumber, reader.ReadString())
            Next record
    End Sub
End Class

Append(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions)

Scrive un record di log in FileRecordSequence. Questo metodo non può essere ereditato.

public:
 virtual System::IO::Log::SequenceNumber Append(ArraySegment<System::Byte> data, System::IO::Log::SequenceNumber nextUndoRecord, System::IO::Log::SequenceNumber previousRecord, System::IO::Log::RecordAppendOptions recordAppendOptions);

public System.IO.Log.SequenceNumber Append(ArraySegment<byte> data, System.IO.Log.SequenceNumber nextUndoRecord, System.IO.Log.SequenceNumber previousRecord, System.IO.Log.RecordAppendOptions recordAppendOptions);

abstract member Append : ArraySegment<byte> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions -> System.IO.Log.SequenceNumber
override this.Append : ArraySegment<byte> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions -> System.IO.Log.SequenceNumber

Public Function Append (data As ArraySegment(Of Byte), nextUndoRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions) As SequenceNumber

Parametri

data: ArraySegment<Byte>

Elenco di segmenti di matrice di byte che verranno concatenati e accodati come record.

nextUndoRecord: SequenceNumber

Numero di sequenza del record successivo nell'ordine specificato dall'utente.

previousRecord: SequenceNumber

Numero di sequenza del record successivo nell'ordine precedente.

recordAppendOptions: RecordAppendOptions

Valore valido di che specifica la modalità di RecordAppendOptions scrittura dei dati.

Valori restituiti

SequenceNumber

Numero di sequenza del record di log accodato.

Implementazioni

Append(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions)

Eccezioni

ArgumentNullException

Uno o più argomenti sono null.

ArgumentOutOfRangeException

Uno o più argomenti non sono compresi nell'intervallo.

NotSupportedException

Impossibile eseguire l'operazione perché la sequenza di record è stata aperta con accesso di sola lettura.

IOException

Impossibile eseguire la richiesta a causa di un'eccezione di I/O imprevista.

ObjectDisposedException

Il metodo è stato chiamato dopo che la sequenza è stata eliminata.

OutOfMemoryException

Memoria insufficiente per continuare l'esecuzione del programma.

SequenceFullException

La sequenza di record è piena.

Esempio

Nell'esempio seguente viene creata una sequenza di record, viene aggiunto un record e infine vengono letti i record.

using System;
using System.IO;
using System.Collections.Generic;
using System.Text;
using System.IO.Log;

namespace MyFileRecordSequence
{
    public class MyLog
    {
        string logName = "test.log";
        FileRecordSequence sequence = null;
        bool delete = true;

        public MyLog()
        {
            // Create a FileRecordSequence
            sequence = new FileRecordSequence(logName, FileAccess.ReadWrite);
        }

        // Append records to the record sequence.
        public void AppendRecords()
        {
            Console.WriteLine("Appending Log Records...");
            SequenceNumber previous = SequenceNumber.Invalid;

            previous = sequence.Append(CreateData("Hello World!"), SequenceNumber.Invalid, SequenceNumber.Invalid, RecordAppendOptions.ForceFlush);
            previous = sequence.Append(CreateData("This is my first Logging App"), SequenceNumber.Invalid, SequenceNumber.Invalid, RecordAppendOptions.ForceFlush);
            previous = sequence.Append(CreateData("Using FileRecordSequence..."), SequenceNumber.Invalid, SequenceNumber.Invalid, RecordAppendOptions.ForceFlush);

            Console.WriteLine("Done...");
        }
    
        // Read the records added to the log.
        public void ReadRecords()
        {
            Encoding enc = Encoding.Unicode;

            Console.WriteLine();
            Console.WriteLine("Reading Log Records...");
            
            try
            {
                foreach (LogRecord record in this.sequence.ReadLogRecords(this.sequence.BaseSequenceNumber, LogRecordEnumeratorType.Next))
                {
                    byte[] data = new byte[record.Data.Length];
                    record.Data.Read(data, 0, (int)record.Data.Length);
                    string mystr = enc.GetString(data);
                    Console.WriteLine("    {0}", mystr);
                }
            }
            catch (Exception e)
            {
                Console.WriteLine("Exception {0} {1}", e.GetType(), e.Message);
            }

            Console.WriteLine();
        }
    
        // Dispose the record sequence and delete the log file.
        public void Cleanup()
        {
            // Dispose the sequence
            sequence.Dispose();

            // Delete the log file...
            if (delete)
            {
                try
                {
                    File.Delete(this.logName);
                }
                catch (Exception e)
                {
                    Console.WriteLine("Exception {0} {1}", e.GetType(), e.Message);
                }
            }
        }

        // Converts the given data to Array of ArraSegment<byte>
        public static IList<ArraySegment<byte>> CreateData(string str)
        {
            Encoding enc = Encoding.Unicode;

            byte[] array = enc.GetBytes(str);

            ArraySegment<byte>[] segments = new ArraySegment<byte>[1];
            segments[0] = new ArraySegment<byte>(array);

            return Array.AsReadOnly<ArraySegment<byte>>(segments);
        }
    }

    class LogSample
    {
        static void Main(string[] args)
        {
            MyLog log = new MyLog();

            log.AppendRecords();
            log.ReadRecords();
            log.Cleanup();
        }
    }
}

Commenti

I dati contenuti nel data parametro verranno concatenati in una singola matrice di byte per l'aggiunta come record. Tuttavia, non viene effettuato alcun provisioning per la suddivisione dei dati in segmenti di matrice quando il record viene letto.

In genere, questo metodo viene completato prima della scrittura del record. Per assicurarsi che sia stato scritto un record, specificare il ForceFlush flag usando il recordAppendOptions parametro o chiamare il Flush metodo .

Si applica a

Append(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions)

Scrive un record di log in FileRecordSequence. Questo metodo non può essere ereditato.

public:
 virtual System::IO::Log::SequenceNumber Append(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ data, System::IO::Log::SequenceNumber nextUndoRecord, System::IO::Log::SequenceNumber previousRecord, System::IO::Log::RecordAppendOptions recordAppendOptions);

public System.IO.Log.SequenceNumber Append(System.Collections.Generic.IList<ArraySegment<byte>> data, System.IO.Log.SequenceNumber nextUndoRecord, System.IO.Log.SequenceNumber previousRecord, System.IO.Log.RecordAppendOptions recordAppendOptions);

abstract member Append : System.Collections.Generic.IList<ArraySegment<byte>> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions -> System.IO.Log.SequenceNumber
override this.Append : System.Collections.Generic.IList<ArraySegment<byte>> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions -> System.IO.Log.SequenceNumber

Public Function Append (data As IList(Of ArraySegment(Of Byte)), nextUndoRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions) As SequenceNumber

Parametri

data: IList<ArraySegment<Byte>>

Elenco di segmenti di matrice di byte che verranno concatenati e accodati come record.

nextUndoRecord: SequenceNumber

Numero di sequenza del record successivo nell'ordine specificato dall'utente.

previousRecord: SequenceNumber

Numero di sequenza del record successivo nell'ordine precedente.

recordAppendOptions: RecordAppendOptions

Valore valido di che specifica la modalità di RecordAppendOptions scrittura dei dati.

Valori restituiti

SequenceNumber

Numero di sequenza del record di log accodato.

Implementazioni

Append(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions)

Eccezioni

ArgumentNullException

Uno o più argomenti sono null.

ArgumentOutOfRangeException

Uno o più argomenti non sono compresi nell'intervallo.

NotSupportedException

Impossibile eseguire l'operazione perché la sequenza di record è stata aperta con accesso di sola lettura.

IOException

Impossibile eseguire la richiesta a causa di un'eccezione di I/O imprevista.

ObjectDisposedException

Il metodo è stato chiamato dopo che la sequenza è stata eliminata.

OutOfMemoryException

Memoria insufficiente per continuare l'esecuzione del programma.

SequenceFullException

La sequenza di record è piena.

Esempio

Nell'esempio seguente viene illustrato come creare una sequenza di record con questo metodo.

// Append records to the record sequence.
    public void AppendRecords()
    {
        Console.WriteLine("Appending Log Records...");
        SequenceNumber previous = SequenceNumber.Invalid;

        previous = sequence.Append(CreateData("Hello World!"), SequenceNumber.Invalid, SequenceNumber.Invalid, RecordAppendOptions.ForceFlush);
        previous = sequence.Append(CreateData("This is my first Logging App"), SequenceNumber.Invalid, SequenceNumber.Invalid, RecordAppendOptions.ForceFlush);
        previous = sequence.Append(CreateData("Using FileRecordSequence..."), SequenceNumber.Invalid, SequenceNumber.Invalid, RecordAppendOptions.ForceFlush);

        Console.WriteLine("Done...");
    }

' Append records to the record sequence.
    Public Sub AppendRecords()
        Console.WriteLine("Appending Log Records...")
        Dim previous As SequenceNumber = SequenceNumber.Invalid

        previous = sequence.Append(CreateData("Hello World!"), SequenceNumber.Invalid, SequenceNumber.Invalid, RecordAppendOptions.ForceFlush)
        previous = sequence.Append(CreateData("This is my first Logging App"), SequenceNumber.Invalid, SequenceNumber.Invalid, RecordAppendOptions.ForceFlush)
        previous = sequence.Append(CreateData("Using FileRecordSequence..."), SequenceNumber.Invalid, SequenceNumber.Invalid, RecordAppendOptions.ForceFlush)

        Console.WriteLine("Done...")
    End Sub

Commenti

Si applica a

Append(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection)

Scrive un record di log in FileRecordSequence, usando lo spazio precedentemente riservato nella sequenza. Questo metodo non può essere ereditato.

public:
 virtual System::IO::Log::SequenceNumber Append(ArraySegment<System::Byte> data, System::IO::Log::SequenceNumber nextUndoRecord, System::IO::Log::SequenceNumber previousRecord, System::IO::Log::RecordAppendOptions recordAppendOptions, System::IO::Log::ReservationCollection ^ reservations);

public System.IO.Log.SequenceNumber Append(ArraySegment<byte> data, System.IO.Log.SequenceNumber nextUndoRecord, System.IO.Log.SequenceNumber previousRecord, System.IO.Log.RecordAppendOptions recordAppendOptions, System.IO.Log.ReservationCollection reservations);

abstract member Append : ArraySegment<byte> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * System.IO.Log.ReservationCollection -> System.IO.Log.SequenceNumber
override this.Append : ArraySegment<byte> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * System.IO.Log.ReservationCollection -> System.IO.Log.SequenceNumber

Public Function Append (data As ArraySegment(Of Byte), nextUndoRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions, reservations As ReservationCollection) As SequenceNumber

Parametri

data: ArraySegment<Byte>

Elenco di segmenti di matrice di byte che verranno concatenati e accodati come record.

nextUndoRecord: SequenceNumber

Numero di sequenza del record successivo nell'ordine specificato dall'utente.

previousRecord: SequenceNumber

Numero di sequenza del record successivo nell'ordine precedente.

recordAppendOptions: RecordAppendOptions

Valore valido di che specifica la modalità di RecordAppendOptions scrittura dei dati.

reservations: ReservationCollection

Oggetto ReservationCollection contenente la prenotazione che deve essere utilizzata per questo record.

Valori restituiti

SequenceNumber

Numero di sequenza del record di log accodato.

Implementazioni

Append(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection)

Eccezioni

ArgumentNullException

Uno o più argomenti sono null.

ArgumentOutOfRangeException

Uno o più argomenti non sono compresi nell'intervallo.

ArgumentException

reservations non è stato creato da questa sequenza di record.

NotSupportedException

Impossibile eseguire l'operazione perché la sequenza di record è stata aperta con accesso di sola lettura.

IOException

Impossibile eseguire la richiesta a causa di un'eccezione di I/O imprevista.

ObjectDisposedException

Il metodo è stato chiamato dopo che la sequenza è stata eliminata.

OutOfMemoryException

Memoria insufficiente per continuare l'esecuzione del programma.

SequenceFullException

La sequenza di record è piena.

ReservationNotFoundException

Nessuna prenotazione abbastanza grande da adattarsi data è disponibile in reservations.

Commenti

Il record accodato utilizzerà lo spazio precedentemente riservato, usando una prenotazione specificata dal reservations parametro . Se l'accodamento ha esito positivo, utilizzerà l'area di prenotazione più piccola che può contenere i dati e tale area di prenotazione verrà rimossa dalla raccolta.

Si applica a

Append(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection)

Scrive un record di log in FileRecordSequence, usando lo spazio precedentemente riservato nella sequenza. Questo metodo non può essere ereditato.

public:
 virtual System::IO::Log::SequenceNumber Append(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ data, System::IO::Log::SequenceNumber nextUndoRecord, System::IO::Log::SequenceNumber previousRecord, System::IO::Log::RecordAppendOptions recordAppendOptions, System::IO::Log::ReservationCollection ^ reservations);

public System.IO.Log.SequenceNumber Append(System.Collections.Generic.IList<ArraySegment<byte>> data, System.IO.Log.SequenceNumber nextUndoRecord, System.IO.Log.SequenceNumber previousRecord, System.IO.Log.RecordAppendOptions recordAppendOptions, System.IO.Log.ReservationCollection reservations);

abstract member Append : System.Collections.Generic.IList<ArraySegment<byte>> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * System.IO.Log.ReservationCollection -> System.IO.Log.SequenceNumber
override this.Append : System.Collections.Generic.IList<ArraySegment<byte>> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * System.IO.Log.ReservationCollection -> System.IO.Log.SequenceNumber

Public Function Append (data As IList(Of ArraySegment(Of Byte)), nextUndoRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions, reservations As ReservationCollection) As SequenceNumber

Parametri

data: IList<ArraySegment<Byte>>

Elenco di segmenti di matrice di byte che verranno concatenati e accodati come record.

nextUndoRecord: SequenceNumber

Numero di sequenza del record successivo nell'ordine specificato dall'utente.

previousRecord: SequenceNumber

Numero di sequenza del record successivo nell'ordine precedente.

recordAppendOptions: RecordAppendOptions

Valore valido di che specifica la modalità di RecordAppendOptions scrittura dei dati.

reservations: ReservationCollection

Oggetto ReservationCollection contenente la prenotazione che deve essere utilizzata per questo record.

Valori restituiti

SequenceNumber

Numero di sequenza del record di log accodato.

Implementazioni

Append(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection)

Eccezioni

ArgumentNullException

Uno o più argomenti sono null.

ArgumentOutOfRangeException

Uno o più argomenti non sono compresi nell'intervallo.

ArgumentException

reservations non è stato creato da questa sequenza di record.

NotSupportedException

Impossibile eseguire l'operazione perché la sequenza di record è stata aperta con accesso di sola lettura.

IOException

Impossibile eseguire la richiesta a causa di un'eccezione di I/O imprevista.

ObjectDisposedException

Il metodo è stato chiamato dopo che la sequenza è stata eliminata.

OutOfMemoryException

Memoria insufficiente per continuare l'esecuzione del programma.

SequenceFullException

La sequenza di record è piena.

ReservationNotFoundException

Nessuna prenotazione abbastanza grande da adattarsi data è disponibile in reservations.

Commenti

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?