PackagePart.GetStream 方法

定義

命名空間:

System.IO.Packaging

組件:

System.IO.Packaging.dll

套件:

System.IO.Packaging v8.0.0

傳回部分內容資料流。

多載

GetStream()	傳回部分內容資料流。
GetStream(FileMode)	傳回在指定之 I/O 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。

備註

這個方法會使用 與父 Package代 相同的 和 FileAccess 許可權來開啟內容數據流FileModeOpenOrCreate。

多載 GetStream 方法可讓您設定特定的 FileMode。

給呼叫者的注意事項

GetStream() 內部會呼叫衍生 GetStreamCore(FileMode, FileAccess) 方法，根據衍生類別中實作的實體格式，實際開啟並傳回元件數據流。

根據預設， ZipPackagePart 會提供並使用抽象 PackagePart 類的子類別實作。 在預設作業中， GetStream() 會在內部呼叫 GetStreamCore(FileMode, FileAccess)ZipPackagePart 類別，以開啟並傳回 ZIP 檔案中的元件數據流。

GetStream(FileMode)

來源:

PackagePart.cs

傳回在指定之 I/O 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

開啟內容資料流的 I/O 模式。

傳回

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) 會在內部呼叫 GetStreamCore(FileMode, FileAccess)ZipPackagePart 類別，以開啟並傳回 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

開啟內容資料流的 I/O 模式。

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) 會在內部呼叫 GetStreamCore(FileMode, FileAccess)ZipPackagePart 類別，以開啟並傳回 ZIP 檔案中的元件數據流。