MemoryMappedFile.CreateViewStream MemoryMappedFile.CreateViewStream MemoryMappedFile.CreateViewStream MemoryMappedFile.CreateViewStream Method

Definition

Erstellt einen Stream, der einer Ansicht der Speicherabbilddatei zugeordnet ist.Creates a stream that maps to a view of the memory-mapped file.

Überlädt

CreateViewStream() CreateViewStream() CreateViewStream() CreateViewStream()

Erstellt einen Stream, der einer Ansicht der Speicherabbilddatei zugeordnet ist.Creates a stream that maps to a view of the memory-mapped file.

CreateViewStream(Int64, Int64) CreateViewStream(Int64, Int64) CreateViewStream(Int64, Int64) 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.Creates a stream that maps to a view of the memory-mapped file, and that has the specified offset and size.

CreateViewStream(Int64, Int64, MemoryMappedFileAccess) CreateViewStream(Int64, Int64, MemoryMappedFileAccess) CreateViewStream(Int64, Int64, MemoryMappedFileAccess) 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.Creates a stream that maps to a view of the memory-mapped file, and that has the specified offset, size, and access type.

CreateViewStream() CreateViewStream() CreateViewStream() CreateViewStream()

Erstellt einen Stream, der einer Ansicht der Speicherabbilddatei zugeordnet ist.Creates a stream that maps to a view of the memory-mapped file.

public:
 System::IO::MemoryMappedFiles::MemoryMappedViewStream ^ CreateViewStream();
public System.IO.MemoryMappedFiles.MemoryMappedViewStream CreateViewStream ();
member this.CreateViewStream : unit -> System.IO.MemoryMappedFiles.MemoryMappedViewStream
Public Function CreateViewStream () As MemoryMappedViewStream

Gibt zurück

Ausnahmen

Der Zugriff auf Speicherabbilddatei ist nicht zugelassen.Access to the memory-mapped file is unauthorized.

Beispiele

Das folgende Beispiel erstellt einen Datenstrom und schreibt einen Wert zuzuweisen.The following example creates a stream and writes a value to it. Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels für die CreateNew Methode.This code example is part of a larger example provided for the CreateNew method.

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 Stream, der von dieser Methode zurückgegeben für den sequenziellen Zugriff auf eine Datei mit zugewiesenem Speicher, z. B. für die prozessübergreifende Kommunikation verwenden.You can use the stream returned by this method for sequential access to a memory-mapped file, such as for inter-process communications.

Siehe auch

CreateViewStream(Int64, Int64) CreateViewStream(Int64, Int64) CreateViewStream(Int64, Int64) 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.Creates a stream that maps to a view of the memory-mapped file, and that has the specified offset and size.

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.MemoryMappedViewStream
Public Function CreateViewStream (offset As Long, size As Long) As MemoryMappedViewStream

Parameter

offset
Int64 Int64 Int64 Int64

Das Byte, ab dem die Ansicht beginnen soll.The byte at which to start the view.

size
Int64 Int64 Int64 Int64

Die Größe der Ansicht.The size of the view. Geben Sie 0 (null) an, um eine Ansicht zu erstellen, die bei offset beginnt und ungefähr am Ende der Speicherimagedatei endet.Specify 0 (zero) to create a view that starts at offset and ends approximately at the end of the memory-mapped file.

Gibt zurück

Ein Speicherdatenstrom mit den angegebenen Werten für Offset und Größe.A stream of memory that has the specified offset and size.

Ausnahmen

offset oder size ist ein negativer Wert.offset or size is a negative value.

- oder --or- size ist größer als der logische Adressbereich.size is greater than the logical address space.

Der Zugriff auf Speicherabbilddatei ist nicht zugelassen.Access to the memory-mapped file is unauthorized.

size ist größer als der gesamte virtuelle Arbeitsspeicher.size is greater than the total virtual memory.

Hinweise

Sie können den Stream, der von dieser Methode zurückgegeben für den sequenziellen Zugriff auf eine Datei mit zugewiesenem Speicher, z. B. für die prozessübergreifende Kommunikation verwenden.You can use the stream returned by this method for sequential access to a memory-mapped file, such as for inter-process communications.

