PolicyUnit Struktur

Definition

Namespace:

System.IO.Log

Assembly:

System.IO.Log.dll

Stellt eine Größenmessung in einer Protokollspeicherrichtlinie dar.

public value class PolicyUnit

public struct PolicyUnit

type PolicyUnit = struct

Public Structure PolicyUnit

Vererbung

Object

ValueType

PolicyUnit

Beispiele

Dieses Beispiel veranschaulicht die Verwendung der LogPolicy-Klasse und der PolicyUnit-Struktur, um die 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

Die PolicyUnit-Struktur stellt eine Größenmessung in einer Protokollspeicherrichtlinie dar. Die PolicyUnitType-Enumeration listet die darstellbaren Maßeinheiten auf.

Sie können die Value-Eigenschaft verwenden, um die Größe der Messung zu bestimmen. Verwenden Sie zum Bestimmen der Maßeinheit die Type-Eigenschaft. Sie können andere Datentypen in eine PolicyUnit konvertieren, indem Sie die Percentage-Methode und die Extents-Methode verwenden.

Konstruktoren

PolicyUnit(Int64, PolicyUnitType)

Initialisiert eine neue Instanz der PolicyUnit-Struktur mit dem angegebenen Wert und Typ.

Eigenschaften

Type	Ruft den Einheitentyp der PolicyUnit ab.
Value	Ruft den Wert von PolicyUnit ab.

Methoden

Equals(Object)	Gibt an, ob diese Instanz und ein angegebenes Objekt gleich sind.
Extents(Int64)	Erstellt aus der festgelegten Anzahl eine PolicyUnit des Typs Extents.
GetHashCode()	Stellt einen eindeutigen Hashcode für dieses Objekt bereit.
Percentage(Int64)	Erstellt aus der festgelegten Anzahl eine PolicyUnit des Typs Percentage.
ToString()	Gibt eine Zeichenfolgendarstellung dieses Objekts zurück.

Operatoren

Equality(PolicyUnit, PolicyUnit)	Vergleicht zwei PolicyUnit-Instanzen auf Gleichheit.
Inequality(PolicyUnit, PolicyUnit)	Vergleicht zwei PolicyUnit-Instanzen auf Ungleichheit.

Weitere Informationen

• LogPolicy
• PolicyUnitType