LogPolicy Classe

Definição

Namespace:

System.IO.Log

Assembly:

System.IO.Log.dll

Representa a política associada a um LogStore.

public ref class LogPolicy sealed

public sealed class LogPolicy

type LogPolicy = class

Public NotInheritable Class LogPolicy

Herança

Object

LogPolicy

Exemplos

Este exemplo mostra como usar a LogPolicy classe para definir a política para uma sequência de registro de log.

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

Comentários

Uma política é um conjunto de regras a serem seguidas por uma LogStore instância e seus clientes. Uma LogPolicy instância é usada para examinar e modificar a política associada a um específico LogStore. Uma política pode descrever os tamanhos de log permitidos mínimos e máximos ou como a LogStore instância tem permissão para crescer. Além disso, você também pode controlar se uma LogStore instância pode ser arquivada.

Depois de alterar qualquer uma das propriedades, você deve usar o Commit método para garantir que as alterações sejam aplicadas ao LogStore. Você pode chamar o Refresh método para descartar alterações ou para obter a política mais atual.

Propriedades

AutoGrow	Obtém ou define um valor que indica se o LogStore pode crescer automaticamente.
AutoShrinkPercentage	Obtém ou define o percentual de espaço livre que o LogStore pode reduzir.
GrowthRate	Obtém ou define a taxa de crescimento automático do LogStore.
MaximumExtentCount	Obtém ou define o número máximo de instâncias LogExtent que LogStore pode conter.
MinimumExtentCount	Obtém ou define o número mínimo de instâncias LogExtent que LogStore pode conter.
NewExtentPrefix	Obtém ou define a cadeia de caracteres de prefixo para extensões criadas automaticamente.
NextExtentSuffix	Obtém ou define o número de sufixo de novas extensões.
PinnedTailThreshold	Obtém ou define a quantidade de espaço que o evento TailPinned requer para avançar a base do log.

Métodos

Commit()	Define essa política como a política atual para o LogStore.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
Refresh()	Lê a política atual para o LogStore, descartando todas as alterações que talvez tenham sido feitas.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)