MemoryFailPoint クラスとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

MemoryFailPoint クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

実行前に十分なメモリリソースがあるかどうかをチェックします。このクラスは継承できません。

名前空間: System.Runtime
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 MemoryFailPoint
    Inherits CriticalFinalizerObject
    Implements IDisposable

Visual Basic (使用法)

Dim instance As MemoryFailPoint

public sealed class MemoryFailPoint : CriticalFinalizerObject,
 IDisposable

C++

public ref class MemoryFailPoint sealed : public
 CriticalFinalizerObject, IDisposable

public final class MemoryFailPoint extends
 CriticalFinalizerObject implements IDisposable

JScript

public final class MemoryFailPoint extends
 CriticalFinalizerObject implements IDisposable

解説

メモ
このクラスは、拡張開発での使用を前提としています。

MemoryFailPoint クラスのインスタンスを作成すると、メモリゲートが作成されます。メモリゲートとは、大量のメモリを必要とするアクティビティを開始する前に、十分なリソースがあるかどうかをチェックすることです。チェックに合格しなかった場合、操作を開始できないようにする InsufficientMemoryException がスローされるため、リソース不足が原因となってアプリケーションが実行中に失敗する可能性が減少します。これにより、アプリケーションでは、パフォーマンスを低下させ、OutOfMemoryException や、コード内の任意の場所で OutOfMemoryException を誤って処理したことが原因で発生する状態の破損を避けることができます。

InsufficientMemoryException をスローすることにより、操作を完了できそうにないという回復可能である予測と、部分的に完了済みの操作で発生した、状態破損の可能性のある OutOfMemoryException とをアプリケーションで識別できます。これにより、アプリケーションは、現在の AppDomain のアンロードやプロセスのリサイクルが必要となる可能性のあるペシミスティック発生ポリシーの頻度を減らすことができます。

MemoryFailPoint は、すべてのガベージコレクションヒープで十分なメモリと連続した仮想アドレス空間が利用できるかどうかをチェックし、必要に応じてスワップファイルのサイズを大きくします。MemoryFailPoint は、ゲートの有効期間中にメモリが長期にわたって使用できるかどうかについては保証しませんが、呼び出し元は常に Dispose を呼び出して、MemoryFailPoint に関連付けられたリソースを解放する必要があります。

メモリゲートを使用するには、操作で使用が想定されるメモリのメガバイト数を指定して、MemoryFailPoint オブジェクトを作成する必要があります。十分なメモリを使用できない場合は、InsufficientMemoryException が発生します。

コンストラクタのパラメータは正の整数である必要があります。負の値であると、ArgumentOutOfRangeException が発生します。

使用例

MemoryFailPoint は、メモリの不足による破損を防ぐために、アプリケーションが自身の処理速度を低下させることができるようにデザインされています。これは、構文のスコープ内で使用する必要があります。作業キュー内の項目を処理するためにスレッドを開始するコード例を次に示します。各スレッドを開始する前に、MemoryFailPoint を使用して、利用できるメモリリソースをチェックします。例外がスローされた場合、メインメソッドはメモリが使用できるようになるのを待って、次のスレッドを開始します。

using System;
using System.Runtime;
using System.IO;
using System.Threading;
using System.Collections.Generic;
using System.Collections;

