MemoryMappedFile.CreateViewStream 方法

定義

命名空間:

System.IO.MemoryMappedFiles

組件:

System.IO.MemoryMappedFiles.dll

建立對應於記憶體對應檔檢視的資料流。

多載

CreateViewStream()	建立對應於記憶體對應檔檢視的資料流。
CreateViewStream(Int64, Int64)	建立資料流，此資料流可對應到記憶體對應檔案的檢視，並且有指定的位移和大小。
CreateViewStream(Int64, Int64, MemoryMappedFileAccess)	建立資料流，此資料流可對應到記憶體對應檔案的檢視，並且有指定位移、大小和存取類型。

CreateViewStream()

來源:

MemoryMappedFile.cs

建立對應於記憶體對應檔檢視的資料流。

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

傳回

MemoryMappedViewStream

記憶體資料流。

例外狀況

UnauthorizedAccessException

未授權存取記憶體對應檔案。

範例

下列範例會建立數據流，並將值寫入其中。 此程式代碼範例是方法所提供較大範例的 CreateNew 一部分。

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

備註

您可以使用這個方法傳回的數據流來循序存取記憶體對應檔案，例如進程間通訊。

另請參閱

• 記憶體對應檔案

CreateViewStream(Int64, Int64)

來源:

MemoryMappedFile.cs

建立資料流，此資料流可對應到記憶體對應檔案的檢視，並且有指定的位移和大小。

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

參數

offset

Int64

檢視會在此處開始的位元組。

size

Int64

檢視的大小。 指定 0 (零)，建立在 offset 開始，而大約在記憶體對應檔結尾結束的檢視。

傳回

MemoryMappedViewStream

記憶體資料流，具有指定的位移和大小。

例外狀況

ArgumentOutOfRangeException

offset 或 size 為負值。

-或-

size 大於邏輯位址空間。

UnauthorizedAccessException

未授權存取記憶體對應檔案。

IOException

size 大於總虛擬記憶體。

備註

您可以使用這個方法傳回的數據流來循序存取記憶體對應檔案，例如進程間通訊。

若要建立記憶體對應檔案的完整檢視，請為 size 參數指定 0 (零) 。 如果您這樣做，檢視的大小可能大於磁碟上來源檔案的大小。 這是因為檢視是以系統頁面單位提供，而檢視的大小會四捨五入到下一個系統頁面大小。

另請參閱

• 記憶體對應檔案

CreateViewStream(Int64, Int64, MemoryMappedFileAccess)

來源:

MemoryMappedFile.cs

建立資料流，此資料流可對應到記憶體對應檔案的檢視，並且有指定位移、大小和存取類型。

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);

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

參數

offset

Int64

檢視會在此處開始的位元組。

size

Int64

檢視的大小。 指定 0 (零)，建立在 offset 開始，而大約在記憶體對應檔結尾結束的檢視。

access

MemoryMappedFileAccess

其中一個列舉值，指定記憶體對應檔允許的存取類型。 預設為 ReadWrite。

傳回

MemoryMappedViewStream

記憶體資料流，具有指定的特性。

例外狀況

ArgumentOutOfRangeException

offset 或 size 為負值。

-或-

size 大於邏輯位址空間。

-或-

access 不是有效的 MemoryMappedFileAccess 列舉值。

UnauthorizedAccessException

access 是無效的記憶體對應檔案。

IOException

size 大於總虛擬記憶體。

-或-

access 是無效的記憶體對應檔案。

備註

您可以使用這個方法傳回的數據流來循序存取記憶體對應檔案，例如進程間通訊。

若要建立記憶體對應檔案的完整檢視，請為 size 參數指定 0 (零) 。 如果您這樣做，檢視的大小可能大於磁碟上來源檔案的大小。 這是因為檢視是以系統頁面單位提供，而檢視的大小會四捨五入到下一個系統頁面大小。

另請參閱

• 記憶體對應檔案