Class Cache
Class Cache
Namespace: Aspose.Imaging
Assembly: Aspose.Imaging.dll (25.2.0)
Contient les paramètres de cache.
public static class CacheHéritage
Membres hérités
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Exemples
Cet exemple démontre l’utilisation de Aspose.Imaging.Cache```csharp [C#]
// Par défaut, le dossier de cache est défini sur le répertoire temporaire local de l'utilisateur.
// Vous pouvez également spécifier un autre dossier de cache que le défaut comme suit :
// Cache.CacheFolder = @"D:\\MyTemp";
// Le mode automatique est flexible et efficace
Aspose.Imaging.Cache.CacheType = Aspose.Imaging.CacheType.Auto;
// La valeur par défaut est 0, ce qui signifie qu'il n'y a pas de limite supérieure
Aspose.Imaging.Cache.MaxDiskSpaceForCache = 1073741824; // 1 gigaoctet
Aspose.Imaging.Cache.MaxMemoryForCache = 1073741824; // 1 gigaoctet
// Il n'est pas recommandé de modifier la propriété suivante car cela peut grandement affecter les performances
Aspose.Imaging.Cache.ExactReallocateOnly = false;
// À tout moment, vous pouvez vérifier combien d'octets sont actuellement alloués pour la mémoire ou le disque
// cache en examinant les propriétés suivantes
long l1 = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
long l2 = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;
// Effectuez un traitement d'image comme ci-dessous
Aspose.Imaging.ImageOptions.GifOptions options = new Aspose.Imaging.ImageOptions.GifOptions();
options.Palette = new ColorPalette(new Aspose.Imaging.Color[] { Aspose.Imaging.Color.Red, Aspose.Imaging.Color.Blue, Aspose.Imaging.Color.Black, Aspose.Imaging.Color.White });
options.Source = new Aspose.Imaging.Sources.StreamSource(new System.IO.MemoryStream(), true);
using (Aspose.Imaging.RasterImage image = (Aspose.Imaging.RasterImage)Aspose.Imaging.Image.Create(options, 100, 100))
{
Aspose.Imaging.Color[] pixels = new Aspose.Imaging.Color[10000];
for (int i = 0; i < pixels.Length; i++)
{
pixels[i] = Aspose.Imaging.Color.White;
}
image.SavePixels(image.Bounds, pixels);
// après l'exécution du code ci-dessus, 40000 octets seront alloués en mémoire.
long diskBytes = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
long memoryBytes = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;
}
// Les propriétés d'allocation peuvent être utilisées pour vérifier si tous les objets Aspose.Imaging ont été correctement disposés.
// Si vous avez oublié d'appeler dispose sur un objet, les valeurs de cache seront différentes de 0.
l1 = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
l2 = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;
## Propriétés
### <a id="Aspose_Imaging_Cache_AllocatedDiskBytesCount"></a> AllocatedDiskBytesCount
Obtient le nombre d'octets de disque alloués.
```csharp
public static long AllocatedDiskBytesCount { get; }Valeur de la propriété
Exemples
Cet exemple démontre l’utilisation de Aspose.Imaging.Cache```csharp [C#]
// Par défaut, le dossier de cache est défini sur le répertoire temporaire local de l'utilisateur.
// Vous pouvez également spécifier un autre dossier de cache que le défaut comme suit :
// Cache.CacheFolder = @"D:\\MyTemp";
// Le mode automatique est flexible et efficace
Aspose.Imaging.Cache.CacheType = Aspose.Imaging.CacheType.Auto;
// La valeur par défaut est 0, ce qui signifie qu'il n'y a pas de limite supérieure
Aspose.Imaging.Cache.MaxDiskSpaceForCache = 1073741824; // 1 gigaoctet
Aspose.Imaging.Cache.MaxMemoryForCache = 1073741824; // 1 gigaoctet
// Il n'est pas recommandé de modifier la propriété suivante car cela peut grandement affecter les performances
Aspose.Imaging.Cache.ExactReallocateOnly = false;
// À tout moment, vous pouvez vérifier combien d'octets sont actuellement alloués pour la mémoire ou le disque
// cache en examinant les propriétés suivantes
long l1 = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
long l2 = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;
// Effectuez un traitement d'image comme ci-dessous
Aspose.Imaging.ImageOptions.GifOptions options = new Aspose.Imaging.ImageOptions.GifOptions();
options.Palette = new ColorPalette(new Aspose.Imaging.Color[] { Aspose.Imaging.Color.Red, Aspose.Imaging.Color.Blue, Aspose.Imaging.Color.Black, Aspose.Imaging.Color.White });
options.Source = new Aspose.Imaging.Sources.StreamSource(new System.IO.MemoryStream(), true);
using (Aspose.Imaging.RasterImage image = (Aspose.Imaging.RasterImage)Aspose.Imaging.Image.Create(options, 100, 100))
{
Aspose.Imaging.Color[] pixels = new Aspose.Imaging.Color[10000];
for (int i = 0; i < pixels.Length; i++)
{
pixels[i] = Aspose.Imaging.Color.White;
}
image.SavePixels(image.Bounds, pixels);
// après l'exécution du code ci-dessus, 40000 octets seront alloués en mémoire.
long diskBytes = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
long memoryBytes = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;
}
// Les propriétés d'allocation peuvent être utilisées pour vérifier si tous les objets Aspose.Imaging ont été correctement disposés.
// Si vous avez oublié d'appeler dispose sur un objet, les valeurs de cache seront différentes de 0.
l1 = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
l2 = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;
### <a id="Aspose_Imaging_Cache_AllocatedMemoryBytesCount"></a> AllocatedMemoryBytesCount
Obtient le nombre d'octets alloués en mémoire.
```csharp
public static long AllocatedMemoryBytesCount { get; }Valeur de la propriété
Exemples
Cet exemple démontre l’utilisation de Aspose.Imaging.Cache```csharp [C#]
// Par défaut, le dossier de cache est défini sur le répertoire temporaire local de l'utilisateur.
// Vous pouvez également spécifier un autre dossier de cache que le défaut comme suit :
// Cache.CacheFolder = @"D:\\MyTemp";
// Le mode automatique est flexible et efficace
Aspose.Imaging.Cache.CacheType = Aspose.Imaging.CacheType.Auto;
// La valeur par défaut est 0, ce qui signifie qu'il n'y a pas de limite supérieure
Aspose.Imaging.Cache.MaxDiskSpaceForCache = 1073741824; // 1 gigaoctet
Aspose.Imaging.Cache.MaxMemoryForCache = 1073741824; // 1 gigaoctet
// Il n'est pas recommandé de modifier la propriété suivante car cela peut grandement affecter les performances
Aspose.Imaging.Cache.ExactReallocateOnly = false;
// À tout moment, vous pouvez vérifier combien d'octets sont actuellement alloués pour la mémoire ou le disque
// cache en examinant les propriétés suivantes
long l1 = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
long l2 = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;
// Effectuez un traitement d'image comme ci-dessous
Aspose.Imaging.ImageOptions.GifOptions options = new Aspose.Imaging.ImageOptions.GifOptions();
options.Palette = new ColorPalette(new Aspose.Imaging.Color[] { Aspose.Imaging.Color.Red, Aspose.Imaging.Color.Blue, Aspose.Imaging.Color.Black, Aspose.Imaging.Color.White });
options.Source = new Aspose.Imaging.Sources.StreamSource(new System.IO.MemoryStream(), true);
using (Aspose.Imaging.RasterImage image = (Aspose.Imaging.RasterImage)Aspose.Imaging.Image.Create(options, 100, 100))
{
Aspose.Imaging.Color[] pixels = new Aspose.Imaging.Color[10000];
for (int i = 0; i < pixels.Length; i++)
{
pixels[i] = Aspose.Imaging.Color.White;
}
image.SavePixels(image.Bounds, pixels);
// après l'exécution du code ci-dessus, 40000 octets seront alloués en mémoire.
long diskBytes = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
long memoryBytes = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;
}
// Les propriétés d'allocation peuvent être utilisées pour vérifier si tous les objets Aspose.Imaging ont été correctement disposés.
// Si vous avez oublié d'appeler dispose sur un objet, les valeurs de cache seront différentes de 0.
l1 = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
l2 = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;
### <a id="Aspose_Imaging_Cache_CacheFolder"></a> CacheFolder
Obtient ou définit le dossier de cache.
```csharp
public static string CacheFolder { get; set; }Valeur de la propriété
CacheType
Obtient ou définit le schéma de cache utilisé.
public static CacheType CacheType { get; set; }Valeur de la propriété
Exemples
Cet exemple démontre l’utilisation de Aspose.Imaging.Cache```csharp [C#]
// Par défaut, le dossier de cache est défini sur le répertoire temporaire local de l'utilisateur.
// Vous pouvez également spécifier un autre dossier de cache que le défaut comme suit :
// Cache.CacheFolder = @"D:\\MyTemp";
// Le mode automatique est flexible et efficace
Aspose.Imaging.Cache.CacheType = Aspose.Imaging.CacheType.Auto;
// La valeur par défaut est 0, ce qui signifie qu'il n'y a pas de limite supérieure
Aspose.Imaging.Cache.MaxDiskSpaceForCache = 1073741824; // 1 gigaoctet
Aspose.Imaging.Cache.MaxMemoryForCache = 1073741824; // 1 gigaoctet
// Il n'est pas recommandé de modifier la propriété suivante car cela peut grandement affecter les performances
Aspose.Imaging.Cache.ExactReallocateOnly = false;
// À tout moment, vous pouvez vérifier combien d'octets sont actuellement alloués pour la mémoire ou le disque
// cache en examinant les propriétés suivantes
long l1 = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
long l2 = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;
// Effectuez un traitement d'image comme ci-dessous
Aspose.Imaging.ImageOptions.GifOptions options = new Aspose.Imaging.ImageOptions.GifOptions();
options.Palette = new ColorPalette(new Aspose.Imaging.Color[] { Aspose.Imaging.Color.Red, Aspose.Imaging.Color.Blue, Aspose.Imaging.Color.Black, Aspose.Imaging.Color.White });
options.Source = new Aspose.Imaging.Sources.StreamSource(new System.IO.MemoryStream(), true);
using (Aspose.Imaging.RasterImage image = (Aspose.Imaging.RasterImage)Aspose.Imaging.Image.Create(options, 100, 100))
{
Aspose.Imaging.Color[] pixels = new Aspose.Imaging.Color[10000];
for (int i = 0; i < pixels.Length; i++)
{
pixels[i] = Aspose.Imaging.Color.White;
}
image.SavePixels(image.Bounds, pixels);
// après l'exécution du code ci-dessus, 40000 octets seront alloués en mémoire.
long diskBytes = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
long memoryBytes = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;
}
// Les propriétés d'allocation peuvent être utilisées pour vérifier si tous les objets Aspose.Imaging ont été correctement disposés.
// Si vous avez oublié d'appeler dispose sur un objet, les valeurs de cache seront différentes de 0.
l1 = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
l2 = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;
### <a id="Aspose_Imaging_Cache_ExactReallocateOnly"></a> ExactReallocateOnly
Obtient ou définit une valeur indiquant si la réallocation doit être exacte ou non. Si la réallocation n'est pas exacte, les performances devraient être supérieures.
```csharp
public static bool ExactReallocateOnly { get; set; }Valeur de la propriété
Exemples
Cet exemple démontre l’utilisation de Aspose.Imaging.Cache```csharp [C#]
// Par défaut, le dossier de cache est défini sur le répertoire temporaire local de l'utilisateur.
// Vous pouvez également spécifier un autre dossier de cache que le défaut comme suit :
// Cache.CacheFolder = @"D:\\MyTemp";
// Le mode automatique est flexible et efficace
Aspose.Imaging.Cache.CacheType = Aspose.Imaging.CacheType.Auto;
// La valeur par défaut est 0, ce qui signifie qu'il n'y a pas de limite supérieure
Aspose.Imaging.Cache.MaxDiskSpaceForCache = 1073741824; // 1 gigaoctet
Aspose.Imaging.Cache.MaxMemoryForCache = 1073741824; // 1 gigaoctet
// Il n'est pas recommandé de modifier la propriété suivante car cela peut grandement affecter les performances
Aspose.Imaging.Cache.ExactReallocateOnly = false;
// À tout moment, vous pouvez vérifier combien d'octets sont actuellement alloués pour la mémoire ou le disque
// cache en examinant les propriétés suivantes
long l1 = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
long l2 = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;
// Effectuez un traitement d'image comme ci-dessous
Aspose.Imaging.ImageOptions.GifOptions options = new Aspose.Imaging.ImageOptions.GifOptions();
options.Palette = new ColorPalette(new Aspose.Imaging.Color[] { Aspose.Imaging.Color.Red, Aspose.Imaging.Color.Blue, Aspose.Imaging.Color.Black, Aspose.Imaging.Color.White });
options.Source = new Aspose.Imaging.Sources.StreamSource(new System.IO.MemoryStream(), true);
using (Aspose.Imaging.RasterImage image = (Aspose.Imaging.RasterImage)Aspose.Imaging.Image.Create(options, 100, 100))
{
Aspose.Imaging.Color[] pixels = new Aspose.Imaging.Color[10000];
for (int i = 0; i < pixels.Length; i++)
{
pixels[i] = Aspose.Imaging.Color.White;
}
image.SavePixels(image.Bounds, pixels);
// après l'exécution du code ci-dessus, 40000 octets seront alloués en mémoire.
long diskBytes = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
long memoryBytes = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;
}
// Les propriétés d'allocation peuvent être utilisées pour vérifier si tous les objets Aspose.Imaging ont été correctement disposés.
// Si vous avez oublié d'appeler dispose sur un objet, les valeurs de cache seront différentes de 0.
l1 = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
l2 = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;
#### Remarques
La réallocation exacte effectuera la réallocation de mémoire supplémentaire uniquement jusqu'à la limite supérieure spécifiée.
Lors du passage de la limite supérieure pour la mémoire en mémoire pendant la réallocation, les données mises en cache seront copiées sur le disque si possible.
Lors du passage de la limite supérieure pour la mémoire disque pendant la réallocation, une exception appropriée est levée.
Les performances devraient être supérieures si cette option est désactivée car aucune copie supplémentaire ne sera effectuée si possible,
cependant, cela peut également conduire à dépasser les limites supérieures spécifiées pour la mémoire ou le disque.
### <a id="Aspose_Imaging_Cache_MaxDiskSpaceForCache"></a> MaxDiskSpaceForCache
Obtient ou définit l'espace disque maximum disponible pour le cache. La valeur spécifiée est le nombre de mégaoctets.
```csharp
public static int MaxDiskSpaceForCache { get; set; }Valeur de la propriété
Exemples
Cet exemple démontre l’utilisation de Aspose.Imaging.Cache```csharp [C#]
// Par défaut, le dossier de cache est défini sur le répertoire temporaire local de l'utilisateur.
// Vous pouvez également spécifier un autre dossier de cache que le défaut comme suit :
// Cache.CacheFolder = @"D:\\MyTemp";
// Le mode automatique est flexible et efficace
Aspose.Imaging.Cache.CacheType = Aspose.Imaging.CacheType.Auto;
// La valeur par défaut est 0, ce qui signifie qu'il n'y a pas de limite supérieure
Aspose.Imaging.Cache.MaxDiskSpaceForCache = 1073741824; // 1 gigaoctet
Aspose.Imaging.Cache.MaxMemoryForCache = 1073741824; // 1 gigaoctet
// Il n'est pas recommandé de modifier la propriété suivante car cela peut grandement affecter les performances
Aspose.Imaging.Cache.ExactReallocateOnly = false;
// À tout moment, vous pouvez vérifier combien d'octets sont actuellement alloués pour la mémoire ou le disque
// cache en examinant les propriétés suivantes
long l1 = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
long l2 = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;
// Effectuez un traitement d'image comme ci-dessous
Aspose.Imaging.ImageOptions.GifOptions options = new Aspose.Imaging.ImageOptions.GifOptions();
options.Palette = new ColorPalette(new Aspose.Imaging.Color[] { Aspose.Imaging.Color.Red, Aspose.Imaging.Color.Blue, Aspose.Imaging.Color.Black, Aspose.Imaging.Color.White });
options.Source = new Aspose.Imaging.Sources.StreamSource(new System.IO.MemoryStream(), true);
using (Aspose.Imaging.RasterImage image = (Aspose.Imaging.RasterImage)Aspose.Imaging.Image.Create(options, 100, 100))
{
Aspose.Imaging.Color[] pixels = new Aspose.Imaging.Color[10000];
for (int i = 0; i < pixels.Length; i++)
{
pixels[i] = Aspose.Imaging.Color.White;
}
image.SavePixels(image.Bounds, pixels);
// après l'exécution du code ci-dessus, 40000 octets seront alloués en mémoire.
long diskBytes = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
long memoryBytes = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;
}
// Les propriétés d'allocation peuvent être utilisées pour vérifier si tous les objets Aspose.Imaging ont été correctement disposés.
// Si vous avez oublié d'appeler dispose sur un objet, les valeurs de cache seront différentes de 0.
l1 = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
l2 = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;
#### Remarques
Une valeur de 0 consommera toute la mémoire disponible et servira de limite supérieure inexistante.
### <a id="Aspose_Imaging_Cache_MaxMemoryForCache"></a> MaxMemoryForCache
Obtient ou définit la mémoire maximale disponible pour le cache en mémoire. La valeur spécifiée est le nombre de mégaoctets.
```csharp
public static int MaxMemoryForCache { get; set; }Valeur de la propriété
Exemples
Cet exemple démontre l’utilisation de Aspose.Imaging.Cache```csharp [C#]
// Par défaut, le dossier de cache est défini sur le répertoire temporaire local de l'utilisateur.
// Vous pouvez également spécifier un autre dossier de cache que le défaut comme suit :
// Cache.CacheFolder = @"D:\\MyTemp";
// Le mode automatique est flexible et efficace
Aspose.Imaging.Cache.CacheType = Aspose.Imaging.CacheType.Auto;
// La valeur par défaut est 0, ce qui signifie qu'il n'y a pas de limite supérieure
Aspose.Imaging.Cache.MaxDiskSpaceForCache = 1073741824; // 1 gigaoctet
Aspose.Imaging.Cache.MaxMemoryForCache = 1073741824; // 1 gigaoctet
// Il n'est pas recommandé de modifier la propriété suivante car cela peut grandement affecter les performances
Aspose.Imaging.Cache.ExactReallocateOnly = false;
// À tout moment, vous pouvez vérifier combien d'octets sont actuellement alloués pour la mémoire ou le disque
// cache en examinant les propriétés suivantes
long l1 = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
long l2 = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;
// Effectuez un traitement d'image comme ci-dessous
Aspose.Imaging.ImageOptions.GifOptions options = new Aspose.Imaging.ImageOptions.GifOptions();
options.Palette = new ColorPalette(new Aspose.Imaging.Color[] { Aspose.Imaging.Color.Red, Aspose.Imaging.Color.Blue, Aspose.Imaging.Color.Black, Aspose.Imaging.Color.White });
options.Source = new Aspose.Imaging.Sources.StreamSource(new System.IO.MemoryStream(), true);
using (Aspose.Imaging.RasterImage image = (Aspose.Imaging.RasterImage)Aspose.Imaging.Image.Create(options, 100, 100))
{
Aspose.Imaging.Color[] pixels = new Aspose.Imaging.Color[10000];
for (int i = 0; i < pixels.Length; i++)
{
pixels[i] = Aspose.Imaging.Color.White;
}
image.SavePixels(image.Bounds, pixels);
// après l'exécution du code ci-dessus, 40000 octets seront alloués en mémoire.
long diskBytes = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
long memoryBytes = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;
}
// Les propriétés d'allocation peuvent être utilisées pour vérifier si tous les objets Aspose.Imaging ont été correctement disposés.
// Si vous avez oublié d'appeler dispose sur un objet, les valeurs de cache seront différentes de 0.
l1 = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
l2 = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;
#### Remarques
Une valeur de 0 consommera toute la mémoire disponible et servira de limite supérieure inexistante.
## Méthodes
### <a id="Aspose_Imaging_Cache_SetDefaults"></a> SetDefaults\(\)
Réinitialise les paramètres de Aspose.Imaging.Cache aux valeurs par défaut.
```csharp
public static void SetDefaults()