MemoryMappedFile.CreateViewAccessor Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Erstellt eine MemoryMappedViewAccessor Zuordnung zu einer Ansicht der speicherzuordnungen Datei.
Überlädt
| Name | Beschreibung |
|---|---|
| CreateViewAccessor() |
Erstellt eine MemoryMappedViewAccessor Zuordnung zu einer Ansicht der speicherzuordnungen Datei. |
| CreateViewAccessor(Int64, Int64) |
Erstellt eine MemoryMappedViewAccessor Zuordnung zu einer Ansicht der speicherzuordnungen Datei, die über den angegebenen Offset und die angegebene Größe verfügt. |
| CreateViewAccessor(Int64, Int64, MemoryMappedFileAccess) |
Erstellt ein MemoryMappedViewAccessor Objekt, das einer Ansicht der speicherzuordnungen Datei zugeordnet ist und über den angegebenen Offset, die Größe und Zugriffsbeschränkungen verfügt. |
CreateViewAccessor()
Erstellt eine MemoryMappedViewAccessor Zuordnung zu einer Ansicht der speicherzuordnungen Datei.
public:
System::IO::MemoryMappedFiles::MemoryMappedViewAccessor ^ CreateViewAccessor();public System.IO.MemoryMappedFiles.MemoryMappedViewAccessor CreateViewAccessor();member this.CreateViewAccessor : unit -> System.IO.MemoryMappedFiles.MemoryMappedViewAccessorPublic Function CreateViewAccessor () As MemoryMappedViewAccessorGibt zurück
Ein zufällig zugänglicher Speicherblock.
Ausnahmen
Der Zugriff auf die speicherzuordnungen Datei ist nicht autorisiert.
Hinweise
Sie können die von dieser Methode zurückgegebene Ansicht verwenden, um zufälligen Zugriff auf eine speicherzuordnunge Datei zu erhalten.
Weitere Informationen
Gilt für:
CreateViewAccessor(Int64, Int64)
Erstellt eine MemoryMappedViewAccessor Zuordnung zu einer Ansicht der speicherzuordnungen Datei, die über den angegebenen Offset und die angegebene Größe verfügt.
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 MemoryMappedViewAccessorParameter
- offset
- Int64
Das Byte, an dem die Ansicht gestartet werden soll.
- size
- Int64
Die Größe der Ansicht. Geben Sie 0 (Null) an, um eine Ansicht zu erstellen, die ungefähr am Ende der speicherzuordnungen Datei beginnt offset und endet.
Gibt zurück
Ein zufällig zugänglicher Speicherblock.
Ausnahmen
offset oder size ist ein negativer Wert.
-oder-
size ist größer als der logische Adressraum.
Der Zugriff auf die speicherzuordnungen Datei ist nicht autorisiert.
Ein E/A-Fehler ist aufgetreten.
Beispiele
Im folgenden Beispiel wird eine Ansicht einer speicherzuordnungen Datei erstellt und bearbeitet. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die MemoryMappedFile Klasse bereitgestellt wird.
// 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
Hinweise
Sie können die von dieser Methode zurückgegebene Ansicht verwenden, um zufälligen Zugriff auf eine speicherzuordnunge Datei zu erhalten.
Um eine vollständige Ansicht der speicherzuordnungen Datei zu erstellen, geben Sie 0 (null) für den size Parameter an. Wenn Sie dies tun, ist die Größe der Ansicht möglicherweise größer als die Größe der Quelldatei auf dem Datenträger. Dies liegt daran, dass Ansichten in Einheiten von Systemseiten bereitgestellt werden und die Größe der Ansicht auf die nächste Systemseitengröße aufgerundet wird.
Weitere Informationen
Gilt für:
CreateViewAccessor(Int64, Int64, MemoryMappedFileAccess)
Erstellt ein MemoryMappedViewAccessor Objekt, das einer Ansicht der speicherzuordnungen Datei zugeordnet ist und über den angegebenen Offset, die Größe und Zugriffsbeschränkungen verfügt.
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 MemoryMappedViewAccessorParameter
- offset
- Int64
Das Byte, an dem die Ansicht gestartet werden soll.
- size
- Int64
Die Größe der Ansicht. Geben Sie 0 (Null) an, um eine Ansicht zu erstellen, die ungefähr am Ende der speicherzuordnungen Datei beginnt offset und endet.
- access
- MemoryMappedFileAccess
Einer der Enumerationswerte, der den Typ des Zugriffs angibt, der für die speicherzuordnunge Datei zulässig ist. Der Standardwert lautet ReadWrite.
Gibt zurück
Ein zufällig zugänglicher Speicherblock.
- Attribute
Ausnahmen
offset oder size ist ein negativer Wert.
-oder-
size ist größer als der logische Adressraum.
access ist für die speicherzuordnunge Datei ungültig.
Ein E/A-Fehler ist aufgetreten.
Hinweise
Sie können die von dieser Methode zurückgegebene Ansicht verwenden, um zufälligen Zugriff auf eine speicherzuordnunge Datei zu erhalten.
Um eine vollständige Ansicht der speicherzuordnungen Datei zu erstellen, geben Sie 0 (null) für den size Parameter an. Wenn Sie dies tun, ist die Größe der Ansicht möglicherweise größer als die Größe der Quelldatei auf dem Datenträger. Dies liegt daran, dass Ansichten in Einheiten von Systemseiten bereitgestellt werden und die Größe der Ansicht auf die nächste Systemseitengröße aufgerundet wird.