[WCF]使用Svcutil.exe生成客户端代理

svcutil.exe

参数

1 /async

/async 同时生成同步和异步方法签名。

默认设置：只生成同步方法签名。

缩写形式：/a

2 /tcv:Version35

/tcv:Version35

指定应用程序针对 .NET Framework 的哪个版本。有效值为：Version30 和 Version35。默认值为 Version30。

缩写形式：/tcv

Version30：如果为使用 .NET Framework 3.0 的客户端生成代码，则使用 /tcv:Version30。

Version35：如果为使用 .NET Framework 3.5 的客户端生成代码，则使用 /tcv:Version35。如果将 /tcv:Version35
与 /async 开关一起使用，则会同时生成基于事件的异步方法和基于回调/委托的异步方法。

3/collectionType:<类型>

/collectionType:<类型>

从架构中生成代码时，指定要用作集合数据类型的完全限定或程序集限定名称。

缩写形式：/ct

4/reference:<文件路径>

/reference:<文件路径>

引用指定程序集中的类型。在生成客户端时，使用此选项来指定可能包含类型的程序集，这些类型表示所导入的元数据

。

无法使用此开关指定消息协定和 XmlSerializer 类型。

如果引用了 DateTimeOffset，则会使用此类型，而不是生成新类型。如果应用程序是使用 .NET Framework 3.5 编写

的，则 SvcUtil.exe 会自动引用 DateTimeOffset。

缩写形式：/r

5/enableDataBinding

/enableDataBinding

在所有数据协定类型上实现 INotifyPropertyChanged 接口以启用数据绑定。

缩写形式：/edb

示例：

1

生成同步，带事件的异步代码，集合使用System.Collections.ObjectModel.ObservableCollection集合，指定程序集引用

svcutil /a /d:d:/temp http://localhost:1998/Implement/AgriProductService.svc /ser:DataContractSerializer

/tcv:Version35 /ct:System.Collections.ObjectModel.ObservableCollection`1 /reference:C:/"Program

Files"/"Reference Assemblies"/Microsoft/Framework/.NETFramework/v4.0/WindowsBase.dll

2

生成同步，带事件的异步代码，集合使用System.Collections.Generic.List集合

svcutil /a /d:d:/temp http://localhost:1998/Implement/AgriProductService.svc /ser:DataContractSerializer

/tcv:Version35 /ct:System.Collections.Generic.List`1

3

生成同步，带事件的异步代码，集合映射为数组

svcutil /a /d:d:/temp http://localhost:1998/Implement/AgriProductService.svc /ser:DataContractSerializer

/tcv:Version35

关于svcutil.exe的详细介绍，可以参看微软的MSDN。

ServiceModel 元数据实用工具 (Svcutil.exe)

如果生成的代理类是要给silverlight用，还需要手动修改一下。因为silverlight不支持同步操作，所有需要删除代理类中的同步操作的代码，只保留异步的代码，还有就是需要添加下面的代码，用于open和close客户端的代码。

要是有只生成异步代码的参数就更好了，好像目前还没有发现，默认生成同步代码，加上/async参数就同时生成异步代码。

下面的代码添加到client类中，public partial class Service1Client : System.ServiceModel.ClientBase<IService1>, IService1，这个类中。

private BeginOperationDelegate onBeginOpenDelegate;

private EndOperationDelegate onEndOpenDelegate;

private System.Threading.SendOrPostCallback onOpenCompletedDelegate;

private BeginOperationDelegate onBeginCloseDelegate;

private EndOperationDelegate onEndCloseDelegate;

private System.Threading.SendOrPostCallback onCloseCompletedDelegate;

public event System.EventHandler<System.ComponentModel.AsyncCompletedEventArgs> OpenCompleted;

public event System.EventHandler<System.ComponentModel.AsyncCompletedEventArgs> CloseCompleted;

private System.IAsyncResult OnBeginOpen(object[] inValues, System.AsyncCallback callback, object asyncState)
{
return ((System.ServiceModel.ICommunicationObject)(this)).BeginOpen(callback, asyncState);
}

private object[] OnEndOpen(System.IAsyncResult result)
{
((System.ServiceModel.ICommunicationObject)(this)).EndOpen(result); return null;
}

private void OnOpenCompleted(object state)
{
if ((this.OpenCompleted != null))
{
InvokeAsyncCompletedEventArgs e = ((InvokeAsyncCompletedEventArgs)(state));
this.OpenCompleted(this, new System.ComponentModel.AsyncCompletedEventArgs(e.Error, e.Cancelled, e.UserState));
}

}

public void OpenAsync()
{
this.OpenAsync(null);
}

public void OpenAsync(object userState)
{
if ((this.onBeginOpenDelegate == null))
{
this.onBeginOpenDelegate = new BeginOperationDelegate(this.OnBeginOpen);
}
if ((this.onEndOpenDelegate == null))
{
this.onEndOpenDelegate = new EndOperationDelegate(this.OnEndOpen);
}
if ((this.onOpenCompletedDelegate == null))
{
this.onOpenCompletedDelegate = new System.Threading.SendOrPostCallback(this.OnOpenCompleted);
}
base.InvokeAsync(this.onBeginOpenDelegate, null, this.onEndOpenDelegate, this.onOpenCompletedDelegate, userState);
}

private System.IAsyncResult OnBeginClose(object[] inValues, System.AsyncCallback callback, object asyncState)
{
return ((System.ServiceModel.ICommunicationObject)(this)).BeginClose(callback, asyncState);
}

private object[] OnEndClose(System.IAsyncResult result)
{
((System.ServiceModel.ICommunicationObject)(this)).EndClose(result); return null;
}

private void OnCloseCompleted(object state)
{
if ((this.CloseCompleted != null))
{
InvokeAsyncCompletedEventArgs e = ((InvokeAsyncCompletedEventArgs)(state));
this.CloseCompleted(this, new System.ComponentModel.AsyncCompletedEventArgs(e.Error, e.Cancelled, e.UserState));
}
}

public void CloseAsync()
{
this.CloseAsync(null);
}

public void CloseAsync(object userState)
{
if ((this.onBeginCloseDelegate == null))
{
this.onBeginCloseDelegate = new BeginOperationDelegate(this.OnBeginClose);
}
if ((this.onEndCloseDelegate == null))
{
this.onEndCloseDelegate = new EndOperationDelegate(this.OnEndClose);
}
if ((this.onCloseCompletedDelegate == null))
{
this.onCloseCompletedDelegate = new System.Threading.SendOrPostCallback(this.OnCloseCompleted);
}
base.InvokeAsync(this.onBeginCloseDelegate, null, this.onEndCloseDelegate, this.onCloseCompletedDelegate, userState);
}

还要提醒大家的是，用svcutil生成的异步访问代码，直接给silverlight使用，还有有点问题的。和使用VS2010添加服务生成的代码相比，有一些出入，比如没有实现ChannelBase，没有在Client中override CreateChannel方法，还有一些局部的差异，导致使用起来会有一些不同。

出现上面的问题，不知道是我没有用对svcutil的参数，还是它们本身就是有一些不同的。