Partilhar via


MemoryMappedFile.CreateViewStream Método

Definição

Cria um fluxo que mapeia uma exibição do arquivo mapeado na memória.

Sobrecargas

CreateViewStream()

Cria um fluxo que mapeia uma exibição do arquivo mapeado na memória.

CreateViewStream(Int64, Int64)

Cria um fluxo que é mapeado para uma exibição do arquivo mapeado em memória e que tem o deslocamento e tamanho especificados.

CreateViewStream(Int64, Int64, MemoryMappedFileAccess)

Cria um fluxo que é mapeado para uma exibição do arquivo mapeado em memória e que tem o deslocamento, tamanho e tipo de acesso especificados.

CreateViewStream()

Origem:
MemoryMappedFile.cs
Origem:
MemoryMappedFile.cs
Origem:
MemoryMappedFile.cs

Cria um fluxo que mapeia uma exibição do arquivo mapeado na memória.

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

Retornos

Um fluxo de memória.

Exceções

O acesso ao arquivo mapeado na memória não está 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 em memória, como para comunicações entre processos.

Confira também

Aplica-se a

CreateViewStream(Int64, Int64)

Origem:
MemoryMappedFile.cs
Origem:
MemoryMappedFile.cs
Origem:
MemoryMappedFile.cs

Cria um fluxo que é mapeado para uma exibição do arquivo 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.MemoryMappedViewStream
Public Function CreateViewStream (offset As Long, size As Long) As MemoryMappedViewStream

Parâmetros

offset
Int64

O byte no qual a exibição é iniciada.

size
Int64

O tamanho da exibição. Especifique 0 (zero) para criar uma exibição que começa em offset e termina aproximadamente no final do arquivo com mapeamento em memória.

Retornos

Um fluxo de memória que tem o deslocamento e 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 na memória não está 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 em memória, como para comunicações entre processos.

Para criar uma exibição completa do arquivo mapeado na memória, especifique 0 (zero) para o size parâmetro . Se você fizer isso, o tamanho da exibição poderá ser maior do 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 do modo de exibição é arredondado para o próximo tamanho de página do sistema.

Confira também

Aplica-se a

CreateViewStream(Int64, Int64, MemoryMappedFileAccess)

Origem:
MemoryMappedFile.cs
Origem:
MemoryMappedFile.cs
Origem:
MemoryMappedFile.cs

Cria um fluxo que é mapeado para uma exibição do arquivo 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);
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.MemoryMappedViewStream
Public Function CreateViewStream (offset As Long, size As Long, access As MemoryMappedFileAccess) As MemoryMappedViewStream

Parâmetros

offset
Int64

O byte no qual a exibição é iniciada.

size
Int64

O tamanho da exibição. Especifique 0 (zero) para criar uma exibição que começa em offset e termina aproximadamente no final do arquivo com mapeamento em memória.

access
MemoryMappedFileAccess

Um dos valores de enumeração que especifica o tipo de acesso permitido para o arquivo mapeado na 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 MemoryMappedFileAccess válido.

access é inválido para o arquivo com mapeamento em memória.

size é maior que a memória virtual total.

- ou -

access é inválido para o arquivo com mapeamento em memória.

Comentários

Você pode usar o fluxo retornado por esse método para acesso sequencial a um arquivo mapeado em memória, como para comunicações entre processos.

Para criar uma exibição completa do arquivo mapeado na memória, especifique 0 (zero) para o size parâmetro . Se você fizer isso, o tamanho da exibição poderá ser maior do 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 do modo de exibição é arredondado para o próximo tamanho de página do sistema.

Confira também

Aplica-se a