HOW TO：啟用資料流
Windows Communication Foundation (WCF) 可以透過緩衝處理或資料流處理的傳輸來傳送訊息。在預設的緩衝傳輸模式中，必須完整傳遞訊息，接收者才能讀取。在資料流傳輸模式中，接收者不需等到訊息完全送達，就可以開始處理訊息。當資訊的傳遞很漫長，但是可依序列處理時，使用資料流模式將十分有幫助。當訊息太龐大而無法完整加以緩衝時，資料流模式也很有用處。
若要啟用資料流處理，請適當定義 OperationContract 並在傳輸層級啟用資料流處理。
若要以資料流方式處理資料
若要以資料流方式處理資料，服務的 OperationContract 必須滿足兩項需求：
- 用來存放要進行資料流處理之資料的參數，必須是方法中的唯一參數。例如，如果輸入訊息是要處理成資料流的訊息，這項處理作業就必須剛好只有一個輸入參數。同樣的，如果要將輸出訊息處理成資料流，這項作業也必須剛好只有一個輸出參數或傳回值。
- 至少有一個參數型別與傳回值必須是 Stream、Message 或 IXmlSerializable。
下列為資料流處理資料合約的範例。
GetStream作業會接收一些緩衝處理的輸入資料做為string(會經過緩衝處理，並傳回已經過資料流處理的Stream)。相反的，UploadStream會接受Stream(資料流處理的)，再傳回bool(緩衝處理的)。EchoStream會接受並傳回Stream，而這項作業也是對輸入和輸出兩種訊息都進行資料流處理的範例。最後，GetReversedStream不接受任何輸入，而只是傳回Stream(經過資料流處理)。繫結必須啟用資料流處理。您可以設定 TransferMode 屬性，並採用下列其中一個值：
- Buffered,
- Streamed，可啟用雙向資料流通訊。
- StreamedRequest，只會啟用要求的資料流處理。
- StreamedResponse，只會啟用回應的資料流處理。
BasicHttpBinding 會公開繫結上的 TransferMode 屬性，就像 NetTcpBinding 和 NetNamedPipeBinding 一樣。TransferMode 屬性也可以在傳輸繫結項目上設定，並用於自訂繫結。
下列範例說明如何透過程式碼與藉由變更組態檔來設定 TransferMode。這些範例同時都會將
maxReceivedMessageSize屬性設為 64 MB，以限制允許接收的最大訊息大小。預設的maxReceivedMessageSize是 64 KB，但這對資料流案例來說，通常是過低的。適當的配額設定取決於您的應用程式預期接收的最大訊息大小。同時請注意，maxBufferSize 會控制緩衝處理的最大大小，請適當設定。- 範例中的下列組態片段示範將 TransferMode 屬性設定為會在 basicHttpBinding 和自訂 HTTP 繫結上進行資料流處理。
- 下列程式碼片段示範將 TransferMode 屬性設定為會在 basicHttpBinding 和自訂 HTTP 繫結上進行資料流處理。
- 下列程式碼片段示範將 TransferMode 屬性設定為會在自訂 TCP 繫結上進行資料流處理。
GetStream、UploadStream和EchoStream都會處理直接從檔案傳送資料或直接將接收的資料儲存至檔案的作業。下列為GetStream程式碼。
撰寫自訂資料流
若要對每個正在傳送或接收的資料流區塊 (Chunk) 進行特殊處理，請從 Stream 衍生自訂資料流類別。下列程式碼包含
GetReversedStream方法和ReverseStream類別，是一個自訂資料流範例。GetReversedStream會建立並傳回ReverseStream的新執行個體。實際的處理會在系統從這個ReverseStream物件讀取時進行。ReverseStream.Read方法會從基礎檔案讀取位元組區塊，然後將其序列反轉，再傳回此相反序列的位元組。此方法不會反轉整個檔案內容，它只是一次反轉一個位元組區塊。下列範例說明如何在對資料流讀取內容或寫入內容時執行資料流處理。