GCSettings.LatencyMode プロパティ

定義

ガベージ コレクションの現在の待機モードを取得または設定します。Gets or sets the current latency mode for garbage collection.

public:
 static property System::Runtime::GCLatencyMode LatencyMode { System::Runtime::GCLatencyMode get(); void set(System::Runtime::GCLatencyMode value); };
[set: System.Security.SecurityCritical]
public static System.Runtime.GCLatencyMode LatencyMode { get; set; }
public static System.Runtime.GCLatencyMode LatencyMode { get; set; }
member this.LatencyMode : System.Runtime.GCLatencyMode with get, set
Public Shared Property LatencyMode As GCLatencyMode

プロパティ値

待機モードを指定する列挙値の 1 つ。One of the enumeration values that specifies the latency mode.

属性

例外

LatencyMode プロパティが無効な値に設定されています。The LatencyMode property is being set to an invalid value.

または-or- LatencyMode プロパティを NoGCRegion に設定することはできません。The LatencyMode property cannot be set to NoGCRegion.

注釈

重要な操作中に LowLatencyGCLatencyMode を設定することによって、アプリケーションでのガベージコレクションの割り込みレベルを下げることができます。You can reduce the level of intrusiveness of garbage collection in your application by setting the GCLatencyMode to LowLatency during critical operations. このような操作が完了したら、より多くのオブジェクトを解放してメモリを増やすことができるように、より高い待機時間モードに戻ります。After such operations are completed, return to a higher latency mode so that more objects can be reclaimed to increase memory.

通常は、LatencyMode プロパティの値を設定して、ガベージコレクターの待機時間モードを定義します。Ordinarily, you set the value of the LatencyMode property to define the garbage collector's latency mode. ただし、GCLatencyMode.NoGCRegion 列挙値を LatencyMode プロパティに割り当てることによって、GC 領域の無待機モードを設定することはできません。However, you cannot set the no GC region latency mode by assigning the GCLatencyMode.NoGCRegion enumeration value to the LatencyMode property. 代わりに、GC.TryStartNoGCRegion メソッドを呼び出して GC 領域の無待機モードを開始し、GC.EndNoGCRegion を呼び出して終了します。Instead, you call the GC.TryStartNoGCRegion method to begin the no GC region latency mode, and you call the GC.EndNoGCRegion to end it.

ガベージコレクションのランタイム構成設定が GCLatencyMode 列挙体の既定値に与える影響については、「待機時間モード」を参照してください。See Latency Modes for a discussion of how the runtime configuration settings for garbage collection affect the default value of the GCLatencyMode enumeration.

適用対象

こちらもご覧ください