WCF----Stream对象限制操做

WCF支持Stream操做，尤为对于传递size过大的消息而言，如要考虑传递消息的效率，WCF推荐经过Stream进行操做。然而，WCF Stream操做规定了一些限制，在咱们编写相关程序时，须要特别注意：

　　一、绑定的限制

　　若是须要使用Stream操做，可使用的绑定只能是BasicHttpBinding，NetTcpBinding以及NetNamedPipeBinding。此外，在使用Stream操做时，不能使用Reliable Messaging。若是考虑到消息安全，则此方式是不可取的。

　　二、对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异常。

　　三、TransferMode的限制

　　若要使用Stream操做，必须修改绑定的TransferMode属性。该属性的默认值为Buffered。咱们应该根据操做中WCF Stream对象的参数类型，以决定TransferMode的值分别为Streamed、StreamedRequest或者StreamedResponse。

　　四、MaxReceivedMessageSize的限制

　　MaxReceivedMessageSize属性的默认值为64kb，若是传递的Stream对象一旦超过了 MaxReceivedMessageSize属性的设置值，则客户端在操做该对象时，就会出现CommunicationException异常。所以，咱们应根据实际须要设置MaxReceivedMessageSize的值。MaxReceivedMessageSize属性的取值范围为 1-9223372036854775807（Int32.MaxValue）。若是设置值不在该范围以内，则没法经过编译。编程方式设置为：

　　<binding …… maxReceivedMessageSize="120000"/> 五、操做参数的限制

　　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>

 

 

转自：http://www.bitscn.com/pdb/dotnet/201003/181984.html