PackagePart.GetStream Метод

Определение

Пространство имен:

System.IO.Packaging

Сборка:

System.IO.Packaging.dll

Пакет:

System.IO.Packaging v8.0.0

Возвращает поток данных содержимого части.

Перегрузки

GetStream()	Возвращает поток данных содержимого части.
GetStream(FileMode)	Возвращает поток содержимого, открытый в указанном режиме ввода-вывода FileMode.
GetStream(FileMode, FileAccess)	Возвращает поток содержимого части, открытый в указанных режимах FileMode и FileAccess.

GetStream()

Исходный код:

PackagePart.cs

Возвращает поток данных содержимого части.

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

public System.IO.Stream GetStream ();

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

Public Function GetStream () As Stream

Возвращаемое значение

Stream

Поток данных содержимого части.

Исключения

InvalidOperationException

Данная часть была удалена.

-или-

Объект Package не открыт (вызван метод Dispose(Boolean) или Close()).

IOException

Метод GetStreamCore(FileMode, FileAccess) производного подкласса возвращает null в качестве объекта потока.

Комментарии

Этот метод открывает поток содержимого с разрешениями и FileAccess , которые совпадают с FileModeOpenOrCreate разрешениями родительского объекта Package.

Метод перегрузки GetStream позволяет задать определенный FileMode.

Примечания для тех, кто вызывает этот метод

GetStream() внутренне вызывает производный GetStreamCore(FileMode, FileAccess) метод, чтобы фактически открыть и вернуть поток данных части на основе физического формата, реализованного в производном классе.

По умолчанию предоставляется ZipPackagePart и используется реализация подкласса абстрактного PackagePart класса. В операции GetStream() по умолчанию внутренние ZipPackagePart вызовы GetStreamCore(FileMode, FileAccess) класса , чтобы открыть и вернуть поток данных части из ZIP-файла.

GetStream(FileMode)

Исходный код:

PackagePart.cs

Возвращает поток содержимого, открытый в указанном режиме ввода-вывода FileMode.

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

Параметры

mode

FileMode

Режим ввода-вывода, в котором требуется открыть поток содержимого.

Возвращаемое значение

Stream

Поток содержимого части.

Исключения

InvalidOperationException

Данная часть была удалена.

-или-

Объект Package не открыт (вызван метод Dispose(Boolean) или Close()).

ArgumentOutOfRangeException

Параметр mode не является допустимым значением перечисления FileMode.

IOException

Параметр mode несовместим с потоком пакета и части.

-или-

Метод GetStreamCore(FileMode, FileAccess) производного подкласса возвращает null в качестве объекта потока.

Комментарии

Разрешения FileAccess возвращаемого потока содержимого совпадают с разрешениями родительского Package.

Примечания для тех, кто вызывает этот метод

GetStream(FileMode) внутренне вызывает производный GetStreamCore(FileMode, FileAccess) метод, чтобы фактически открыть и вернуть поток данных части на основе физического формата, реализованного в производном классе.

По умолчанию предоставляется ZipPackagePart и используется реализация подкласса абстрактного PackagePart класса. В операции GetStream(FileMode) по умолчанию внутренние ZipPackagePart вызовы GetStreamCore(FileMode, FileAccess) класса , чтобы открыть и вернуть поток данных части из ZIP-файла.

GetStream(FileMode, FileAccess)

Исходный код:

PackagePart.cs

Возвращает поток содержимого части, открытый в указанных режимах FileMode и FileAccess.

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

Параметры

mode

FileMode

Режим ввода-вывода, в котором требуется открыть поток содержимого.

access

FileAccess

Права доступа, используемые при открытии потока содержимого.

Возвращаемое значение

Stream

Поток содержимого части.

Исключения

InvalidOperationException

Данная часть была удалена.

-или-

Объект Package не открыт (вызван метод Dispose(Boolean) или Close()).

ArgumentOutOfRangeException

Параметр mode не является допустимым значением перечисления FileMode.

-или-

Параметр access не является допустимым значением перечисления FileAccess.

IOException

Параметр mode или access несовместим с потоком пакета и части.

-или-

В качестве параметра access задано Read, но режим mode требует доступа для записи. (Значения FileMode, равные Create, CreateNew, Truncate или Append, требуют доступа Write или ReadWrite.)

-или-

Метод GetStreamCore(FileMode, FileAccess) производного подкласса возвращает null в качестве объекта потока.

Примечания для тех, кто вызывает этот метод

GetStream(FileMode, FileAccess) внутренне вызывает производный GetStreamCore(FileMode, FileAccess) метод, чтобы фактически открыть и вернуть поток данных части на основе физического формата, реализованного в производном классе.

По умолчанию предоставляется ZipPackagePart и используется реализация подкласса абстрактного PackagePart класса. В операции GetStream(FileMode, FileAccess) по умолчанию внутренние ZipPackagePart вызовы GetStreamCore(FileMode, FileAccess) класса , чтобы открыть и вернуть поток данных части из ZIP-файла.