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 Stream, der einer Ansicht der Speicherabbilddatei zugeordnet ist.
Überlädt
| CreateViewStream() |
Erstellt einen Stream, der einer Ansicht der Speicherabbilddatei zugeordnet ist. |
| CreateViewStream(Int64, Int64) |
Erstellt einen Datenstrom, der einer Ansicht der im Speicher abgebildeten Datei zugeordnet ist und über die angegebenen Werte für Offset und Größe verfügt. |
| CreateViewStream(Int64, Int64, MemoryMappedFileAccess) |
Erstellt einen Datenstrom, der einer Ansicht der im Speicher abgebildeten Datei zugeordnet ist und über die angegebenen Werte für Offset, Größe und Zugriffstyp verfügt. |
CreateViewStream()
- Quelle:
- MemoryMappedFile.cs
- Quelle:
- MemoryMappedFile.cs
- Quelle:
- MemoryMappedFile.cs
Erstellt einen Stream, der einer Ansicht der Speicherabbilddatei 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 Speicherstream.
Ausnahmen
Der Zugriff auf Speicherabbilddatei ist nicht zugelassen.
Beispiele
Im folgenden Beispiel wird ein Stream erstellt und ein Wert in diesen geschrieben. Dieses Codebeispiel ist Teil eines größeren Beispiels für die CreateNew -Methode.
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 Stream für den sequenziellen Zugriff auf eine im Speicher zugeordnete Datei verwenden, z. B. für die prozessübergreifende Kommunikation.
Weitere Informationen
Gilt für:
CreateViewStream(Int64, Int64)
- Quelle:
- MemoryMappedFile.cs
- Quelle:
- MemoryMappedFile.cs
- Quelle:
- MemoryMappedFile.cs
Erstellt einen Datenstrom, der einer Ansicht der im Speicher abgebildeten Datei zugeordnet ist und über die angegebenen Werte für Offset und 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, ab dem die Ansicht beginnen soll.
- size
- Int64
Die Größe der Ansicht. Geben Sie 0 (null) an, um eine Ansicht zu erstellen, die bei offset beginnt und ungefähr am Ende der Speicherimagedatei endet.
Gibt zurück
Ein Speicherdatenstrom mit den angegebenen Werten für Offset und Größe.
Ausnahmen
offset oder size ist ein negativer Wert.
- oder -
size ist größer als der logische Adressbereich.
Der Zugriff auf Speicherabbilddatei ist nicht zugelassen.
size ist größer als der gesamte virtuelle Arbeitsspeicher.
Hinweise
Sie können den von dieser Methode zurückgegebenen Stream für den sequenziellen Zugriff auf eine im Speicher zugeordnete Datei verwenden, z. B. für die prozessübergreifende Kommunikation.
Um eine vollständige Ansicht der im Speicher zugeordneten Datei zu erstellen, geben Sie 0 (null) für den Parameter an size . Wenn Sie dies tun, kann die Größe der Ansicht größer sein 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)
- Quelle:
- MemoryMappedFile.cs
- Quelle:
- MemoryMappedFile.cs
- Quelle:
- MemoryMappedFile.cs
Erstellt einen Datenstrom, der einer Ansicht der im Speicher abgebildeten Datei zugeordnet ist und über die angegebenen Werte für Offset, Größe und Zugriffstyp verfügt.
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]
public System.IO.MemoryMappedFiles.MemoryMappedViewStream CreateViewStream (long offset, long size, System.IO.MemoryMappedFiles.MemoryMappedFileAccess access);member this.CreateViewStream : int64 * int64 * System.IO.MemoryMappedFiles.MemoryMappedFileAccess -> System.IO.MemoryMappedFiles.MemoryMappedViewStream[<System.Security.SecurityCritical>]
member 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, ab dem die Ansicht beginnen soll.
- size
- Int64
Die Größe der Ansicht. Geben Sie 0 (null) an, um eine Ansicht zu erstellen, die bei offset beginnt und ungefähr am Ende der Speicherimagedatei endet.
- access
- MemoryMappedFileAccess
Einer der Enumerationswerte, der den zulässigen Zugriffstyp für die Speicherabbilddatei angibt. Der Standardwert ist ReadWrite.
Gibt zurück
Ein Speicherdatenstrom mit den angegebenen Eigenschaften.
- Attribute
Ausnahmen
offset oder size ist ein negativer Wert.
- oder -
size ist größer als der logische Adressbereich.
- oder -
access ist kein gültiger MemoryMappedFileAccess-Enumerationswert.
access ist für die dem Speicher zugeordnete Datei ungültig.
size ist größer als der gesamte virtuelle Arbeitsspeicher.
- oder -
access ist für die dem Speicher zugeordnete Datei ungültig.
Hinweise
Sie können den von dieser Methode zurückgegebenen Stream für den sequenziellen Zugriff auf eine im Speicher zugeordnete Datei verwenden, z. B. für die prozessübergreifende Kommunikation.
Um eine vollständige Ansicht der im Speicher zugeordneten Datei zu erstellen, geben Sie 0 (null) für den Parameter an size . Wenn Sie dies tun, kann die Größe der Ansicht größer sein 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.
