MemoryMappedFile.CreateViewAccessor Méthode

  • Référence

Définition

Espace de noms:
System.IO.MemoryMappedFiles
Assembly:
System.IO.MemoryMappedFiles.dll
Assembly:
System.Core.dll
Assembly:
netstandard.dll

Crée un objet MemoryMappedViewAccessor mappé à un affichage du fichier mappé en mémoire.

Surcharges

CreateViewAccessor()

Crée un objet MemoryMappedViewAccessor mappé à un affichage du fichier mappé en mémoire.
CreateViewAccessor(Int64, Int64)

Crée un MemoryMappedViewAccessor mappé à une vue du fichier mappé en mémoire et ayant le décalage et la taille spécifiés.
CreateViewAccessor(Int64, Int64, MemoryMappedFileAccess)

Crée un MemoryMappedViewAccessor mappé à une vue du fichier mappé en mémoire et ayant le décalage, la taille et les restrictions d’accès spécifiés.

CreateViewAccessor()

Source:
MemoryMappedFile.cs
Source:
MemoryMappedFile.cs
Source:
MemoryMappedFile.cs

Crée un objet MemoryMappedViewAccessor mappé à un affichage 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

MemoryMappedViewAccessor

Bloc de mémoire accessible de manière aléatoire.

Exceptions

UnauthorizedAccessException

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 un accès aléatoire à un fichier mappé en mémoire.

Voir aussi

S’applique à

CreateViewAccessor(Int64, Int64)

Source:
MemoryMappedFile.cs
Source:
MemoryMappedFile.cs
Source:
MemoryMappedFile.cs

Crée un MemoryMappedViewAccessor mappé à une vue du fichier mappé en mémoire et ayant 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 à partir duquel commencer l'affichage.

size
Int64

Indique la taille de l'affichage. Spécifiez 0 (zéro) pour créer une vue qui commence à offset et se termine vers la fin du fichier mappé en mémoire.

Retours

MemoryMappedViewAccessor

Bloc de mémoire accessible de manière aléatoire.

Exceptions

ArgumentOutOfRangeException

offset ou size est une valeur négative.

- ou -

size est supérieur à l’espace d’adressage logique.

UnauthorizedAccessException

L’accès au fichier mappé en mémoire n’est pas autorisé.

IOException

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 un 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. Dans ce cas, 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 la vue est arrondie à la taille de page système suivante.

Voir aussi

S’applique à

CreateViewAccessor(Int64, Int64, MemoryMappedFileAccess)

Source:
MemoryMappedFile.cs
Source:
MemoryMappedFile.cs
Source:
MemoryMappedFile.cs

Crée un MemoryMappedViewAccessor mappé à une vue du fichier mappé en mémoire et ayant 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);
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);
member this.CreateViewAccessor : int64 * int64 * System.IO.MemoryMappedFiles.MemoryMappedFileAccess -> System.IO.MemoryMappedFiles.MemoryMappedViewAccessor
[<System.Security.SecurityCritical>]
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 à partir duquel commencer l'affichage.

size
Int64

Indique la taille de l'affichage. Spécifiez 0 (zéro) pour créer une vue qui commence à offset et se termine vers la fin du fichier mappé en mémoire.

access
MemoryMappedFileAccess

L'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

MemoryMappedViewAccessor

Bloc de mémoire accessible de manière aléatoire.

Attributs
SecurityCriticalAttribute

Exceptions

ArgumentOutOfRangeException

offset ou size est une valeur négative.

- ou -

size est supérieur à l’espace d’adressage logique.

UnauthorizedAccessException

access n’est pas valide pour le fichier mappé en mémoire.

IOException

Une erreur d'E/S s'est produite.

Remarques

Vous pouvez utiliser la vue retournée par cette méthode pour un 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. Dans ce cas, 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 la vue est arrondie à la taille de page système suivante.

Voir aussi

S’applique à