本篇內(nèi)容主要講解“WCF Stream對象限制操作是怎樣的”,感興趣的朋友不妨來看看。本文介紹的方法操作簡單快捷,實用性強。下面就讓小編來帶大家學習“WCF Stream對象限制操作是怎樣的”吧!
讓客戶滿意是我們工作的目標,不斷超越客戶的期望值來自于我們對這個行業(yè)的熱愛。我們立志把好的技術(shù)通過有效、簡單的方式提供給客戶,將通過不懈努力成為客戶在信息化領域值得信任、有價值的長期合作伙伴,公司提供的服務項目有:主機域名、網(wǎng)絡空間、營銷軟件、網(wǎng)站建設、長白網(wǎng)站維護、網(wǎng)站推廣。
WCF支持Stream操作,尤其對于傳遞size過大的消息而言,如要考慮傳遞消息的效率,WCF推薦通過Stream進行操作。然而,WCF Stream操作規(guī)定了一些限制,在我們編寫相關程序時,需要特別注意:
1、綁定的限制
如果需要使用Stream操作,可以使用的綁定只能是BasicHttpBinding,NetTcpBinding以及NetNamedPipeBinding。此外,在使用Stream操作時,不能使用Reliable Messaging。如果考慮到消息安全,則此方式是不可取的。
2、對Stream對象的限制
要作為服務操作所傳遞的消息對象,這樣的對象必須是可序列化的。遺憾的是,F(xiàn)ileStream類的定義卻是不支持序列化的,我們能夠使用的Stream 對象,包括Stream,MemoryStream等。使用Stream類對象是大多數(shù)Stream操作的***。一個有趣的現(xiàn)象是FileStream與Stream類型的轉(zhuǎn)換。例如在服務契約的操作中,有如下的實現(xiàn):
public Stream TransferDocument(Document document) { FileStream stream = new FileStream (document.LocalPath, FileMode.Open, FileAccess.Read); return stream; }
注意,操作TransferDocument()的返回類型為Stream,而方法的實現(xiàn)中,返回的對象則為FileStream類型。由于Stream類是FileStream類的父類,這樣的實現(xiàn)沒有問題。
然而,在客戶端調(diào)用該操作時,卻不能將操作的返回值賦給FileStream類型的對象,如下所示:
FileStream stream = m_service.TransferDocument(doc);
此時獲得的Stream對象則為null。因而,我們只能這樣調(diào)用操作:
Stream stream = m_service.TransferDocument(doc);
但是,還有一個奇怪的問題是WCF并不支持Stream對象Length屬性的序列化,也就是說,在客戶端我們不能使用服務操作返回的Stream對象的 Length屬性。諸如stream.Length的調(diào)用會拋出NotSupportedException異常。
3、TransferMode的限制
若要使用Stream操作,必須修改綁定的TransferMode屬性。該屬性的默認值為Buffered。我們應該根據(jù)操作中WCF Stream對象的參數(shù)類型,以決定TransferMode的值分別為Streamed、StreamedRequest或者StreamedResponse。
4、MaxReceivedMessageSize的限制
MaxReceivedMessageSize屬性的默認值為64kb,如果傳遞的Stream對象一旦超過了 MaxReceivedMessageSize屬性的設置值,則客戶端在操作該對象時,就會出現(xiàn)CommunicationException異常。因此,我們應根據(jù)實際需要設置MaxReceivedMessageSize的值。MaxReceivedMessageSize屬性的取值范圍為 1-9223372036854775807(Int32.MaxValue)。如果設置值不在該范圍之內(nèi),則無法通過編譯。編程方式設置為:
<binding …… maxReceivedMessageSize="120000"/>
5、操作參數(shù)的限制
WCF Stream操作參數(shù)嚴格的限制,它只允許這樣的操作只能包含一個Stream對象,這里所謂的一個WCF Stream對象,是包含return對象,out和ref對象在內(nèi)的。也就是說如下的操作定義都是錯誤的:
void Transfer(Stream s1, Stream s2); void Transfer(Stream s1, out Stream s2); void Transfer(Stream s1, ref Stream s2); Stream Transfer(Stream stream);
如果定義了這樣的操作,則會出現(xiàn)運行時錯誤。
此外,由于傳輸?shù)腤CF 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對象限制操作是怎樣的”有了更深的了解,不妨來實際操作一番吧!這里是創(chuàng)新互聯(lián)網(wǎng)站,更多相關內(nèi)容可以進入相關頻道進行查詢,關注我們,繼續(xù)學習!
分享題目:WCFStream對象限制操作是怎樣的
當前地址:http://chinadenli.net/article20/gpceco.html
成都網(wǎng)站建設公司_創(chuàng)新互聯(lián),為您提供定制網(wǎng)站、網(wǎng)站策劃、自適應網(wǎng)站、面包屑導航、App開發(fā)、全網(wǎng)營銷推廣
聲明:本網(wǎng)站發(fā)布的內(nèi)容(圖片、視頻和文字)以用戶投稿、用戶轉(zhuǎn)載內(nèi)容為主,如果涉及侵權(quán)請盡快告知,我們將會在第一時間刪除。文章觀點不代表本網(wǎng)站立場,如需處理請聯(lián)系客服。電話:028-86922220;郵箱:631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載,或轉(zhuǎn)載時需注明來源: 創(chuàng)新互聯(lián)