MemoryMappedFile.CreateViewStream Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Cria um fluxo que mapeia para uma vista do ficheiro mapeado em memória.
Sobrecargas
| Name | Description |
|---|---|
| CreateViewStream() |
Cria um fluxo que mapeia para uma vista do ficheiro mapeado em memória. |
| CreateViewStream(Int64, Int64) |
Cria um fluxo que mapeia para uma vista do ficheiro mapeado em memória, e que tem o deslocamento e tamanho especificados. |
| CreateViewStream(Int64, Int64, MemoryMappedFileAccess) |
Cria um fluxo que mapeia para uma vista do ficheiro mapeado em memória, e que tem o deslocamento, tamanho e tipo de acesso especificados. |
CreateViewStream()
Cria um fluxo que mapeia para uma vista do ficheiro mapeado em 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 MemoryMappedViewStreamDevoluções
Um fluxo de memória.
Exceções
O acesso ao ficheiro mapeado em memória é não autorizado.
Exemplos
O exemplo seguinte cria um fluxo e escreve 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
Observações
Pode usar o fluxo devolvido por este método para acesso sequencial a um ficheiro mapeado em memória, como para comunicações entre processos.
Ver também
Aplica-se a
CreateViewStream(Int64, Int64)
Cria um fluxo que mapeia para uma vista do ficheiro mapeado em memória, e que tem o deslocamento e 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 a partir do qual iniciar a visualização.
- size
- Int64
O tamanho da vista. Especifique 0 (zero) para criar uma vista que comece e offset termine aproximadamente no final do ficheiro mapeado em memória.
Devoluções
Um fluxo de memória com o deslocamento e tamanho especificados.
Exceções
offset ou size é um valor negativo.
-ou-
size é maior do que o espaço de endereçamento lógico.
O acesso ao ficheiro mapeado em memória é não autorizado.
size é maior do que a memória virtual total.
Observações
Pode usar o fluxo devolvido por este método para acesso sequencial a um ficheiro mapeado em memória, como para comunicações entre processos.
Para criar uma vista completa do ficheiro mapeado em memória, especifique 0 (zero) para o size parâmetro. Se fizeres isto, o tamanho da vista pode ser maior do que o tamanho do ficheiro de origem no disco. Isto deve-se ao facto de as visualizações serem fornecidas em unidades de páginas do sistema, e o tamanho da vista é arredondado para o tamanho seguinte da página do sistema.
Ver também
Aplica-se a
CreateViewStream(Int64, Int64, MemoryMappedFileAccess)
Cria um fluxo que mapeia para uma vista do ficheiro mapeado em memória, e que tem o deslocamento, tamanho e 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 a partir do qual iniciar a visualização.
- size
- Int64
O tamanho da vista. Especifique 0 (zero) para criar uma vista que comece e offset termine aproximadamente no final do ficheiro mapeado em memória.
- access
- MemoryMappedFileAccess
Um dos valores de enumeração que especifica o tipo de acesso permitido ao ficheiro mapeado em memória. A predefinição é ReadWrite.
Devoluções
Um fluxo de memória com as características especificadas.
- Atributos
Exceções
offset ou size é um valor negativo.
-ou-
size é maior do que o espaço de endereçamento lógico.
-ou-
access não é um valor de enumeração válido MemoryMappedFileAccess .
access é inválido para o ficheiro mapeado em memória.
size é maior do que a memória virtual total.
-ou-
access é inválido para o ficheiro mapeado em memória.
Observações
Pode usar o fluxo devolvido por este método para acesso sequencial a um ficheiro mapeado em memória, como para comunicações entre processos.
Para criar uma vista completa do ficheiro mapeado em memória, especifique 0 (zero) para o size parâmetro. Se fizeres isto, o tamanho da vista pode ser maior do que o tamanho do ficheiro de origem no disco. Isto deve-se ao facto de as visualizações serem fornecidas em unidades de páginas do sistema, e o tamanho da vista é arredondado para o tamanho seguinte da página do sistema.