LogPolicy Klasse

Definition

Namespace:

System.IO.Log

Assembly:

System.IO.Log.dll

Stellt die einem LogStore zugeordnete Richtlinie dar.

public ref class LogPolicy sealed

public sealed class LogPolicy

type LogPolicy = class

Public NotInheritable Class LogPolicy

Vererbung

Object

LogPolicy

Beispiele

Dieses Beispiel zeigt, wie die LogPolicy-Klasse verwendet wird, um eine Richtlinie für eine Protokolldatensatzsequenz festzulegen.

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

Hinweise

Eine Richtlinie ist ein Satz von Regeln, die von einer LogStore-Instanz und ihren Clients eingehalten werden müssen. Eine LogPolicy-Instanz wird verwendet, um die einem bestimmten LogStore zugeordnete Richtlinie zu untersuchen und zu ändern. Eine Richtlinie kann die zulässige Mindest- und Maximalgröße von Protokollen bestimmen oder festlegen, wie die LogStore-Instanz wachsen darf. Außerdem können Sie kontrollieren, ob eine LogStore-Instanz archiviert werden kann.

Nach dem Ändern von Eigenschaften sollten Sie mithilfe der Commit-Methode sicherstellen, dass die Änderungen auf den LogStore angewendet wurden. Sie können die Refresh-Methode aufrufen, um Änderungen zu verwerfen oder die aktuellste Richtlinie abzurufen.

Eigenschaften

AutoGrow	Ruft einen Wert ab, der angibt, ob der LogStore automatisch wachsen kann, oder legt ihn fest.
AutoShrinkPercentage	Ruft den Prozentwert des freien Speicherplatzes ab, den der LogStore verkleinern kann, oder legt ihn fest.
GrowthRate	Ruft die Rate der automatischen Zunahme des LogStore ab oder legt diese fest.
MaximumExtentCount	Ruft die maximale Anzahl der LogExtent-Instanzen ab, die der LogStore enthalten kann.
MinimumExtentCount	Ruft die Mindestanzahl der LogExtent-Instanzen ab, die der LogStore enthalten kann, oder legt sie fest.
NewExtentPrefix	Ruft die Präfixzeichenfolge für automatisch erstellte Wertebereiche ab oder legt sie fest.
NextExtentSuffix	Ruft die Suffixnummer für neue Wertebereiche ab oder legt sie fest.
PinnedTailThreshold	Ruft den Speicherplatz ab, der für das TailPinned-Ereignis zum Voranbringen der Basis des Protokolls erforderlich ist, oder legt ihn fest.

Methoden

Commit()	Legt diese Richtlinie als aktuelle Richtlinie für den LogStore fest.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
Refresh()	Liest die aktuelle Richtlinie für den LogStore und verwirft alle Änderungen, die möglicherweise vorgenommen wurden.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)