class MemoryFailPointExample
{
    // Allocate in chunks of 64 megabytes.
    private const uint chunkSize = 64 <<
 20;
    // Use more than the total user-available address space (on 32 bit
 machines)
    // to drive towards getting an InsufficientMemoryException.
    private const uint numWorkItems = 1 + ((1U
 << 31) / chunkSize);
    static Queue workQueue = new Queue(50);

    // This value can be computed separately and hard-coded into the
 application.
    // The method is included to illustrate the technique.
    private static int EstimateMemoryUsageInMB()
    {
        int memUsageInMB = 0;

        long memBefore = GC.GetTotalMemory(true);
        int numGen0Collections = GC.CollectionCount(0);
        // Execute a test version of the method to estimate memory requirements.
        // This test method only exists to determine the memory requirements.
        ThreadMethod();
        // Includes garbage generated by the worker function.
        long memAfter = GC.GetTotalMemory(false);
        // If a garbage collection occurs during the measuring, you
 might need a greater memory requirement.
        Console.WriteLine("Did a GC occur while measuring?
  {0}", numGen0Collections == GC.CollectionCount(0));
        // Set the field used as the parameter for the MemoryFailPoint
 constructor.
        long memUsage = (memAfter - memBefore);
        if (memUsage < 0)
        {
            Console.WriteLine("GC's occurred while measuring
 memory usage.  Try measuring again.");
            memUsage = 1 << 20;
        }

        // Round up to the nearest MB.
        memUsageInMB = (int)(1 + (memUsage >> 20));
        Console.WriteLine("Memory usage estimate: {0} bytes, rounded to {1}
 MB", memUsage, memUsageInMB);
        return memUsageInMB;
    }

    static void Main()
    {
        Console.WriteLine("Attempts to allocate more than 2 GB of memory across
 worker threads.");
        int memUsageInMB = EstimateMemoryUsageInMB();

        // For a production application consider using the threadpool
 instead.
        Thread[] threads = new Thread[numWorkItems];
        // Create a work queue to be processed by multiple threads.
        int n = 0;
        for (n = 0; n < numWorkItems; n++)
            workQueue.Enqueue(n);
        // Continue to launch threads until the work queue is empty.
        while (workQueue.Count > 0)
        {
            Console.WriteLine(" GC heap (live + garbage): {0} MB", GC.GetTotalMemory(false)
 >> 20);
            MemoryFailPoint memFailPoint = null;
            try
            {
                // Check for available memory.
                memFailPoint = new MemoryFailPoint(memUsageInMB);
                n = (int)workQueue.Dequeue();
                threads[n] =
                    new Thread(new ParameterizedThreadStart(ThreadMethod));
                WorkerState state = new WorkerState(n, memFailPoint);
                threads[n].Start(state);
                Thread.Sleep(10);
            }
            catch (InsufficientMemoryException e)
            {
                // MemoryFailPoint threw an exception, handle by sleeping
 for a while,  then 
                // continue processing the queue.
                Console.WriteLine("Expected InsufficientMemoryException thrown.
  Message: " + e.Message);
                // We could optionally sleep until a running worker
 thread 
                // has finished, like this:  threads[joinCount++].Join();
                Thread.Sleep(1000);
            }
        }

        Console.WriteLine("WorkQueue is empty - blocking to ensure all threads
 quit (each thread sleeps for 10 seconds)");
        foreach (Thread t in threads)
            t.Join();
        Console.WriteLine("All worker threads are finished - exiting application.");
    }

    // Test version of the working code to determine memory requirements.
    static void ThreadMethod()
    {
        byte[] bytes = new byte[chunkSize];
    }

    internal class WorkerState
    {
        internal int _threadNumber;
        internal MemoryFailPoint _memFailPoint;

        internal WorkerState(int threadNumber, MemoryFailPoint
 memoryFailPoint)
        {
            _threadNumber = threadNumber;
            _memFailPoint = memoryFailPoint;
        }

        internal int ThreadNumber
        {
            get { return _threadNumber; }
        }

        internal MemoryFailPoint MemoryFailPoint
        {
            get { return _memFailPoint; }
        }
    }

    // The method that does the work.
    static void ThreadMethod(Object o)
    {
        WorkerState state = (WorkerState)o;
        Console.WriteLine("Executing ThreadMethod, " +
            "thread number {0}.", state.ThreadNumber);
        byte[] bytes = null;
        try
        {
            bytes = new byte[chunkSize];
            // Allocated all the memory needed for this workitem.
            // Now dispose of the MemoryFailPoint, then process the
 workitem.
            state.MemoryFailPoint.Dispose();
        }
        catch (OutOfMemoryException oom)
        {
            Console.Beep();
            Console.WriteLine("Unexpected OutOfMemory exception thrown: "
 + oom);
        }

        // Do work here, possibly taking a lock if this app needs 
        // synchronization between worker threads and/or the main thread.

        // Keep the thread alive for awhile to simulate a running thread.
        Thread.Sleep(10000);

        // A real thread would use the byte[], but to be an illustrative
 sample,
        // explicitly keep the byte[] alive to help exhaust the memory.
        GC.KeepAlive(bytes);
        Console.WriteLine("Thread {0} is finished.", state.ThreadNumber);

    }
}

.NET Framework のセキュリティ

SecurityPermission (アンマネージコードを呼び出すために必要なアクセス許可)。要求値 : LinkDemand。SecurityPermissionFlag.UnmanagedCode (関連する列挙体)

継承階層

System.Object
System.Runtime.ConstrainedExecution.CriticalFinalizerObject
System.Runtime.MemoryFailPoint

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
MemoryFailPoint メンバ
System.Runtime 名前空間

このページでは「.NET Framework クラスライブラリリファレンス」からMemoryFailPoint クラスを検索した結果を表示しています。
Weblioに収録されているすべての辞書からMemoryFailPoint クラスを検索する場合は、下記のリンクをクリックしてください。

全ての辞書からMemoryFailPoint クラスを検索

>> 「MemoryFailPoint クラス」を含む用語の索引
MemoryFailPoint クラスのページへのリンク

MemoryFailPoint クラスとは？わかりやすく解説

MemoryFailPoint クラス

「MemoryFailPoint クラス」の関連用語


	© 2025 Microsoft.All rights reserved.

MemoryFailPoint クラスとは？ わかりやすく解説

MemoryFailPoint クラス

急上昇のことば

「MemoryFailPoint クラス」の関連用語

MemoryFailPoint クラスとは？わかりやすく解説