OutOfMemoryException Clase

Definición

Excepción que se produce cuando no hay suficiente memoria para continuar con la ejecución de un programa.The exception that is thrown when there is not enough memory to continue the execution of a program.

public ref class OutOfMemoryException : SystemException
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public class OutOfMemoryException : SystemException
type OutOfMemoryException = class
    inherit SystemException
Public Class OutOfMemoryException
Inherits SystemException
Herencia
OutOfMemoryException
Derivado
Atributos

Comentarios

OutOfMemoryExceptionutiliza HRESULT COR_E_OUTOFMEMORY, que tiene el valor 0x8007000E.OutOfMemoryException uses the HRESULT COR_E_OUTOFMEMORY, which has the value 0x8007000E.

Para obtener una lista de valores de propiedad iniciales de una instancia de OutOfMemoryException, consulte el OutOfMemoryException constructores.For a list of initial property values for an instance of OutOfMemoryException, see the OutOfMemoryException constructors.

Nota

El valor de la propiedad Data heredada es nullsiempre.The value of the inherited Data property is always null.

Una OutOfMemoryException excepción tiene dos causas principales:An OutOfMemoryException exception has two major causes:

  • Está intentando expandir un StringBuilder objeto más allá de la longitud definida por su StringBuilder.MaxCapacity propiedad.You are attempting to expand a StringBuilder object beyond the length defined by its StringBuilder.MaxCapacity property.

  • El Common Language Runtime no puede asignar suficiente memoria contigua para realizar una operación correctamente.The common language runtime cannot allocate enough contiguous memory to successfully perform an operation. Esta excepción se puede producir en cualquier asignación de propiedad o llamada a método que requiera una asignación de memoria.This exception can be thrown by any property assignment or method call that requires a memory allocation. Para obtener más información sobre la causa de OutOfMemoryException la excepción, vea la entrada de blog "memoria insuficiente" no hace referencia a la memoria física.For more information on the cause of the OutOfMemoryException exception, see the blog post "Out of Memory" Does Not Refer to Physical Memory.

    Este tipo de OutOfMemoryException excepción representa un error catastrófico.This type of OutOfMemoryException exception represents a catastrophic failure. Si opta por controlar la excepción, debe incluir un catch bloque que Environment.FailFast llame al método para finalizar la aplicación y agregar una entrada al registro de eventos del sistema, como hace el siguiente ejemplo.If you choose to handle the exception, you should include a catch block that calls the Environment.FailFast method to terminate your app and add an entry to the system event log, as the following example does.

    using System;
    
    public class Example
    {
       public static void Main()
       {
          try {
             // Outer block to handle any unexpected exceptions.
             try {
                string s = "This";
                s = s.Insert(2, "is ");
    
                // Throw an OutOfMemoryException exception.
                throw new OutOfMemoryException();
             }
             catch (ArgumentException) {
                Console.WriteLine("ArgumentException in String.Insert");
             }
    
             // Execute program logic.
          }
          catch (OutOfMemoryException e) {
             Console.WriteLine("Terminating application unexpectedly...");
             Environment.FailFast(String.Format("Out of Memory: {0}",
                                                e.Message));
          }
       }
    }
    // The example displays the following output:
    //        Terminating application unexpectedly...
    
    Module Example
       Public Sub Main()
          Try
             ' Outer block to handle any unexpected exceptions.
             Try
                Dim s As String = "This"
                s = s.Insert(2, "is ")
    
                ' Throw an OutOfMemoryException exception.
                Throw New OutOfMemoryException()
             Catch e As ArgumentException
                Console.WriteLine("ArgumentException in String.Insert")
             End Try
             
             ' Execute program logic.
    
          Catch e As OutOfMemoryException
             Console.WriteLine("Terminating application unexpectedly...")
             Environment.FailFast(String.Format("Out of Memory: {0}",
                                                e.Message))
          End Try
       End Sub
    End Module
    ' The example displays the following output:
    '       Terminating application unexpectedly...
    

Algunas de las condiciones en las que se produce la excepción y las acciones que puede llevar a cabo para eliminarla son las siguientes:Some of the conditions under which the exception is thrown and the actions you can take to eliminate it include the following:

