MemoryMappedFile.CreateViewAccessor Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Crée un MemoryMappedViewAccessor mappage à une vue du fichier mappé en mémoire.
Surcharges
| Nom | Description |
|---|---|
| CreateViewAccessor() |
Crée un MemoryMappedViewAccessor mappage à une vue du fichier mappé en mémoire. |
| CreateViewAccessor(Int64, Int64) |
Crée un MemoryMappedViewAccessor mappage qui correspond à une vue du fichier mappé en mémoire et qui a le décalage et la taille spécifiés. |
| CreateViewAccessor(Int64, Int64, MemoryMappedFileAccess) |
Crée un MemoryMappedViewAccessor mappage à une vue du fichier mappé en mémoire et qui a le décalage, la taille et les restrictions d’accès spécifiés. |
CreateViewAccessor()
Crée un MemoryMappedViewAccessor mappage à une vue du fichier mappé en mémoire.
public:
System::IO::MemoryMappedFiles::MemoryMappedViewAccessor ^ CreateViewAccessor();
public System.IO.MemoryMappedFiles.MemoryMappedViewAccessor CreateViewAccessor();
member this.CreateViewAccessor : unit -> System.IO.MemoryMappedFiles.MemoryMappedViewAccessor
Public Function CreateViewAccessor () As MemoryMappedViewAccessor
Retours
Bloc de mémoire accessible de façon aléatoire.
Exceptions
L’accès au fichier mappé en mémoire n’est pas autorisé.
Remarques
Vous pouvez utiliser la vue retournée par cette méthode pour l’accès aléatoire à un fichier mappé en mémoire.
Voir aussi
S’applique à
CreateViewAccessor(Int64, Int64)
Crée un MemoryMappedViewAccessor mappage qui correspond à une vue du fichier mappé en mémoire et qui a le décalage et la taille spécifiés.
public:
System::IO::MemoryMappedFiles::MemoryMappedViewAccessor ^ CreateViewAccessor(long offset, long size);
public System.IO.MemoryMappedFiles.MemoryMappedViewAccessor CreateViewAccessor(long offset, long size);
member this.CreateViewAccessor : int64 * int64 -> System.IO.MemoryMappedFiles.MemoryMappedViewAccessor
Public Function CreateViewAccessor (offset As Long, size As Long) As MemoryMappedViewAccessor
Paramètres
- offset
- Int64
Octet auquel démarrer la vue.
- size
- Int64
Taille de la vue. Spécifiez 0 (zéro) pour créer une vue qui commence à offset la fin et se termine approximativement à la fin du fichier mappé en mémoire.
Retours
Bloc de mémoire accessible de façon aléatoire.
Exceptions
offset ou size est une valeur négative.
-ou-
size est supérieur à l’espace d’adressage logique.
L’accès au fichier mappé en mémoire n’est pas autorisé.
Une erreur d’E/S s’est produite.
Exemples
L’exemple suivant crée une vue d’un fichier mappé en mémoire et le modifie. Cet exemple de code fait partie d’un exemple plus grand fourni pour la MemoryMappedFile classe.
// Create a random access view, from the 256th megabyte (the offset)
// to the 768th megabyte (the offset plus length).
using (var accessor = mmf.CreateViewAccessor(offset, length))
{
int colorSize = Marshal.SizeOf(typeof(MyColor));
MyColor color;
// Make changes to the view.
for (long i = 0; i < length; i += colorSize)
{
accessor.Read(i, out color);
color.Brighten(10);
accessor.Write(i, ref color);
}
}
' Create a random access view, from the 256th megabyte (the offset)
' to the 768th megabyte (the offset plus length).
Using accessor = mmf.CreateViewAccessor(offset, length)
Dim colorSize As Integer = Marshal.SizeOf(GetType(MyColor))
Dim color As MyColor
Dim i As Long = 0
' Make changes to the view.
Do While (i < length)
accessor.Read(i, color)
color.Brighten(10)
accessor.Write(i, color)
i += colorSize
Loop
End Using
Remarques
Vous pouvez utiliser la vue retournée par cette méthode pour l’accès aléatoire à un fichier mappé en mémoire.
Pour créer une vue complète du fichier mappé en mémoire, spécifiez 0 (zéro) pour le size paramètre. Si vous effectuez cette opération, la taille de la vue peut être supérieure à la taille du fichier source sur le disque. Cela est dû au fait que les vues sont fournies en unités de pages système et que la taille de l’affichage est arrondie à la taille de page système suivante.
Voir aussi
S’applique à
CreateViewAccessor(Int64, Int64, MemoryMappedFileAccess)
Crée un MemoryMappedViewAccessor mappage à une vue du fichier mappé en mémoire et qui a le décalage, la taille et les restrictions d’accès spécifiés.
public:
System::IO::MemoryMappedFiles::MemoryMappedViewAccessor ^ CreateViewAccessor(long offset, long size, System::IO::MemoryMappedFiles::MemoryMappedFileAccess access);
[System.Security.SecurityCritical]
public System.IO.MemoryMappedFiles.MemoryMappedViewAccessor CreateViewAccessor(long offset, long size, System.IO.MemoryMappedFiles.MemoryMappedFileAccess access);
public System.IO.MemoryMappedFiles.MemoryMappedViewAccessor CreateViewAccessor(long offset, long size, System.IO.MemoryMappedFiles.MemoryMappedFileAccess access);
[<System.Security.SecurityCritical>]
member this.CreateViewAccessor : int64 * int64 * System.IO.MemoryMappedFiles.MemoryMappedFileAccess -> System.IO.MemoryMappedFiles.MemoryMappedViewAccessor
member this.CreateViewAccessor : int64 * int64 * System.IO.MemoryMappedFiles.MemoryMappedFileAccess -> System.IO.MemoryMappedFiles.MemoryMappedViewAccessor
Public Function CreateViewAccessor (offset As Long, size As Long, access As MemoryMappedFileAccess) As MemoryMappedViewAccessor
Paramètres
- offset
- Int64
Octet auquel démarrer la vue.
- size
- Int64
Taille de la vue. Spécifiez 0 (zéro) pour créer une vue qui commence à offset la fin et se termine approximativement à la fin du fichier mappé en mémoire.
- access
- MemoryMappedFileAccess
Une des valeurs d’énumération qui spécifie le type d’accès autorisé au fichier mappé en mémoire. La valeur par défaut est ReadWrite.
Retours
Bloc de mémoire accessible de façon aléatoire.
- Attributs
Exceptions
offset ou size est une valeur négative.
-ou-
size est supérieur à l’espace d’adressage logique.
access n’est pas valide pour le fichier mappé en mémoire.
Une erreur d’E/S s’est produite.
Remarques
Vous pouvez utiliser la vue retournée par cette méthode pour l’accès aléatoire à un fichier mappé en mémoire.
Pour créer une vue complète du fichier mappé en mémoire, spécifiez 0 (zéro) pour le size paramètre. Si vous effectuez cette opération, la taille de la vue peut être supérieure à la taille du fichier source sur le disque. Cela est dû au fait que les vues sont fournies en unités de pages système et que la taille de l’affichage est arrondie à la taille de page système suivante.