博客
关于我
强烈建议你试试无所不能的chatGPT,快点击我
WCF----Stream对象限制操作
阅读量:7191 次
发布时间:2019-06-29

本文共 2411 字,大约阅读时间需要 8 分钟。

WCF支持Stream操作,尤其对于传递size过大的消息而言,如要考虑传递消息的效率,WCF推荐通过Stream进行操作。然而,WCF Stream操作规定了一些限制,在我们编写相关程序时,需要特别注意:

  1、绑定的限制

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

  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异常。

  3、TransferMode的限制

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

  4、MaxReceivedMessageSize的限制

  MaxReceivedMessageSize属性的默认值为64kb,如果传递的Stream对象一旦超过了 MaxReceivedMessageSize属性的设置值,则客户端在操作该对象时,就会出现CommunicationException异常。因此,我们应根据实际需要设置MaxReceivedMessageSize的值。MaxReceivedMessageSize属性的取值范围为 1-9223372036854775807(Int32.MaxValue)。如果设置值不在该范围之内,则无法通过编译。编程方式设置为:

  <binding …… maxReceivedMessageSize="120000"/> 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>

 

 

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

转载于:https://www.cnblogs.com/chcong/p/4231553.html

你可能感兴趣的文章
《C语言接口与实现:创建可重用软件的技术》一导读
查看>>
Gartner最新发布:2017年十大战略技术趋势
查看>>
《21天学通C语言(第7版)》一2.4 小 结
查看>>
redis集群搭建
查看>>
从微软中国下载Windows系统并安装
查看>>
java session HttpSessionListener、HttpSessionBindingListener使用区别,实现在线人数统计以及踢出用户...
查看>>
Spring事务管理
查看>>
磁盘格式化、磁盘挂载、手动增加swap空间
查看>>
Java泛型
查看>>
智能合约语言 Solidity 教程系列1 - 类型介绍
查看>>
从0开始,搭建一个完整的Android音视频通信系统
查看>>
一张图看懂阿里云网络产品[十一]云托付
查看>>
ajax主要步骤(讲解2)
查看>>
idea中对多个maven项目打包并发布到服务器
查看>>
background-position 用法详细介绍
查看>>
windows下时间转换和获取当前时间
查看>>
EM3096二维扫描模块在手持终端设备上的应用
查看>>
HADOOP INSTALL
查看>>
openshift
查看>>
Latex 宏包编写,自定义宏包
查看>>