MemoryMappedFile.CreateViewStream Método

Definição

Namespace:

System.IO.MemoryMappedFiles

Assembly:

System.IO.MemoryMappedFiles.dll

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

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

MemoryMappedViewStream

Um fluxo de memória.

Exceções

UnauthorizedAccessException

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

• Arquivos mapeados em memória

CreateViewStream(Int64, Int64)

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

MemoryMappedViewStream

Um fluxo de memória que tem o deslocamento e tamanho especificados.

Exceções

ArgumentOutOfRangeException

offset ou size é um valor negativo.

- ou -

size é maior que o espaço de endereço lógico.

UnauthorizedAccessException

O acesso ao arquivo mapeado na memória não está autorizado.

IOException

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

• Arquivos mapeados em memória

CreateViewStream(Int64, Int64, MemoryMappedFileAccess)

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

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

MemoryMappedViewStream

Um fluxo de memória que tem as características especificadas.

Exceções

ArgumentOutOfRangeException

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.

UnauthorizedAccessException

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

IOException

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

• Arquivos mapeados em memória