MemoryMappedFile MemoryMappedFile MemoryMappedFile MemoryMappedFile Class

Определение

public ref class MemoryMappedFile : IDisposable

public class MemoryMappedFile : IDisposable

type MemoryMappedFile = class
    interface IDisposable

Public Class MemoryMappedFile
Implements IDisposable

Наследование

ObjectObjectObjectObject

MemoryMappedFileMemoryMappedFileMemoryMappedFileMemoryMappedFile

Реализации

IDisposableIDisposableIDisposableIDisposable

Примеры

В следующем примере создается отображенное в память представление для части очень большого файла, с которым выполняются определенные действия:The following example creates a memory-mapped view of a part of an extremely large file and manipulates a portion of it.

using System;
using System.IO;
using System.IO.MemoryMappedFiles;
using System.Runtime.InteropServices;

class Program
{
    static void Main(string[] args)
    {
        long offset = 0x10000000; // 256 megabytes
        long length = 0x20000000; // 512 megabytes

        // Create the memory-mapped file.
        using (var mmf = MemoryMappedFile.CreateFromFile(@"c:\ExtremelyLargeImage.data", FileMode.Open,"ImgA"))
        {
            // 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);
                }
            }
        }
    }
}

public struct MyColor
{
    public short Red;
    public short Green;
    public short Blue;
    public short Alpha;

    // Make the view brighter.
    public void Brighten(short value)
    {
        Red = (short)Math.Min(short.MaxValue, (int)Red + value);
        Green = (short)Math.Min(short.MaxValue, (int)Green + value);
        Blue = (short)Math.Min(short.MaxValue, (int)Blue + value);
        Alpha = (short)Math.Min(short.MaxValue, (int)Alpha + value);
    }
}

Imports System.IO
Imports System.IO.MemoryMappedFiles
Imports System.Runtime.InteropServices

Class Program

    Sub Main()
        Dim offset As Long = &H10000000 ' 256 megabytes
        Dim length As Long = &H20000000 ' 512 megabytes

        ' Create the memory-mapped file.
        Using mmf = MemoryMappedFile.CreateFromFile("c:\ExtremelyLargeImage.data", FileMode.Open, "ImgA")
            ' 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
        End Using
    End Sub
End Class

Public Structure MyColor
    Public Red As Short
    Public Green As Short
	Public Blue As Short
	Public Alpha As Short

    ' Make the view brighter.
	Public Sub Brighten(ByVal value As Short)
        Red = CType(Math.Min(Short.MaxValue, (CType(Red, Integer) + value)), Short)
        Green = CType(Math.Min(Short.MaxValue, (CType(Green, Integer) + value)), Short)
        Blue = CType(Math.Min(Short.MaxValue, (CType(Blue, Integer) + value)), Short)
        Alpha = CType(Math.Min(Short.MaxValue, (CType(Alpha, Integer) + value)), Short)
    End Sub
End Structure

Комментарии

Размещенный в памяти файл сопоставляет содержимое файла с логическим адресным пространством приложения.A memory-mapped file maps the contents of a file to an application's logical address space. Размещенные в памяти файлы позволяют программистам работать с очень большими файлами, так как память может управляться параллельно, и они обеспечивают полный, произвольный доступ к файлу без необходимости поиска.Memory-mapped files enable programmers to work with extremely large files because memory can be managed concurrently, and they allow complete, random access to a file without the need for seeking. Размещенные в памяти файлы также могут совместно использоваться несколькими процессами.Memory-mapped files can also be shared across multiple processes.

Методы создают размещенный в памяти файл по указанному пути FileStream или к существующему файлу на диске. CreateFromFileThe CreateFromFile methods create a memory-mapped file from a specified path or a FileStream of an existing file on disk. Изменения автоматически распространяются на диск при несопоставленном файле.Changes are automatically propagated to disk when the file is unmapped.

CreateNew Методы создают размещенный в памяти файл, который не сопоставляется с существующим файлом на диске; и подходит для создания общей памяти для межпроцессного взаимодействия (IPC).The CreateNew methods create a memory-mapped file that is not mapped to an existing file on disk; and are suitable for creating shared memory for interprocess communication (IPC).

Размещенный в памяти файл может быть связан с необязательным именем, который позволяет совместно использовать размещенный в памяти файл с другими процессами.A memory-mapped file can be associated with an optional name that allows the memory-mapped file to be shared with other processes.

Можно создать несколько представлений сопоставленного в память файла, включая представления частей файла.You can create multiple views of the memory-mapped file, including views of parts of the file. Одну и ту же часть файла можно связать с более чем одним адресом для создания параллельной памяти.You can map the same part of a file to more than one address to create concurrent memory. Чтобы два представления оставались согласованными, их нужно создавать из одного отображенного в память файла.For two views to remain concurrent, they have to be created from the same memory-mapped file. Создание двух сопоставлений файлов одного и того же файла с двумя представлениями не обеспечивает параллелизм.Creating two file mappings of the same file with two views does not provide concurrency.

Свойства

Методы

Применяется к

Дополнительно

• Сопоставленные в памяти файлыMemory-Mapped Files