WCF Stream對象限制具體操作技巧分享
WCF開發工具的設計操作技巧比較繁多，要想全部掌握這些應用技術是一件比較困難的事情。我們需要在不斷地實踐中去積累經驗來達到一個熟練應用的程度。首先我們將會在這里為大家詳細介紹一下WCF Stream對象限制的相關操作。#t#
WCF支持Stream操作，尤其對于傳遞size過大的消息而言，如要考慮傳遞消息的效率，WCF推薦通過Stream進行操作。然而，WCF Stream操作規定了一些限制，在我們編寫相關程序時，需要特別注意：
WCF Stream對象限制操作步驟之1、綁定的限制
如果需要使用Stream操作，可以使用的綁定只能是BasicHttpBinding，NetTcpBinding以及NetNamedPipeBinding。此外，在使用Stream操作時，不能使用Reliable Messaging。如果考慮到消息安全，則此方式是不可取的。
WCF Stream對象限制操作步驟之2、對Stream對象的限制
要作為服務操作所傳遞的消息對象，這樣的對象必須是可序列化的。遺憾的是，FileStream類的定義卻是不支持序列化的，我們能夠使用的Stream 對象，包括Stream，MemoryStream等。使用Stream類對象是大多數Stream操作的首選。一個有趣的現象是FileStream與Stream類型的轉換。例如在服務契約的操作中，有如下的實現：
- public Stream TransferDocument(Document document)
- {
- FileStream stream = new FileStream (document.LocalPath,
FileMode.Open, FileAccess.Read);- return stream;
- }
注意，操作TransferDocument()的返回類型為Stream，而方法的實現中，返回的對象則為FileStream類型。由于Stream類是FileStream類的父類，這樣的實現沒有問題。
然而，在客戶端調用該操作時，卻不能將操作的返回值賦給FileStream類型的對象，如下所示：
- FileStream stream = m_service.TransferDocument(doc);
此時獲得的Stream對象則為null。因而，我們只能這樣調用操作：
- Stream stream = m_service.TransferDocument(doc);
但是，還有一個奇怪的問題是WCF并不支持Stream對象Length屬性的序列化，也就是說，在客戶端我們不能使用服務操作返回的Stream對象的 Length屬性。諸如stream.Length的調用會拋出NotSupportedException異常。
WCF Stream對象限制操作步驟之3、TransferMode的限制
若要使用Stream操作，必須修改綁定的TransferMode屬性。該屬性的默認值為Buffered。我們應該根據操作中WCF Stream對象的參數類型，以決定TransferMode的值分別為Streamed、StreamedRequest或者StreamedResponse。
WCF Stream對象限制操作步驟之4、MaxReceivedMessageSize的限制
MaxReceivedMessageSize屬性的默認值為64kb，如果傳遞的Stream對象一旦超過了 MaxReceivedMessageSize屬性的設置值，則客戶端在操作該對象時，就會出現CommunicationException異常。因此，我們應根據實際需要設置MaxReceivedMessageSize的值。MaxReceivedMessageSize屬性的取值范圍為 1-9223372036854775807（Int32.MaxValue）。如果設置值不在該范圍之內，則無法通過編譯。編程方式設置為：
- < binding …… maxReceivedMessageSize="120000"/>
WCF Stream對象限制操作步驟之 5、操作參數的限制
WCF Stream操作參數嚴格的限制，它只允許這樣的操作只能包含一個Stream對象，這里所謂的一個WCF Stream對象，是包含return對象，out和ref對象在內的。也就是說如下的操作定義都是錯誤的：
- void Transfer(Stream s1, Stream s2);
- void Transfer(Stream s1, out Stream s2);
- void Transfer(Stream s1, ref Stream s2);
- Stream Transfer(Stream stream);
如果定義了這樣的操作，則會出現運行時錯誤。
此外，由于傳輸的WCF Stream對象較大，可能會消耗過長的時間，因而建議增大綁定的SendTimeout屬性值。例如設置為10分鐘。編程方式設置為：
- binding.SendTimeout = TimeSpan.FromMinutes(10);
配置文件的設置方式為：
- < binding …… sendTimeout="00:10:00"/>
注意，對綁定的相關設置必須要求服務端與客戶端的配置一致。最佳實踐是均通過配置文件進行設置。例如在我的應用程序中是這樣設置的：
- < basicHttpBinding>
- < binding name="DocumentExplorerServiceBinding" sendTimeout="00:10:00"
transferMode="Streamed" messageEncoding="Text"
textEncoding="utf-8" maxReceivedMessageSize="9223372036854775807">- < /binding>
- < /basicHttpBinding>
以上就是對WCF Stream對象限制的相關內容介紹。