Está llamando al StringBuilder.Insert método.You are calling the StringBuilder.Insert method.

Está intentando aumentar la longitud de un StringBuilder objeto más allá del tamaño especificado por su StringBuilder.MaxCapacity propiedad.You are attempting to increase the length of a StringBuilder object beyond the size specified by its StringBuilder.MaxCapacity property. En el ejemplo siguiente se muestra OutOfMemoryException la excepción iniciada por una llamada StringBuilder.Insert(Int32, String, Int32) al método cuando el ejemplo intenta insertar una cadena que haría que la propiedad del Length objeto superara su capacidad máxima.The following example illustrates the OutOfMemoryException exception thrown by a call to the StringBuilder.Insert(Int32, String, Int32) method when the example tries to insert a string that would cause the object's Length property to exceed its maximum capacity.

using System;
using System.Text;

public class Example
{
   public static void Main()
   {
      StringBuilder sb = new StringBuilder(15, 15);
      sb.Append("Substring #1 ");
      try {
         sb.Insert(0, "Substring #2 ", 1);
      }
      catch (OutOfMemoryException e) {
         Console.WriteLine("Out of Memory: {0}", e.Message);
      }
   }
}
// The example displays the following output:
//    Out of Memory: Insufficient memory to continue the execution of the program.
Imports System.Text

Module Example
   Public Sub Main()
      Dim sb As New StringBuilder(15, 15)
      sb.Append("Substring #1 ")
      Try
         sb.Insert(0, "Substring #2 ", 1)
      Catch e As OutOfMemoryException
         Console.WriteLine("Out of Memory: {0}", e.Message)
      End Try
   End Sub
End Module
' The example displays the following output:
'   Out of Memory: Insufficient memory to continue the execution of the program.

Puede realizar una de las siguientes acciones para solucionar el error:You can do either of the following to address the error:

La aplicación se ejecuta como un proceso de 32 bits.Your app runs as a 32-bit process.

los procesos de 32 bits pueden asignar un máximo de 2 GB de memoria en modo de usuario virtual en sistemas de 32 bits y 4 GB de memoria virtual en modo de usuario en sistemas de 64 bits.32-bit processes can allocate a maximum of 2GB of virtual user-mode memory on 32-bit systems, and 4GB of virtual user-mode memory on 64-bit systems. Esto puede dificultar el Common Language Runtime de asignar suficiente memoria contigua cuando se necesita una asignación grande.This can make it more difficult for the common language runtime to allocate sufficient contiguous memory when a large allocation is needed. Por el contrario, los procesos de 64 bits pueden asignar hasta 8 TB de memoria virtual.In contrast, 64-bit processes can allocate up to 8TB of virtual memory. Para solucionar esta excepción, vuelva a compilar la aplicación para que tenga como destino una plataforma de 64 bits.To address this exception, recompile your app to target a 64-bit platform. Para obtener información sobre cómo establecer como destino plataformas específicas en Visual Studio, consulte Cómo: Configurar proyectos para plataformas de destino.For information on targeting specific platforms in Visual Studio, see How to: Configure Projects to Target Platforms.

La aplicación pierde recursos no administradosYour app is leaking unmanaged resources

Aunque el recolector de elementos no utilizados puede liberar memoria asignada a tipos administrados, no administra la memoria asignada a los recursos no administrados como los identificadores del sistema operativo (incluidos los identificadores de archivos, los archivos asignados a la memoria, las canalizaciones, las claves del registro y los identificadores de espera) y los bloques de memoria asignados directamente mediante llamadas a la API de Windows o llamadas a mallocfunciones de asignación de memoria como.Although the garbage collector is able to free memory allocated to managed types, it does not manage memory allocated to unmanaged resources such as operating system handles (including handles to files, memory-mapped files, pipes, registry keys, and wait handles) and memory blocks allocated directly by Windows API calls or by calls to memory allocation functions such as malloc. Los tipos que utilizan recursos no administrados implementan la IDisposable interfaz.Types that consume unmanaged resources implement the IDisposable interface.

