GC.Collect メソッド (Int32)
ジェネレーション 0 から指定ジェネレーションまでのガベージ コレクションを強制的に行います。
Overloads Public Shared Sub Collect( _
ByVal generation As Integer _)
[C#]
public static void Collect(intgeneration);
[C++]
public: static void Collect(intgeneration);
[JScript]
public static function Collect(
generation : int);
パラメータ
- generation
ガベージ コレクションの対象となる最大番号のジェネレーション。
例外
| 例外の種類 | 条件 |
|---|---|
| ArgumentOutOfRangeException | generation が 0 未満か、存在するジェネレーションの数を超えています。 |
解説
このメソッドを使用して、アクセスできないメモリの収集を試みます。ただし、指定したジェネレーション内のアクセスできないすべてのメモリが収集されることは保証していません。
オブジェクトの世代が実装されている場合、ガベージ コレクタは、指定したジェネレーションよりも番号が大きいジェネレーションのオブジェクトは収集しません。オブジェクトの世代が実装されていない場合、ガベージ コレクタは、ガベージ コレクション実行中にすべてのオブジェクトを収集対象にします。
MaxGeneration プロパティを使用して、 generation の最大有効値を確認します。
ジェネレーションに関係なくすべてのオブジェクトをガベージ コレクタの収集対象にするには、引数をとらないこのバージョンのメソッドを使用します。
使用例
Imports System
Namespace GCCollectInt_Example
Class MyGCCollectClass
Private maxGarbage As Long = 10000
Public Shared Sub Main()
Dim myGCCol As New MyGCCollectClass
'Determine the maximum number of generations the system
'garbage collector currently supports.
Console.WriteLine("The highest generation is {0}", GC.MaxGeneration)
myGCCol.MakeSomeGarbage()
'Determine which generation myGCCol object is stored in.
Console.WriteLine("Generation: {0}", GC.GetGeneration(myGCCol))
'Determine the best available approximation of the number
'of bytes currently allocated in managed memory.
Console.WriteLine("Total Memory: {0}", GC.GetTotalMemory(False))
'Perform a collection of generation 0 only.
GC.Collect(0)
'Determine which generation myGCCol object is stored in.
Console.WriteLine("Generation: {0}", GC.GetGeneration(myGCCol))
Console.WriteLine("Total Memory: {0}", GC.GetTotalMemory(False))
'Perform a collection of generation 2 only.
GC.Collect(2)
'Determine which generation myGCCol object is stored in.
Console.WriteLine("Generation: {0}", GC.GetGeneration(myGCCol))
Console.WriteLine("Total Memory: {0}", GC.GetTotalMemory(False))
Console.Read()
End Sub
Sub MakeSomeGarbage()
Dim vt As Version
Dim i As Integer
For i = 0 To maxGarbage - 1
'Create objects and release them to fill up memory
'with unused objects.
vt = New Version
Next i
End Sub
End Class
End Namespace
[C#]
using System;
namespace GCCollectIntExample
{
class MyGCCollectClass
{
private const long maxGarbage = 1000;
static void Main()
{
MyGCCollectClass myGCCol = new MyGCCollectClass();
// Determine the maximum number of generations the system
// garbage collector currently supports.
Console.WriteLine("The highest generation is {0}", GC.MaxGeneration);
myGCCol.MakeSomeGarbage();
// Determine which generation myGCCol object is stored in.
Console.WriteLine("Generation: {0}", GC.GetGeneration(myGCCol));
// Determine the best available approximation of the number
// of bytes currently allocated in managed memory.
Console.WriteLine("Total Memory: {0}", GC.GetTotalMemory(false));
// Perform a collection of generation 0 only.
GC.Collect(0);
// Determine which generation myGCCol object is stored in.
Console.WriteLine("Generation: {0}", GC.GetGeneration(myGCCol));
Console.WriteLine("Total Memory: {0}", GC.GetTotalMemory(false));
// Perform a collection of generation 2 only.
GC.Collect(2);
// Determine which generation myGCCol object is stored in.
Console.WriteLine("Generation: {0}", GC.GetGeneration(myGCCol));
Console.WriteLine("Total Memory: {0}", GC.GetTotalMemory(false));
Console.Read();
}
void MakeSomeGarbage()
{
Version vt;
for(int i = 0; i < maxGarbage; i++)
{
// Create objects and release them to fill up memory
// with unused objects.
vt = new Version();
}
}
}
}
[C++]
#using <mscorlib.dll>
using namespace System;
const long maxGarbage = 1000;
__gc class MyGCCollectClass {
public:
void MakeSomeGarbage() {
Version* vt;
for (int i = 0; i < maxGarbage; i++) {
// Create objects and release them to fill up memory
// with unused objects.
vt = new Version();
}
}
};
int main() {
MyGCCollectClass* myGCCol = new MyGCCollectClass();
// Determine the maximum number of generations the system
// garbage collector currently supports.
Console::WriteLine(S"The highest generation is {0}", __box(GC::MaxGeneration));
myGCCol->MakeSomeGarbage();
// Determine which generation myGCCol object is stored in.
Console::WriteLine(S"Generation: {0}", __box(GC::GetGeneration(myGCCol)));
// Determine the best available approximation of the number
// of bytes currently allocated in managed memory.
Console::WriteLine(S"Total Memory: {0}", __box(GC::GetTotalMemory(false)));
// Perform a collection of generation 0 only.
GC::Collect(0);
// Determine which generation myGCCol object is stored in.
Console::WriteLine(S"Generation: {0}", __box(GC::GetGeneration(myGCCol)));
Console::WriteLine(S"Total Memory: {0}", __box(GC::GetTotalMemory(false)));
// Perform a collection of generation 2 only.
GC::Collect(2);
// Determine which generation myGCCol object is stored in.
Console::WriteLine(S"Generation: {0}", __box(GC::GetGeneration(myGCCol)));
Console::WriteLine(S"Total Memory: {0}", __box(GC::GetTotalMemory(false)));
}
[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン .gif)
をクリックします。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