PackagePart.GetStream Método

Definição

Namespace:

System.IO.Packaging

Assembly:

System.IO.Packaging.dll

Pacote:

System.IO.Packaging v8.0.0

Retorna o fluxo de dados de conteúdo da parte.

Sobrecargas

GetStream()	Retorna o fluxo de dados de conteúdo da parte.
GetStream(FileMode)	Retorna o fluxo de conteúdo aberto em um FileMode de E/S especificado.
GetStream(FileMode, FileAccess)	Retorna o fluxo de conteúdo da parte aberto com um FileMode e FileAccess especificados.

GetStream()

Origem:

PackagePart.cs

Retorna o fluxo de dados de conteúdo da parte.

public:
 System::IO::Stream ^ GetStream();

public System.IO.Stream GetStream ();

member this.GetStream : unit -> System.IO.Stream

Public Function GetStream () As Stream

Retornos

Stream

O fluxo de dados de conteúdo da parte.

Exceções

InvalidOperationException

A parte foi excluída.

- ou -

O Package não está aberto (Dispose(Boolean) ou Close() foi chamado).

IOException

O objeto de fluxo retornado pelo método GetStreamCore(FileMode, FileAccess) da subclasse derivada é null.

Comentários

Esse método abre o fluxo de conteúdo com FileMode permissões e OpenOrCreateFileAccess que são iguais ao pai Package.

O método de sobrecarga GetStream permite que você defina um específico FileMode.

Notas aos Chamadores

GetStream() chama internamente o método derivado GetStreamCore(FileMode, FileAccess) para realmente abrir e retornar o fluxo de dados de parte com base no formato físico implementado na classe derivada.

Por padrão, a ZipPackagePart implementação de subclasse da classe abstrata PackagePart é fornecida e usada. Na operação padrão, GetStream() chama GetStreamCore(FileMode, FileAccess) internamente a ZipPackagePart classe para abrir e retornar o fluxo de dados de parte de um arquivo ZIP.

GetStream(FileMode)

Origem:

PackagePart.cs

Retorna o fluxo de conteúdo aberto em um FileMode de E/S especificado.

public:
 System::IO::Stream ^ GetStream(System::IO::FileMode mode);

public System.IO.Stream GetStream (System.IO.FileMode mode);

member this.GetStream : System.IO.FileMode -> System.IO.Stream

Public Function GetStream (mode As FileMode) As Stream

Parâmetros

mode

FileMode

O modo de E/S em que abrir o fluxo de conteúdo.

Retornos

Stream

O fluxo de conteúdo da parte.

Exceções

InvalidOperationException

A parte foi excluída.

- ou -

O Package não está aberto (Dispose(Boolean) ou Close() foi chamado).

ArgumentOutOfRangeException

O parâmetro mode não é um valor de enumeração FileMode válido.

IOException

O parâmetro mode não é compatível com o fluxo da parte e do pacote.

- ou -

O objeto de fluxo retornado pelo método GetStreamCore(FileMode, FileAccess) da subclasse derivada é null.

Comentários

As FileAccess permissões do fluxo de conteúdo retornado são as mesmas que as permissões do pai Package.

Notas aos Chamadores

GetStream(FileMode) chama internamente o método derivado GetStreamCore(FileMode, FileAccess) para realmente abrir e retornar o fluxo de dados de parte com base no formato físico implementado na classe derivada.

Por padrão, a ZipPackagePart implementação de subclasse da classe abstrata PackagePart é fornecida e usada. Na operação padrão, GetStream(FileMode) chama GetStreamCore(FileMode, FileAccess) internamente a ZipPackagePart classe para abrir e retornar o fluxo de dados de parte de um arquivo ZIP.

GetStream(FileMode, FileAccess)

Origem:

PackagePart.cs

Retorna o fluxo de conteúdo da parte aberto com um FileMode e FileAccess especificados.

public:
 System::IO::Stream ^ GetStream(System::IO::FileMode mode, System::IO::FileAccess access);

public System.IO.Stream GetStream (System.IO.FileMode mode, System.IO.FileAccess access);

member this.GetStream : System.IO.FileMode * System.IO.FileAccess -> System.IO.Stream

Public Function GetStream (mode As FileMode, access As FileAccess) As Stream

Parâmetros

mode

FileMode

O modo de E/S em que abrir o fluxo de conteúdo.

access

FileAccess

As permissões de acesso a serem usadas para abrir o fluxo de conteúdo.

Retornos

Stream

O fluxo de conteúdo da parte.

Exceções

InvalidOperationException

A parte foi excluída.

- ou -

O Package não está aberto (Dispose(Boolean) ou Close() foi chamado).

ArgumentOutOfRangeException

O parâmetro mode não é um valor de enumeração FileMode válido.

- ou -

O parâmetro access não é um valor de enumeração FileAccess válido.

IOException

mode ou access não é compatível com o fluxo da parte e do pacote.

- ou -

O parâmetro access é especificado como Read, mas o parâmetro mode requer acesso de gravação. (Valores FileMode de Create, CreateNew, Truncate e Append requerem o acesso Write ou ReadWrite.)

- ou -

O objeto de fluxo retornado pelo método GetStreamCore(FileMode, FileAccess) da subclasse derivada é null.

Notas aos Chamadores

GetStream(FileMode, FileAccess) chama internamente o método derivado GetStreamCore(FileMode, FileAccess) para realmente abrir e retornar o fluxo de dados de parte com base no formato físico implementado na classe derivada.

Por padrão, a ZipPackagePart implementação de subclasse da classe abstrata PackagePart é fornecida e usada. Na operação padrão, GetStream(FileMode, FileAccess) chama GetStreamCore(FileMode, FileAccess) internamente a ZipPackagePart classe para abrir e retornar o fluxo de dados de parte de um arquivo ZIP.