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)