MemoryMappedFile.CreateViewAccessor Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee maakt u een MemoryMappedViewAccessor bestand dat is toegewezen aan een weergave van het geheugentoewijzingsbestand.
Overloads
| Name | Description |
|---|---|
| CreateViewAccessor() |
Hiermee maakt u een MemoryMappedViewAccessor bestand dat is toegewezen aan een weergave van het geheugentoewijzingsbestand. |
| CreateViewAccessor(Int64, Int64) |
Hiermee maakt u een MemoryMappedViewAccessor weergave van het geheugentoewijzingsbestand en met de opgegeven offset en grootte. |
| CreateViewAccessor(Int64, Int64, MemoryMappedFileAccess) |
Hiermee maakt u een MemoryMappedViewAccessor weergave van het geheugentoewijzingsbestand en met de opgegeven offset, grootte en toegangsbeperkingen. |
CreateViewAccessor()
Hiermee maakt u een MemoryMappedViewAccessor bestand dat is toegewezen aan een weergave van het geheugentoewijzingsbestand.
public:
System::IO::MemoryMappedFiles::MemoryMappedViewAccessor ^ CreateViewAccessor();public System.IO.MemoryMappedFiles.MemoryMappedViewAccessor CreateViewAccessor();member this.CreateViewAccessor : unit -> System.IO.MemoryMappedFiles.MemoryMappedViewAccessorPublic Function CreateViewAccessor () As MemoryMappedViewAccessorRetouren
Een willekeurig toegankelijk geheugenblok.
Uitzonderingen
Toegang tot het geheugentoewijzingsbestand is niet gemachtigd.
Opmerkingen
U kunt de weergave die door deze methode wordt geretourneerd, gebruiken voor willekeurige toegang tot een bestand dat is toegewezen aan het geheugen.
Zie ook
Van toepassing op
CreateViewAccessor(Int64, Int64)
Hiermee maakt u een MemoryMappedViewAccessor weergave van het geheugentoewijzingsbestand en met de opgegeven offset en grootte.
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.MemoryMappedViewAccessorPublic Function CreateViewAccessor (offset As Long, size As Long) As MemoryMappedViewAccessorParameters
- offset
- Int64
De byte waarop de weergave moet worden gestart.
- size
- Int64
De grootte van de weergave. Geef 0 (nul) op om een weergave te maken die ongeveer aan het einde van het geheugentoewijzingsbestand begint offset en eindigt.
Retouren
Een willekeurig toegankelijk geheugenblok.
Uitzonderingen
offset of size een negatieve waarde is.
– of –
size groter is dan de logische adresruimte.
Toegang tot het geheugentoewijzingsbestand is niet gemachtigd.
Er is een I/O-fout opgetreden.
Voorbeelden
In het volgende voorbeeld wordt een weergave gemaakt van een bestand dat is toegewezen aan het geheugen en bewerkt het. Dit codevoorbeeld maakt deel uit van een groter voorbeeld voor de MemoryMappedFile klasse.
// 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
Opmerkingen
U kunt de weergave die door deze methode wordt geretourneerd, gebruiken voor willekeurige toegang tot een bestand dat is toegewezen aan het geheugen.
Als u een volledige weergave van het geheugentoewijzingsbestand wilt maken, geeft u 0 (nul) op voor de size parameter. Als u dit doet, kan de grootte van de weergave groter zijn dan de grootte van het bronbestand op schijf. Dit komt doordat weergaven worden aangeboden in eenheden van systeempagina's en de grootte van de weergave wordt afgerond op het volgende systeempaginaformaat.
Zie ook
Van toepassing op
CreateViewAccessor(Int64, Int64, MemoryMappedFileAccess)
Hiermee maakt u een MemoryMappedViewAccessor weergave van het geheugentoewijzingsbestand en met de opgegeven offset, grootte en toegangsbeperkingen.
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.MemoryMappedViewAccessormember this.CreateViewAccessor : int64 * int64 * System.IO.MemoryMappedFiles.MemoryMappedFileAccess -> System.IO.MemoryMappedFiles.MemoryMappedViewAccessorPublic Function CreateViewAccessor (offset As Long, size As Long, access As MemoryMappedFileAccess) As MemoryMappedViewAccessorParameters
- offset
- Int64
De byte waarop de weergave moet worden gestart.
- size
- Int64
De grootte van de weergave. Geef 0 (nul) op om een weergave te maken die ongeveer aan het einde van het geheugentoewijzingsbestand begint offset en eindigt.
- access
- MemoryMappedFileAccess
Een van de opsommingswaarden die het type toegang aangeeft dat is toegestaan voor het geheugentoewijzingsbestand. De standaardwaarde is ReadWrite.
Retouren
Een willekeurig toegankelijk geheugenblok.
- Kenmerken
Uitzonderingen
offset of size een negatieve waarde is.
– of –
size groter is dan de logische adresruimte.
access is ongeldig voor het geheugentoewijzingsbestand.
Er is een I/O-fout opgetreden.
Opmerkingen
U kunt de weergave die door deze methode wordt geretourneerd, gebruiken voor willekeurige toegang tot een bestand dat is toegewezen aan het geheugen.
Als u een volledige weergave van het geheugentoewijzingsbestand wilt maken, geeft u 0 (nul) op voor de size parameter. Als u dit doet, kan de grootte van de weergave groter zijn dan de grootte van het bronbestand op schijf. Dit komt doordat weergaven worden aangeboden in eenheden van systeempagina's en de grootte van de weergave wordt afgerond op het volgende systeempaginaformaat.