Um einen vollständigen Überblick über die Datei mit zugewiesenem Speicher zu erstellen, geben Sie 0 (null) für die size Parameter.To create a complete view of the memory-mapped file, specify 0 (zero) for the size parameter. Wenn Sie dies tun, sind für die Größe der Ansicht möglicherweise kleiner oder größer als die Größe der Quelldatei auf dem Datenträger.If you do this, the size of the view might be smaller or larger than the size of the source file on disk. Dies ist da Ansichten werden in Einheiten der Systemseiten, die bereitgestellt werden soll, und die Größe der Ansicht auf die nächste Systemseitengröße aufgerundet wird.This is because views are provided in units of system pages, and the size of the view is rounded up to the next system page size.

Siehe auch

CreateViewStream(Int64, Int64, MemoryMappedFileAccess) CreateViewStream(Int64, Int64, MemoryMappedFileAccess) CreateViewStream(Int64, Int64, MemoryMappedFileAccess) 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.Creates a stream that maps to a view of the memory-mapped file, and that has the specified offset, size, and access type.

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
Public Function CreateViewStream (offset As Long, size As Long, access As MemoryMappedFileAccess) As MemoryMappedViewStream

Parameter

offset
Int64 Int64 Int64 Int64

Das Byte, ab dem die Ansicht beginnen soll.The byte at which to start the view.

size
Int64 Int64 Int64 Int64

Die Größe der Ansicht.The size of the view. Geben Sie 0 (null) an, um eine Ansicht zu erstellen, die bei offset beginnt und ungefähr am Ende der Speicherimagedatei endet.Specify 0 (zero) to create a view that starts at offset and ends approximately at the end of the memory-mapped file.

access
MemoryMappedFileAccess MemoryMappedFileAccess MemoryMappedFileAccess MemoryMappedFileAccess

Einer der Enumerationswerte, der den zulässigen Zugriffstyp für die Speicherabbilddatei angibt.One of the enumeration values that specifies the type of access allowed to the memory-mapped file. Der Standardwert ist ReadWrite.The default is ReadWrite.

Gibt zurück

Ein Speicherdatenstrom mit den angegebenen Eigenschaften.A stream of memory that has the specified characteristics.

Ausnahmen

offset oder size ist ein negativer Wert.offset or size is a negative value.

- oder --or- size ist größer als der logische Adressbereich.size is greater than the logical address space.

- oder --or- access ist kein gültiger MemoryMappedFileAccess-Enumerationswert.access is not a valid MemoryMappedFileAccess enumeration value.

access ist für die dem Speicher zugeordnete Datei ungültig.access is invalid for the memory-mapped file.

size ist größer als der gesamte virtuelle Arbeitsspeicher.size is greater than the total virtual memory.

- oder --or- access ist für die dem Speicher zugeordnete Datei ungültig.access is invalid for the memory-mapped file.

Hinweise

Sie können den Stream, der von dieser Methode zurückgegeben für den sequenziellen Zugriff auf eine Datei mit zugewiesenem Speicher, z. B. für die prozessübergreifende Kommunikation verwenden.You can use the stream returned by this method for sequential access to a memory-mapped file, such as for inter-process communications.

Um einen vollständigen Überblick über die Datei mit zugewiesenem Speicher zu erstellen, geben Sie 0 (null) für die size Parameter.To create a complete view of the memory-mapped file, specify 0 (zero) for the size parameter. Wenn Sie dies tun, sind für die Größe der Ansicht möglicherweise kleiner oder größer als die Größe der Quelldatei auf dem Datenträger.If you do this, the size of the view might be smaller or larger than the size of the source file on disk. Dies ist da Ansichten werden in Einheiten der Systemseiten, die bereitgestellt werden soll, und die Größe der Ansicht auf die nächste Systemseitengröße aufgerundet wird.This is because views are provided in units of system pages, and the size of the view is rounded up to the next system page size.

Sicherheit

SecurityPermission
für den Zugriff von nicht verwaltetem Code.for access to unmanaged code. Zugeordnete Enumeration: UnmanagedCodeAssociated enumeration: UnmanagedCode.

Siehe auch

Gilt für: