LogRecordSequence.TailPinned Evento

Definizione

Spazio dei nomi:

System.IO.Log

Assembly:

System.IO.Log.dll

Segnala l'esigenza di spostare la coda della sequenza.

public:
 virtual event EventHandler<System::IO::Log::TailPinnedEventArgs ^> ^ TailPinned;

public event EventHandler<System.IO.Log.TailPinnedEventArgs> TailPinned;

member this.TailPinned : EventHandler<System.IO.Log.TailPinnedEventArgs> 

Public Custom Event TailPinned As EventHandler(Of TailPinnedEventArgs) 

Tipo evento

EventHandler<TailPinnedEventArgs>

Implementazioni

TailPinned

Esempio

In questo esempio viene illustrato come utilizzare l'evento TailPinned:

recordSequence.RetryAppend = true;  
recordSequence.TailPinned += new EventHandler<TailPinnedEventArgs>(HandleTailPinned);  

void HandleTailPinned(object sender, TailPinnedEventArgs tailPinnedEventArgs)  
{  
   // tailPinnedEventArgs.TargetSequenceNumber is the target   
   // sequence number to free up space to.    
   // However, this sequence number is not necessarily valid.  We have  
   // to use this sequence number as a starting point for finding a  
   // valid point within the log to advance toward. You need to  
   // identify a record with a sequence number equal to, or greater  
   // than TargetSequenceNumber; let's call this   
   // realTargetSequenceNumber. Once found, move the base  

   recordSequence.AdvanceBaseSequenceNumber(realTargetSequenceNumber);  

}  

Commenti

Questo evento può essere generato quando si verifica una condizione di spazio insufficiente nella sequenza di record. Quando viene generato questo evento, la coda della sequenza (ovvero il numero di sequenza di base) viene spostata in avanti per liberare spazio.

L'evento può essere generato in qualsiasi momento in cui la sequenza di record decide che è necessario liberare spazio, per una qualsiasi ragione. Ad esempio, il motore dei criteri CLFS può decidere di generare l'evento quando determina che le code di due client di log che condividono lo stesso file di log sono troppo distanti. Il recupero dello spazio può essere effettuato scrivendo aree di riavvio o troncando il log e utilizzando il metodo AdvanceBaseSequenceNumber per il recupero dello spazio. Il codice riportato nella sezione relativa agli esempi illustra la seconda possibilità.

È inoltre possibile chiamare il metodo WriteRestartArea all'esterno dell'evento TailPinned per recuperare spazio. Un'area di riavvio è simile a un checkpoint in altri sistemi di elaborazione di log. La chiamata di questo metodo indica che l'applicazione considera tutti i record precedenti prima dell'area di riavvio come completi e utilizzabili per successive aggiunte di record. Analogamente agli altri record, per poter funzionare, il record scritto da questo metodo richiede spazio disponibile effettivo nel log.