WCF Stream对象限制具体操作技巧分享

开发 开发工具
我们今天将会通过几个步骤来为大家详细介绍一下WCF Stream对象限制的实现方法,其中包括:对绑定的限制,对Stream对象的限制,TransferMode的限制等等。

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类型的转换。例如在服务契约的操作中,有如下的实现:

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

注意,操作TransferDocument()的返回类型为Stream,而方法的实现中,返回的对象则为FileStream类型。由于Stream类是FileStream类的父类,这样的实现没有问题。

然而,在客户端调用该操作时,却不能将操作的返回值赋给FileStream类型的对象,如下所示:

  1. FileStream stream = m_service.TransferDocument(doc);  

此时获得的Stream对象则为null。因而,我们只能这样调用操作:

  1. 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)。如果设置值不在该范围之内,则无法通过编译。编程方式设置为:

  1. < binding …… maxReceivedMessageSize="120000"/> 

WCF Stream对象限制操作步骤之 5、操作参数的限制

WCF Stream操作参数严格的限制,它只允许这样的操作只能包含一个Stream对象,这里所谓的一个WCF Stream对象,是包含return对象,out和ref对象在内的。也就是说如下的操作定义都是错误的:

  1. void Transfer(Stream s1, Stream s2);   
  2. void Transfer(Stream s1, out Stream s2);   
  3. void Transfer(Stream s1, ref Stream s2);   
  4. Stream Transfer(Stream stream);  

如果定义了这样的操作,则会出现运行时错误。

此外,由于传输的WCF Stream对象较大,可能会消耗过长的时间,因而建议增大绑定的SendTimeout属性值。例如设置为10分钟。编程方式设置为:

  1. binding.SendTimeout = TimeSpan.FromMinutes(10);  

配置文件的设置方式为:

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

注意,对绑定的相关设置必须要求服务端与客户端的配置一致。最佳实践是均通过配置文件进行设置。例如在我的应用程序中是这样设置的:

 

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

以上就是对WCF Stream对象限制的相关内容介绍。

责任编辑:曹凯 来源: IT专家网
相关推荐

2009-11-06 16:35:56

WCF Stream对

2010-02-24 17:41:05

WCF集合反序列化

2010-02-24 13:06:27

WCF使用Nhiber

2010-03-02 09:39:11

保护WCF服务

2010-03-02 16:15:59

WCF控制事务

2010-01-22 10:54:06

VB.NET结构变量

2009-11-05 15:00:26

WCF Stream

2010-03-01 14:56:48

WCF服务引用

2009-11-09 13:47:22

WCF Stream操

2010-02-25 15:25:19

WCF通道

2010-02-23 13:03:34

WCF序列化

2011-03-17 09:06:58

iptables映射端口

2009-12-30 15:47:40

Silverlight

2010-01-15 15:51:43

VB.NET类添加方法

2010-02-24 17:07:26

WCF序列化引擎

2010-08-02 12:34:09

ADSL代理设置

2009-12-31 15:36:13

SilverLight

2010-08-02 17:20:12

nfs启动Linux

2010-07-26 13:30:23

2009-12-31 15:36:13

SilverLight
点赞
收藏

51CTO技术栈公众号