LogPolicy 類別

定義

命名空間:

System.IO.Log

組件:

System.IO.Log.dll

代表與 LogStore 相關聯的原則。

public ref class LogPolicy sealed

public sealed class LogPolicy

type LogPolicy = class

Public NotInheritable Class LogPolicy

繼承

Object

LogPolicy

範例

這個範例將示範如何使用 LogPolicy 類別來為記錄檔記錄順序設定原則。

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

備註

原則是 LogStore 執行個體及其用戶端所應遵循的規則集。 您可以使用 LogPolicy 執行個體來檢查和修改與特定 LogStore 相關聯的原則。 原則可以描述允許的記錄檔大小上限及下限，或描述允許 LogStore 執行個體擴增的方式。 此外，您還可以控制是否封存 LogStore 執行個體。

在變更任何屬性之後，您應該使用 Commit 方法，以確保這項變更會套用至 LogStore。 您可以呼叫 Refresh 方法來捨棄變更，或取得最新的原則。

屬性

AutoGrow	取得或設定值，這個值表示 LogStore 是否可以自動擴增。
AutoShrinkPercentage	取得或設定 LogStore 可以縮減的可用空間百分比。
GrowthRate	取得或設定 LogStore 的自動擴增速率。
MaximumExtentCount	取得或設定 LogExtent 可以包含之 LogStore 執行個體的最大數目。
MinimumExtentCount	取得或設定 LogExtent 可以包含之 LogStore 執行個體的最小數目。
NewExtentPrefix	取得或設定自動建立之延伸區的前置字串。
NextExtentSuffix	取得或設定新延伸區的後置數字。
PinnedTailThreshold	取得或設定 TailPinned 事件要求將記錄檔基底往前移動時所需的空間量。

方法

Commit()	將這個原則設定為 LogStore 的目前原則。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
Refresh()	讀取 LogStore 的目前原則，並捨棄可能已進行的任何變更。
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)