MemoryMappedFile.CreateViewStream Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Cria um fluxo que é mapeado para uma exibição do arquivo mapeado pela memória.
Sobrecargas
| Nome | Description |
|---|---|
| CreateViewStream() |
Cria um fluxo que é mapeado para uma exibição do arquivo mapeado pela memória. |
| CreateViewStream(Int64, Int64) |
Cria um fluxo que é mapeado para uma exibição do arquivo mapeado pela memória e que tem o deslocamento e o tamanho especificados. |
| CreateViewStream(Int64, Int64, MemoryMappedFileAccess) |
Cria um fluxo que é mapeado para uma exibição do arquivo mapeado pela memória e que tem o deslocamento, o tamanho e o tipo de acesso especificados. |
CreateViewStream()
Cria um fluxo que é mapeado para uma exibição do arquivo mapeado pela memória.
public:
System::IO::MemoryMappedFiles::MemoryMappedViewStream ^ CreateViewStream();public System.IO.MemoryMappedFiles.MemoryMappedViewStream CreateViewStream();member this.CreateViewStream : unit -> System.IO.MemoryMappedFiles.MemoryMappedViewStreamPublic Function CreateViewStream () As MemoryMappedViewStreamRetornos
Um fluxo de memória.
Exceções
O acesso ao arquivo mapeado pela memória não é autorizado.
Exemplos
O exemplo a seguir cria um fluxo e grava um valor nele. Este exemplo de código faz parte de um exemplo maior fornecido para o CreateNew método.
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
Comentários
Você pode usar o fluxo retornado por esse método para acesso sequencial a um arquivo mapeado por memória, como para comunicações entre processos.
Confira também
Aplica-se a
CreateViewStream(Int64, Int64)
Cria um fluxo que é mapeado para uma exibição do arquivo mapeado pela memória e que tem o deslocamento e o tamanho especificados.
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 MemoryMappedViewStreamParâmetros
- offset
- Int64
O byte no qual iniciar a exibição.
- size
- Int64
O tamanho da exibição. Especifique 0 (zero) para criar um modo de exibição que começa offset e termina aproximadamente no final do arquivo mapeado pela memória.
Retornos
Um fluxo de memória que tem o deslocamento e o tamanho especificados.
Exceções
offset ou size é um valor negativo.
-ou-
size é maior que o espaço de endereço lógico.
O acesso ao arquivo mapeado pela memória não é autorizado.
size é maior que a memória virtual total.
Comentários
Você pode usar o fluxo retornado por esse método para acesso sequencial a um arquivo mapeado por memória, como para comunicações entre processos.
Para criar uma exibição completa do arquivo mapeado pela memória, especifique 0 (zero) para o size parâmetro. Se você fizer isso, o tamanho da exibição poderá ser maior que o tamanho do arquivo de origem no disco. Isso ocorre porque as exibições são fornecidas em unidades de páginas do sistema e o tamanho da exibição é arredondado para o próximo tamanho de página do sistema.
Confira também
Aplica-se a
CreateViewStream(Int64, Int64, MemoryMappedFileAccess)
Cria um fluxo que é mapeado para uma exibição do arquivo mapeado pela memória e que tem o deslocamento, o tamanho e o tipo de acesso especificados.
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 MemoryMappedViewStreamParâmetros
- offset
- Int64
O byte no qual iniciar a exibição.
- size
- Int64
O tamanho da exibição. Especifique 0 (zero) para criar um modo de exibição que começa offset e termina aproximadamente no final do arquivo mapeado pela memória.
- access
- MemoryMappedFileAccess
Um dos valores de enumeração que especifica o tipo de acesso permitido ao arquivo mapeado pela memória. O padrão é ReadWrite.
Retornos
Um fluxo de memória que tem as características especificadas.
- Atributos
Exceções
offset ou size é um valor negativo.
-ou-
size é maior que o espaço de endereço lógico.
-ou-
access não é um valor de enumeração válido MemoryMappedFileAccess .
access é inválido para o arquivo mapeado em memória.
size é maior que a memória virtual total.
-ou-
access é inválido para o arquivo mapeado em memória.
Comentários
Você pode usar o fluxo retornado por esse método para acesso sequencial a um arquivo mapeado por memória, como para comunicações entre processos.
Para criar uma exibição completa do arquivo mapeado pela memória, especifique 0 (zero) para o size parâmetro. Se você fizer isso, o tamanho da exibição poderá ser maior que o tamanho do arquivo de origem no disco. Isso ocorre porque as exibições são fornecidas em unidades de páginas do sistema e o tamanho da exibição é arredondado para o próximo tamanho de página do sistema.