Si está consumiendo un tipo que usa recursos no administrados, debe asegurarse de llamar a su IDisposable.Dispose método cuando haya terminado de usarlo.If you are consuming a type that uses unmanaged resources, you should be sure to call its IDisposable.Dispose method when you have finished using it. (Algunos tipos también implementan Close un método que es idéntico en función a Dispose un método). Para obtener más información, vea el tema uso de objetos que implementan IDisposable .(Some types also implement a Close method that is identical in function to a Dispose method.) For more information, see the Using Objects That Implement IDisposable topic.

Si ha creado un tipo que usa recursos no administrados, asegúrese de que ha implementado el patrón de Dispose y, si es necesario, proporcionó un finalizador.If you have created a type that uses unmanaged resources, make sure that you have implemented the Dispose pattern and, if necessary, supplied a finalizer. Para obtener más información, vea implementar un método Dispose y Object.Finalize.For more information, see Implementing a Dispose method and Object.Finalize.

Está intentando crear una matriz grande en un proceso de 64 bitsYou are attempting to create a large array in a 64-bit process

De forma predeterminada, el Common Language Runtime en .NET Framework no permite objetos únicos cuyo tamaño supere los 2 GB.By default, the common language runtime in .NET Framework does not allow single objects whose size exceeds 2GB. Para invalidar este valor predeterminado, puede usar < la configuración del archivo de configuración gcAllowVeryLargeObjects > para habilitar matrices cuyo tamaño total sea superior a 2 GB.To override this default, you can use the <gcAllowVeryLargeObjects> configuration file setting to enable arrays whose total size exceeds 2 GB. En .NET Core, la compatibilidad con matrices de más de 2 GB está habilitada de forma predeterminada.On .NET Core, support for arrays of greater than 2 GB is enabled by default.

Está trabajando con conjuntos de datos muy grandes (como matrices, colecciones o conjuntos de datos de base de datos) en memoria.You are working with very large sets of data (such as arrays, collections, or database data sets) in memory.

Cuando las estructuras de datos o los conjuntos de datos que residen en la memoria se hacen tan grandes que el Common Language Runtime no puede asignar suficiente memoria OutOfMemoryException contigua para ellos, se produce una excepción.When data structures or data sets that reside in memory become so large that the common language runtime is unable to allocate enough contiguous memory for them, an OutOfMemoryException exception results.

Para evitar las OutOfMemoryException excepciones, debe modificar la aplicación para que haya menos datos residentes en la memoria o los datos se divida en segmentos que requieran asignaciones de memoria más pequeñas.To prevent the OutOfMemoryException exceptions, you must modify your application so that less data is resident in memory, or the data is divided into segments that require smaller memory allocations. Por ejemplo:For example:

  • Si está recuperando todos los datos de una base de datos y, a continuación, los filtra en la aplicación para minimizar la ida y vuelta al servidor, debe modificar las consultas para que devuelvan solo el subconjunto de datos que necesita la aplicación.If you are retrieving all of the data from a database and then filtering it in your app to minimize trips to the server, you should modify your queries to return only the subset of data that your app needs. Al trabajar con tablas de gran tamaño, es casi siempre más eficaz usar varias consultas que recuperar todos los datos de una sola tabla y, a continuación, manipularla.When working with large tables, multiple queries are almost always more efficient than retrieving all of the data in a single table and then manipulating it.

  • Si está ejecutando consultas que los usuarios crean dinámicamente, debe asegurarse de que el número de registros devueltos por la consulta es limitado.If you are executing queries that users create dynamically, you should ensure that the number of records returned by the query is limited.

  • Si usa matrices grandes u otros objetos de colección cuyo tamaño da como resultado una OutOfMemoryException excepción, debe modificar la aplicación para que funcione con los datos de los subconjuntos en lugar de trabajar con ellos todos a la vez.If you are using large arrays or other collection objects whose size results in an OutOfMemoryException exception, you should modify your application to work the data in subsets rather than to work with it all at once.

En el ejemplo siguiente se obtiene una matriz formada por valores de punto flotante 200 millones y, a continuación, se calcula su media.The following example gets a array that consists of 200 million floating-point values and then calculates their mean. En el resultado del ejemplo se muestra que, dado que en el ejemplo se almacena toda la matriz en memoria antes de calcular la OutOfMemoryException media, se produce una excepción.The output from the example shows that, because the example stores the entire array in memory before it calculates the mean, an OutOfMemoryException is thrown.

