LogPolicy Classe

Definizione

Spazio dei nomi:

System.IO.Log

Assembly:

System.IO.Log.dll

Rappresenta il criterio associato a un'istanza LogStore.

public ref class LogPolicy sealed

public sealed class LogPolicy

type LogPolicy = class

Public NotInheritable Class LogPolicy

Ereditarietà

Object

LogPolicy

Esempio

In questo esempio viene illustrato come utilizzare la classe LogPolicy per impostare criteri per una sequenza del record del registro.

// SET LOG POLICY

LogPolicy policy = sequence.LogStore.Policy;

// Set AutoGrow policy. This enables the log to automatically grow
// when the existing extents are full. New extents are added until
// we reach the MaximumExtentCount extents.
// AutoGrow policy is supported only in Windows Vista and not available in R2.

//policy.AutoGrow = true;

// Set the Growth Rate in terms of extents. This policy specifies
// "how much" the log should grow.
policy.GrowthRate = new PolicyUnit(2, PolicyUnitType.Extents);

// Set the AutoShrink policy. This enables the log to automatically
// shrink if the available free space exceeds the shrink percentage.
// AutoGrow/shrink policy is supported only in Windows Vista and not available in R2.

//policy.AutoShrinkPercentage = new PolicyUnit(30, PolicyUnitType.Percentage);

// Set the PinnedTailThreshold policy.
// A tail pinned event is triggered when there is no
// log space available and log space may be freed by advancing the base.
// The user must handle the tail pinned event by advancing the base of the log.
// If the user is not able to move the base of the log, the user should report with exception in
// the tail pinned handler.
// PinnedTailThreashold policy dictates the amount of space that the TailPinned event requests
// for advancing the base of the log. The amount of space can be in percentage or in terms of bytes
// which is rounded off to the nearest containers in CLFS. The default is 35 percent.

policy.PinnedTailThreshold = new PolicyUnit(10, PolicyUnitType.Percentage);

// Set the maximum extents the log can have.
policy.MaximumExtentCount = 6;

// Set the minimum extents the log can have.
policy.MinimumExtentCount = 2;

// Set the prefix for new containers that are added.
// when AutoGrow is enabled.
//policy.NewExtentPrefix = "MyLogPrefix";

// Set the suffix number for new containers that are added.
// when AutoGrow is enabled.
policy.NextExtentSuffix = 3;

// Commit the log policy.
policy.Commit();

// Refresh updates the IO.Log policy properties with current log policy
// set in the log.
policy.Refresh();

// LOG POLICY END
//

' SET LOG POLICY

Dim policy As LogPolicy = sequence.LogStore.Policy

' Set AutoGrow policy. This enables the log to automatically grow
' when the existing extents are full. New extents are added until
' we reach the MaximumExtentCount extents.
' AutoGrow policy is supported only in Windows Vista and not available in R2.

'policy.AutoGrow = true;

' Set the Growth Rate in terms of extents. This policy specifies
' "how much" the log should grow. 
policy.GrowthRate = New PolicyUnit(2, PolicyUnitType.Extents)

' Set the AutoShrink policy. This enables the log to automatically
' shrink if the available free space exceeds the shrink percentage. 
' AutoGrow/shrink policy is supported only in Windows Vista and not available in R2.

'policy.AutoShrinkPercentage = new PolicyUnit(30, PolicyUnitType.Percentage);

' Set the PinnedTailThreshold policy.
' A tail pinned event is triggered when there is no
' log space available and log space may be freed by advancing the base.
' The user must handle the tail pinned event by advancing the base of the log. 
' If the user is not able to move the base of the log, the user should report with exception in
' the tail pinned handler.
' PinnedTailThreashold policy dictates the amount of space that the TailPinned event requests 
' for advancing the base of the log. The amount of space can be in percentage or in terms of bytes 
' which is rounded off to the nearest containers in CLFS. The default is 35 percent.


policy.PinnedTailThreshold = New PolicyUnit(10, PolicyUnitType.Percentage)

' Set the maximum extents the log can have.
policy.MaximumExtentCount = 6

' Set the minimum extents the log can have.
policy.MinimumExtentCount = 2

' Set the prefix for new containers that are added. 
' when AutoGrow is enabled.
'policy.NewExtentPrefix = "MyLogPrefix";

' Set the suffix number for new containers that are added.
' when AutoGrow is enabled. 
policy.NextExtentSuffix = 3

' Commit the log policy.
policy.Commit()

' Refresh updates the IO.Log policy properties with current log policy 
' set in the log. 
policy.Refresh()

' LOG POLICY END
'

Commenti

Un criterio è un set di regole a cui devono attenersi un'istanza LogStore e i relativi client. Un'istanza LogPolicy viene utilizzata per esaminare e modificare il criterio associa a un'istanza LogStore specifica. Un criterio può descrivere le dimensioni minima e massima consentite per il log o la dimensione massima consentita per l'istanza LogStore. È inoltre possibile controllare se un'istanza LogStore può essere archiviata.

Dopo avere modificato una proprietà, è necessario utilizzare il metodo Commit per garantire che le modifiche vengano applicate all'istanza LogStore. È possibile chiamare il metodo Refresh per annullare le modifiche o per ottenere il criterio più recente.

Proprietà

AutoGrow	Ottiene o imposta un valore che indica se l'istanza LogStore può crescere automaticamente.
AutoShrinkPercentage	Ottiene o imposta la percentuale di spazio libero che può essere compattato dall'istanza LogStore.
GrowthRate	Ottiene o imposta la velocità di espansione automatica di LogStore.
MaximumExtentCount	Ottiene o imposta il numero massimo di istanze LogExtent che può contenere LogStore.
MinimumExtentCount	Ottiene o imposta il numero minimo di istanze LogExtent che può contenere LogStore.
NewExtentPrefix	Ottiene o imposta la stringa del prefisso per gli extent creati automaticamente.
NextExtentSuffix	Ottiene o imposta il numero del suffisso per i nuovi extent.
PinnedTailThreshold	Ottiene o imposta il quantità di spazio che richiede l'evento TailPinned per anticipare la base del log.

Metodi

Commit()	Imposta questo criterio come il criterio corrente per l'istanza LogStore.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
Refresh()	Legge il criterio corrente per l'istanza LogStore, annullando qualsiasi modifica eventualmente apportata.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)