WCF是由微軟公司創(chuàng)建的一個(gè).NET Framework 3.5的重要組成部分，它可以為開(kāi)發(fā)人員創(chuàng)建一個(gè)安全性的開(kāi)發(fā)平臺(tái)。WCF Stream的操作，尤其對(duì)于傳遞size過(guò)大的消息而言，如要考慮傳遞消息的效率，WCF推薦通過(guò)Stream進(jìn)行操作。#t#

專(zhuān)注于為中小企業(yè)提供成都網(wǎng)站設(shè)計(jì)、成都網(wǎng)站建設(shè)服務(wù),電腦端+手機(jī)端+微信端的三站合一,更高效的管理,為中小企業(yè)林甸免費(fèi)做網(wǎng)站提供優(yōu)質(zhì)的服務(wù)。我們立足成都，凝聚了一批互聯(lián)網(wǎng)行業(yè)人才，有力地推動(dòng)了上千家企業(yè)的穩(wěn)健成長(zhǎng)，幫助中小企業(yè)通過(guò)網(wǎng)站建設(shè)實(shí)現(xiàn)規(guī)模擴(kuò)充和轉(zhuǎn)變。

然而，WCF Stream操作規(guī)定了一些限制，在我們編寫(xiě)相關(guān)程序時(shí)，需要特別注意：

1、綁定的限制

如果需要使用WCF Stream操作，可以使用的綁定只能是BasicHttpBinding，NetTcpBinding以及NetNamedPipeBinding。此外，在使用Stream操作時(shí)，不能使用Reliable Messaging。如果考慮到消息安全，則此方式是不可取的。

2、對(duì)Stream對(duì)象的限制

要作為服務(wù)操作所傳遞的消息對(duì)象，這樣的對(duì)象必須是可序列化的。遺憾的是，F(xiàn)ileStream類(lèi)的定義卻是不支持序列化的，我們能夠使用的Stream對(duì)象，包括Stream，MemoryStream等。使用Stream類(lèi)對(duì)象是大多數(shù)Stream操作的選擇。

一個(gè)有趣的現(xiàn)象是FileStream與Stream類(lèi)型的轉(zhuǎn)換。例如在服務(wù)契約的操作中，有如下的實(shí)現(xiàn)：

 
 
 

  
  
  
public Stream TransferDocument(Document document) 
  
  
  
{ 
  
  
  
FileStream stream = new FileStream 
  
  
  
(document.LocalPath, FileMode.Open, FileAccess.Read); 
  
  
  
return stream; 
  
  
  
}
 
 
 

注意，操作TransferDocument()的返回類(lèi)型為Stream，而方法的實(shí)現(xiàn)中，返回的對(duì)象則為FileStream類(lèi)型。由于Stream類(lèi)是FileStream類(lèi)的父類(lèi)，這樣的實(shí)現(xiàn)沒(méi)有問(wèn)題。

然而，在客戶(hù)端調(diào)用該操作時(shí)，卻不能將操作的返回值賦給FileStream類(lèi)型的對(duì)象，如下所示：

 
 
 

  
  
  
FileStream stream = m_service.TransferDocument(doc);
 
 
 

此時(shí)獲得的WCF Stream對(duì)象則為null。因而，我們只能這樣調(diào)用操作：

 
 
 

  
  
  
Stream stream = m_service.TransferDocument(doc);
 
 
 

但是，還有一個(gè)奇怪的問(wèn)題是WCF并不支持Stream對(duì)象Length屬性的序列化，也就是說(shuō)，在客戶(hù)端我們不能使用服務(wù)操作返回的Stream對(duì)象的Length屬性。諸如stream.Length的調(diào)用會(huì)拋出NotSupportedException異常。

3、TransferMode的限制

若要使用Stream操作，必須修改綁定的TransferMode屬性。該屬性的默認(rèn)值為Buffered。我們應(yīng)該根據(jù)操作中Stream對(duì)象的參數(shù)類(lèi)型，以決定TransferMode的值分別為Streamed、StreamedRequest或者StreamedResponse。

4、MaxReceivedMessageSize的限制