using System;
using System.Collections.Generic;

public class Example
{
   public static void Main()
   {
      Double[] values = GetData();
      // Compute mean.
      Console.WriteLine("Sample mean: {0}, N = {1}",
                        GetMean(values), values.Length);
   }

   private static Double[] GetData()
   {
      Random rnd = new Random();
      List<Double> values = new List<Double>();
      for (int ctr = 1; ctr <= 200000000; ctr++) {
         values.Add(rnd.NextDouble());
         if (ctr % 10000000 == 0)
            Console.WriteLine("Retrieved {0:N0} items of data.",
                              ctr);
      }
      return values.ToArray();
   }

   private static Double GetMean(Double[] values)
   {
      Double sum = 0;
      foreach (var value in values)
         sum += value;

      return sum / values.Length;
   }
}
// The example displays output like the following:
//    Retrieved 10,000,000 items of data.
//    Retrieved 20,000,000 items of data.
//    Retrieved 30,000,000 items of data.
//    Retrieved 40,000,000 items of data.
//    Retrieved 50,000,000 items of data.
//    Retrieved 60,000,000 items of data.
//    Retrieved 70,000,000 items of data.
//    Retrieved 80,000,000 items of data.
//    Retrieved 90,000,000 items of data.
//    Retrieved 100,000,000 items of data.
//    Retrieved 110,000,000 items of data.
//    Retrieved 120,000,000 items of data.
//    Retrieved 130,000,000 items of data.
//
//    Unhandled Exception: OutOfMemoryException.
Imports System.Collections.Generic

Module Example
   Public Sub Main()
      Dim values() As Double = GetData()
      ' Compute mean.
      Console.WriteLine("Sample mean: {0}, N = {1}",
                        GetMean(values), values.Length)
   End Sub
   
   Private Function GetData() As Double()
      Dim rnd As New Random()
      Dim values As New List(Of Double)()
      For ctr As Integer = 1 To 200000000
         values.Add(rnd.NextDouble)
         If ctr Mod 10000000 = 0 Then
            Console.WriteLine("Retrieved {0:N0} items of data.",
                              ctr)
         End If
      Next
      Return values.ToArray()
   End Function
   
   Private Function GetMean(values() As Double) As Double
      Dim sum As Double = 0
      For Each value In values
         sum += value
      Next
      Return sum / values.Length
   End Function
End Module
' The example displays output like the following:
'    Retrieved 10,000,000 items of data.
'    Retrieved 20,000,000 items of data.
'    Retrieved 30,000,000 items of data.
'    Retrieved 40,000,000 items of data.
'    Retrieved 50,000,000 items of data.
'    Retrieved 60,000,000 items of data.
'    Retrieved 70,000,000 items of data.
'    Retrieved 80,000,000 items of data.
'    Retrieved 90,000,000 items of data.
'    Retrieved 100,000,000 items of data.
'    Retrieved 110,000,000 items of data.
'    Retrieved 120,000,000 items of data.
'    Retrieved 130,000,000 items of data.
'
'    Unhandled Exception: OutOfMemoryException.

