MemoryMappedFile 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
表示記憶體對應檔。
public ref class MemoryMappedFile : IDisposablepublic class MemoryMappedFile : IDisposabletype MemoryMappedFile = class
interface IDisposablePublic Class MemoryMappedFile
Implements IDisposable- 繼承
-
MemoryMappedFile
- 實作
範例
下列範例會針對極大檔案的一部分建立記憶體對應檢視，及操作其中的一部分。
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
備註
記憶體對應檔案會將檔案的內容對應至應用程式的邏輯位址空間。 記憶體對應檔案可讓程式設計人員使用極大型的檔案，因為可以同時管理記憶體，而且允許完整、隨機存取檔案，而不需要搜尋。 記憶體對應檔案也可以跨多個進程共用。
CreateFromFile方法會從指定的路徑或磁碟上現有檔案的 建立FileStream記憶體對應檔案。 當檔案未對應時，變更會自動傳播至磁碟。
方法 CreateNew 會建立未對應至磁碟上現有檔案的記憶體對應檔案;而且適合建立共用記憶體以進行進程間通訊 (IPC) 。
記憶體對應檔案可以與選擇性名稱相關聯，讓記憶體對應檔案與其他進程共用。
您可以建立記憶體對應檔案的多個檢視，包括檔案部分的檢視。 您可以將檔案的相同部分對應至多個位址，以建立並行記憶體。 若要讓兩個檢視維持並行，必須從相同的記憶體對應檔案建立這兩個檢視。 使用兩個檢視建立相同檔案的兩個檔案對應不提供並行。
屬性
| SafeMemoryMappedFileHandle |
取得記憶體對應檔的檔案控制代碼。 |