MaxReceivedMessageSize屬性的默認(rèn)值為64kb，如果傳遞的Stream對(duì)象一旦超過(guò)了MaxReceivedMessageSize屬性的設(shè)置值，則客戶(hù)端在操作該對(duì)象時(shí)，就會(huì)出現(xiàn)CommunicationException異常。因此，我們應(yīng)根據(jù)實(shí)際需要設(shè)置MaxReceivedMessageSize的值。MaxReceivedMessageSize屬性的取值范圍為1-9223372036854775807（Int32.MaxValue）。如果設(shè)置值不在該范圍之內(nèi)，則無(wú)法通過(guò)編譯。編程方式設(shè)置為：

 
 
 

  
  
  
binding.MaxReceivedMessageSize = 120000;
 
 
 

配置文件的設(shè)置方式為：

 
 
 

  
  
  
< binding …… maxReceivedMessageSize="120000"/>
 
 
 

5、操作參數(shù)的限制

WCF Stream的操作參數(shù)進(jìn)行嚴(yán)格的限制，它只允許這樣的操作只能包含一個(gè)Stream對(duì)象，這里所謂的一個(gè)Stream對(duì)象，是包含return對(duì)象，out和ref對(duì)象在內(nèi)的。也就是說(shuō)如下的操作定義都是錯(cuò)誤的：

 
 
 

  
  
  
void Transfer(Stream s1, Stream s2); 
  
  
  
void Transfer(Stream s1, out Stream s2); 
  
  
  
void Transfer(Stream s1, ref Stream s2); 
  
  
  
Stream Transfer(Stream stream);
 
 
 

如果定義了這樣的操作，則會(huì)出現(xiàn)運(yùn)行時(shí)錯(cuò)誤。

6、實(shí)例激活類(lèi)型的限制

由于Stream操作受到綁定的限制，只能使用BasicHttpBinding，NetTcpBinding以及NetNamedPipeBinding綁定，因此必然會(huì)影響服務(wù)實(shí)例的激活類(lèi)型，最主要的是對(duì)Session模式的影響。首先BasicHttpBinding并不支持Session模式的激活類(lèi)型。NetTcpBinding以及NetNamedPipeBinding綁定雖然支持Session模式，但是由于Stream操作不支持可靠消息傳遞，即不能將ReliableSession設(shè)置為true。因此在定義服務(wù)契約的SessionMode時(shí)，不能將其值設(shè)置為SessionMode.Required，否則會(huì)拋出異常。

實(shí)際上，Stream操作（指TransferMode不為Buffered）本身并不支持Session模式。即使我們?cè)谑褂肗etTcpBinding時(shí)，將服務(wù)契約的SessionMode設(shè)置為Allowed，并將服務(wù)的InstanceContextMode設(shè)置為PerSession，服務(wù)的執(zhí)行方式仍然是PerCall方式。（如果不是Stream操作，這樣的設(shè)置服務(wù)應(yīng)為PerSession模式）

因此，在執(zhí)行WCF Stream操作時(shí)，即使按照Session模式對(duì)服務(wù)進(jìn)行設(shè)置，如果我們通過(guò)OperationContext.Current.SessionId去獲得會(huì)話(huà)ID，其值應(yīng)該為空。

此外，由于傳輸?shù)腟tream對(duì)象較大，可能會(huì)消耗過(guò)長(zhǎng)的時(shí)間，因而建議增大綁定的SendTimeout屬性值。例如設(shè)置為10分鐘。編程方式設(shè)置為：

 
 
 

  
  
  
binding.SendTimeout = TimeSpan.FromMinutes(10);
 
 
 

配置文件的設(shè)置方式為：

 
 
 

  
  
  
< binding …… sendTimeout="00:10:00"/>
 
 
 

注意，對(duì)綁定的相關(guān)設(shè)置必須要求服務(wù)端與客戶(hù)端的配置一致。最佳實(shí)踐是均通過(guò)配置文件進(jìn)行設(shè)置。例如在我的應(yīng)用程序中是這樣設(shè)置的：

 
 
 

  
  
  
< basicHttpBinding>
  
  
  
< binding name="DocumentExplorerServiceBinding"  
  
  
  
sendTimeout="00:10:00"  
  
  
  
transferMode="Streamed"
  
  
  
messageEncoding="Text"  
  
  
  
textEncoding="utf-8"  
  
  
  
maxReceivedMessageSize="9223372036854775807">  
  
  
  
< /binding>
  
  
  
< /basicHttpBinding>
 
 
 

以上就是對(duì)WCF Stream的相關(guān)操作方法。

當(dāng)前題目：WCFStream正確應(yīng)用指南
分享路徑：http://uogjgqi.cn/article/dpehioi.html