En el siguiente ejemplo se OutOfMemoryException elimina la excepción al procesar los datos entrantes sin almacenar todo el conjunto de datos en memoria, serializando los datos en un archivo si es necesario para permitir el procesamiento posterior (estas líneas están comentadas en el ejemplo, como en este caso generan un archivo cuyo tamaño es mayor que 1 GB, y devuelven la media calculada y el número de casos a la rutina de llamada.The following example eliminates the OutOfMemoryException exception by processing the incoming data without storing the entire data set in memory, serializing the data to a file if necessary to permit further processing (these lines are commented out in the example, since in this case they produce a file whose size is greater than 1GB), and returning the calculated mean and the number of cases to the calling routine.

using System;
using System.IO;

public class Example
{
   public static void Main()
   {
      Tuple<Double, long> result = GetResult();
      Console.WriteLine("Sample mean: {0}, N = {1:N0}",
                        result.Item1, result.Item2);
   }

   private static Tuple<Double, long> GetResult()
   {
      int chunkSize = 50000000;
      int nToGet = 200000000;
      Random rnd = new Random();
      // FileStream fs = new FileStream(@".\data.bin", FileMode.Create);
      // BinaryWriter bin = new BinaryWriter(fs);
      // bin.Write((int)0);
      int n = 0;
      Double sum = 0;
      for (int outer = 0;
           outer <= ((int) Math.Ceiling(nToGet * 1.0 / chunkSize) - 1);
           outer++) {
         for (int inner = 0;
              inner <= Math.Min(nToGet - n - 1, chunkSize - 1);
              inner++) {
            Double value = rnd.NextDouble();
            sum += value;
            n++;
            // bin.Write(value);
         }
      }
      // bin.Seek(0, SeekOrigin.Begin);
      // bin.Write(n);
      // bin.Close();
      return new Tuple<Double, long>(sum/n, n);
   }
}
// The example displays output like the following:
//    Sample mean: 0.500022771458399, N = 200,000,000
Imports System.IO

Module Example
   Public Sub Main()
      Dim result As Tuple(Of Double, Long) = GetResult()
      Console.WriteLine("Sample mean: {0}, N = {1:N0}",
                        result.Item1, result.Item2)
   End Sub

   Private Function GetResult As Tuple(Of Double, Long)
      Dim chunkSize As Integer = 50000000
      Dim nToGet As Integer = 200000000
      Dim rnd As New Random()
'       Dim fs As New FileStream(".\data.bin", FileMode.Create)
'       Dim bin As New BinaryWriter(fs)
'       bin.Write(CInt(0))
      Dim n As Integer
      Dim sum As Double
      For outer As Integer = 0 To CInt(Math.Ceiling(nToGet/chunkSize) - 1)
         For inner = 0 To Math.Min(nToGet - n - 1, chunkSize - 1)
            Dim value As Double = rnd.NextDouble()
            sum += value
            n += 1
'            bin.Write(value)
         Next
      Next
'       bin.Seek(0, SeekOrigin.Begin)
'       bin.Write(n)
'       bin.Close()
      Return New Tuple(Of Double, Long)(sum/n, n)
   End Function
End Module
' The example displays output like the following:
'   Sample mean: 0.500022771458399, N = 200,000,000

Se concatenan repetidamente cadenas de gran tamaño.You are repeatedly concatenating large strings.

Dado que las cadenas son inmutables, cada operación de concatenación de cadenas crea una nueva cadena.Because strings are immutable, each string concatenation operation creates a new string. El impacto de las cadenas pequeñas o de un número reducido de operaciones de concatenación es insignificante.The impact for small strings, or for a small number of concatenation operations, is negligible. Pero para las cadenas grandes o un gran número de operaciones de concatenación, la concatenación de cadenas puede conducir a un gran número de asignaciones de memoria y fragmentación de memoria, un rendimiento OutOfMemoryException deficiente y, posiblemente, excepciones.But for large strings or a very large number of concatenation operations, string concatenation can lead to a large number of memory allocations and memory fragmentation, poor performance, and possibly OutOfMemoryException exceptions.

Al concatenar cadenas grandes o realizar un gran número de operaciones de concatenación, debe utilizar la StringBuilder clase en lugar de la String clase.When concatenating large strings or performing a large number of concatenation operations, you should use the StringBuilder class instead of the String class. Cuando haya terminado de manipular la cadena, convierta la StringBuilder instancia en una cadena llamando al StringBuilder.ToString método.When you have finished manipulating the string, convert the StringBuilder instance to a string by calling the StringBuilder.ToString method.

Puede anclar un gran número de objetos en la memoria.You pin a large number of objects in memory.

Anclar un gran número de objetos en memoria durante períodos largos puede dificultar que el recolector de elementos no utilizados asigne bloques de memoria contiguos.Pinning a large number of objects in memory for long periods can make it difficult for the garbage collector to allocate contiguous blocks of memory. Si ha anclado un gran número de objetos en la memoria, por ejemplo, mediante fixed la instrucción C# de o llamando al GCHandle.Alloc(Object, GCHandleType) método con un tipo de identificador GCHandleType.Pinnedde, puede hacer lo siguiente para solucionar la OutOfMemoryException excepción.If you've pinned a large number of objects in memory, for example by using the fixed statement in C# or by calling the GCHandle.Alloc(Object, GCHandleType) method with a handle type of GCHandleType.Pinned, you can do the following to address the OutOfMemoryException exception.

  • Evalúe si es realmente necesario anclar cada objeto,Evaluate whether each object really needs to be pinned,

  • Asegúrese de que cada objeto se desancla lo antes posible.Ensure that each object is unpinned as soon as possible.

  • Asegúrese de que cada llamada al GCHandle.Alloc(Object, GCHandleType) método para anclar memoria tiene una llamada correspondiente GCHandle.Free al método para desanclar esa memoria.Make sure that each call to the GCHandle.Alloc(Object, GCHandleType) method to pin memory has a corresponding call to the GCHandle.Free method to unpin that memory.

Las siguientes instrucciones de Microsoft intermediate (MSIL) producen OutOfMemoryException una excepción:The following Microsoft intermediate (MSIL) instructions throw an OutOfMemoryException exception:

Constructores

OutOfMemoryException()

Inicializa una nueva instancia de la clase OutOfMemoryException.Initializes a new instance of the OutOfMemoryException class.

OutOfMemoryException(SerializationInfo, StreamingContext)

Inicializa una nueva instancia de la clase OutOfMemoryException con datos serializados.Initializes a new instance of the OutOfMemoryException class with serialized data.

OutOfMemoryException(String)

Inicializa una nueva instancia de la clase OutOfMemoryException con el mensaje de error especificado.Initializes a new instance of the OutOfMemoryException class with a specified error message.

OutOfMemoryException(String, Exception)

Inicializa una nueva instancia de la clase OutOfMemoryException con el mensaje de error especificado y una referencia a la excepción interna que representa la causa de esta excepción.Initializes a new instance of the OutOfMemoryException class with a specified error message and a reference to the inner exception that is the cause of this exception.

Propiedades

Data

Obtiene una colección de pares clave-valor que proporcionan más información definida por el usuario sobre la excepción.Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Heredado de Exception)
HelpLink

