LogPolicy Classe

Définition

Espace de noms:

System.IO.Log

Assembly:

System.IO.Log.dll

Représente la stratégie associée à un LogStore.

public ref class LogPolicy sealed

public sealed class LogPolicy

type LogPolicy = class

Public NotInheritable Class LogPolicy

Héritage

Object

LogPolicy

Exemples

Cet exemple indique comment utiliser la classe LogPolicy pour définir la stratégie d'une séquence d'enregistrement du journal.

// 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
'

Remarques

Une stratégie est un ensemble de règles à suivre par une instance LogStore et ses clients. Une instance LogPolicy est utilisée pour examiner et modifier la stratégie associé à un LogStorespécifique. Une stratégie peut décrire les tailles de journal maximales et minimales autorisées ou comment l'instance LogStore est autorisée à augmenter sa taille. De plus, vous pouvez également définir l'archivage d'une instance LogStore.

Après avoir modifié une des propriétés, vous devez utiliser la méthode Commit pour vous assurer que les modifications sont appliquées à LogStore. Vous pouvez appeler la méthode Refresh pour ignorer les modifications ou obtenir la stratégie la plus récente.

Propriétés

AutoGrow	Obtient ou définit une valeur qui indique si le LogStore peut augmenter sa taille automatiquement.
AutoShrinkPercentage	Obtient ou définit le pourcentage d'espace libre que le LogStore peut réduire.
GrowthRate	Obtient ou définit le facteur d'agrandissement automatique du LogStore.
MaximumExtentCount	Obtient ou définit le nombre maximal d'instances LogExtent que le LogStore peut stocker.
MinimumExtentCount	Obtient ou définit le nombre minimal d'instances LogExtent que le LogStore peut stocker.
NewExtentPrefix	Obtient ou définit la chaîne de préfixe pour les étendues créées automatiquement.
NextExtentSuffix	Obtient ou définit le numéro de suffixe pour les nouvelles étendues.
PinnedTailThreshold	Obtient ou définit la quantité d'espace nécessaire pour l'événement TailPinned afin d'avancer la base du journal.

Méthodes

Commit()	Définit cette stratégie comme stratégie actuelle pour le LogStore.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Refresh()	Lit la stratégie actuelle pour le LogStore, en ignorant toutes les modifications qui ont pu être apportées.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)