MemoryMappedFile.CreateViewAccessor Méthode

Définition

Espace de noms:

System.IO.MemoryMappedFiles

Assembly:

System.IO.MemoryMappedFiles.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

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

Voir aussi

• Fichiers mappés en mémoire

CreateViewAccessor(Int64, Int64)

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 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 procédez ainsi, la taille de la vue peut être supérieure à la taille du fichier source sur le disque. Cela est dû au fait que les affichages sont fournis 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

• Fichiers mappés en mémoire

CreateViewAccessor(Int64, Int64, MemoryMappedFileAccess)

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);

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.

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 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 procédez ainsi, la taille de la vue peut être supérieure à la taille du fichier source sur le disque. Cela est dû au fait que les affichages sont fournis 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

• Fichiers mappés en mémoire