Obtiene o establece un vínculo al archivo de ayuda asociado a esta excepción.Gets or sets a link to the help file associated with this exception.

(Heredado de Exception)
HResult

Obtiene o establece HRESULT, un valor numérico codificado que se asigna a una excepción específica.Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Heredado de Exception)
InnerException

Obtiene la instancia Exception que produjo la excepción actual.Gets the Exception instance that caused the current exception.

(Heredado de Exception)
Message

Obtiene un mensaje que describe la excepción actual.Gets a message that describes the current exception.

(Heredado de Exception)
Source

Devuelve o establece el nombre de la aplicación o del objeto que generó el error.Gets or sets the name of the application or the object that causes the error.

(Heredado de Exception)
StackTrace

Obtiene una representación de cadena de los marcos inmediatos en la pila de llamadas.Gets a string representation of the immediate frames on the call stack.

(Heredado de Exception)
TargetSite

Obtiene el método que produjo la excepción actual.Gets the method that throws the current exception.

(Heredado de Exception)

Métodos

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetBaseException()

Cuando se reemplaza en una clase derivada, devuelve la clase Exception que representa la causa principal de una o más excepciones posteriores.When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(Heredado de Exception)
GetHashCode()

Sirve como función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetObjectData(SerializationInfo, StreamingContext)

Cuando se reemplaza en una clase derivada, establece SerializationInfo con información sobre la excepción.When overridden in a derived class, sets the SerializationInfo with information about the exception.

(Heredado de Exception)
GetType()

Obtiene el tipo de tiempo de ejecución de la instancia actual.Gets the runtime type of the current instance.

(Heredado de Exception)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
ToString()

Crea y devuelve una representación de cadena de la excepción actual.Creates and returns a string representation of the current exception.

(Heredado de Exception)

Eventos

SerializeObjectState

Ocurre cuando una excepción se serializa para crear un objeto de estado de excepción que contenga datos serializados sobre la excepción.Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Heredado de Exception)

Se aplica a

Consulte también: