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)