MemoryMappedFile.CreateViewStream 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 einen Datenstrom, der einer Ansicht der speicherzuordnungen Datei zugeordnet ist.
Überlädt
| Name | Beschreibung |
|---|---|
| CreateViewStream() |
Erstellt einen Datenstrom, der einer Ansicht der speicherzuordnungen Datei zugeordnet ist. |
| CreateViewStream(Int64, Int64) |
Erstellt einen Datenstrom, der einer Ansicht der speicherzuordnungen Datei zugeordnet ist und über den angegebenen Offset und die angegebene Größe verfügt. |
| CreateViewStream(Int64, Int64, MemoryMappedFileAccess) |
Erstellt einen Datenstrom, der einer Ansicht der speicherzuordnungen Datei zugeordnet ist und den angegebenen Offset, die Größe und zugriffstyp aufweist. |
CreateViewStream()
Erstellt einen Datenstrom, der einer Ansicht der speicherzuordnungen Datei zugeordnet ist.
public:
System::IO::MemoryMappedFiles::MemoryMappedViewStream ^ CreateViewStream();public System.IO.MemoryMappedFiles.MemoryMappedViewStream CreateViewStream();member this.CreateViewStream : unit -> System.IO.MemoryMappedFiles.MemoryMappedViewStreamPublic Function CreateViewStream () As MemoryMappedViewStreamGibt zurück
Ein Speicherstrom.
Ausnahmen
Der Zugriff auf die speicherzuordnungen Datei ist nicht autorisiert.
Beispiele
Im folgenden Beispiel wird ein Datenstrom erstellt und ein Wert in ihn geschrieben. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die CreateNew Methode bereitgestellt wird.
using (MemoryMappedViewStream stream = mmf.CreateViewStream())
{
BinaryWriter writer = new BinaryWriter(stream);
writer.Write(1);
}
Using Stream As MemoryMappedViewStream = mmf.CreateViewStream()
Dim writer As BinaryWriter = New BinaryWriter(Stream)
writer.Write(1)
End Using
Hinweise
Sie können den von dieser Methode zurückgegebenen Datenstrom für den sequenziellen Zugriff auf eine speicherzuordnunge Datei verwenden, z. B. für die Kommunikation zwischen Prozessen.
Weitere Informationen
Gilt für:
CreateViewStream(Int64, Int64)
Erstellt einen Datenstrom, der einer Ansicht der speicherzuordnungen Datei zugeordnet ist und über den angegebenen Offset und die angegebene Größe verfügt.
public:
System::IO::MemoryMappedFiles::MemoryMappedViewStream ^ CreateViewStream(long offset, long size);public System.IO.MemoryMappedFiles.MemoryMappedViewStream CreateViewStream(long offset, long size);member this.CreateViewStream : int64 * int64 -> System.IO.MemoryMappedFiles.MemoryMappedViewStreamPublic Function CreateViewStream (offset As Long, size As Long) As MemoryMappedViewStreamParameter
- 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 Speicherstrom mit dem angegebenen Offset und der angegebenen Größe.
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.
size ist größer als der virtuelle Gesamtspeicher.
Hinweise
Sie können den von dieser Methode zurückgegebenen Datenstrom für den sequenziellen Zugriff auf eine speicherzuordnunge Datei verwenden, z. B. für die Kommunikation zwischen Prozessen.
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:
CreateViewStream(Int64, Int64, MemoryMappedFileAccess)
Erstellt einen Datenstrom, der einer Ansicht der speicherzuordnungen Datei zugeordnet ist und den angegebenen Offset, die Größe und zugriffstyp aufweist.
public:
System::IO::MemoryMappedFiles::MemoryMappedViewStream ^ CreateViewStream(long offset, long size, System::IO::MemoryMappedFiles::MemoryMappedFileAccess access);[System.Security.SecurityCritical]
public System.IO.MemoryMappedFiles.MemoryMappedViewStream CreateViewStream(long offset, long size, System.IO.MemoryMappedFiles.MemoryMappedFileAccess access);public System.IO.MemoryMappedFiles.MemoryMappedViewStream CreateViewStream(long offset, long size, System.IO.MemoryMappedFiles.MemoryMappedFileAccess access);[<System.Security.SecurityCritical>]
member this.CreateViewStream : int64 * int64 * System.IO.MemoryMappedFiles.MemoryMappedFileAccess -> System.IO.MemoryMappedFiles.MemoryMappedViewStreammember this.CreateViewStream : int64 * int64 * System.IO.MemoryMappedFiles.MemoryMappedFileAccess -> System.IO.MemoryMappedFiles.MemoryMappedViewStreamPublic Function CreateViewStream (offset As Long, size As Long, access As MemoryMappedFileAccess) As MemoryMappedViewStreamParameter
- 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 Speicherstrom mit den angegebenen Merkmalen.
- Attribute
Ausnahmen
offset oder size ist ein negativer Wert.
-oder-
size ist größer als der logische Adressraum.
-oder-
access ist kein gültiger MemoryMappedFileAccess Enumerationswert.
access ist für die speicherzuordnunge Datei ungültig.
size ist größer als der virtuelle Gesamtspeicher.
-oder-
access ist für die speicherzuordnunge Datei ungültig.
Hinweise
Sie können den von dieser Methode zurückgegebenen Datenstrom für den sequenziellen Zugriff auf eine speicherzuordnunge Datei verwenden, z. B. für die Kommunikation zwischen Prozessen.
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.