System.ServiceModel 命名空间

项目
02/06/2013

System.ServiceModel 及其子命名空间（System.ServiceModel.Channels、System.ServiceModel.Description、System.ServiceModel.Dispatcher、System.ServiceModel.Security 和 System.ServiceModel.Security.Tokens）包含生成 Windows Communication Foundation (WCF) 服务和客户端应用程序所需的类型。

本主题显示适用于 Windows 应用商店应用的 .NET 中包括的 System.ServiceModel 命名空间中的类型。请注意，适用于 Windows 应用商店应用的 .NET 不包含每个类型的所有成员。有关各个类型的信息，请参见链接的主题。类型的文档指示适用于 Windows 应用商店应用的 .NET中包括哪些成员。

System.ServiceModel 命名空间

适用于 Windows 应用商店应用的 .NET 中支持的类型	说明
ActionNotSupportedException	当与所调用操作相关的动作和服务器中的任何操作动作都不匹配时在客户端上引发的异常。
BasicHttpBinding	表示一个绑定，服务可以使用此绑定配置和公开这样的终结点：这些终结点能够与基于 ASMX 的 Web 服务和客户端以及符合 WS-I Basic Profile 1.1 标准的其他服务进行通信。
BasicHttpMessageCredentialType	枚举在 BasicHttpBinding 绑定中启用安全时客户端可用来进行身份验证的凭据类型。
BasicHttpSecurity	配置 basicHttpBinding 绑定的安全设置。
BasicHttpSecurityMode	指定可与系统提供的 BasicHttpBinding 一起使用的安全类型。
CallbackBehaviorAttribute	在客户端应用程序中配置回调服务实现。
ChannelFactory	创建和管理客户端用来将消息发送到服务终结点的通道。
ChannelFactory<TChannel>	一个创建不同类型通道的工厂，客户端使用这些通道将消息发送到不同配置的服务终结点。
ClientBase<TChannel>	提供基实现，用于创建可调用服务的客户端对象。
ClientBase<TChannel>.BeginOperationDelegate	一个委托，由 InvokeAsync 用于调用客户端的异步操作。
ClientBase<TChannel>.ChannelBase<T>	泛型 ChannelBase 类。
ClientBase<TChannel>.EndOperationDelegate	在 InvokeAsync 成功完成对 BeginOperationDelegate 的调用时，由 InvokeAsync 调用的委托。
CommunicationException	表示服务或客户端应用程序中的通信错误。
CommunicationObjectAbortedException	在调用已中止的 ICommunicationObject 对象时引发的异常。
CommunicationObjectFaultedException	在调用出错的通信对象时引发的异常。
CommunicationState	定义 ICommunicationObject 可以存在的状态。
DataContractFormatAttribute	指示基础结构使用 DataContractSerializer。
DnsEndpointIdentity	指定服务器的 DNS 标识。
DuplexChannelFactory<TChannel>	提供创建和管理不同类型的双工通道的方式，客户端使用这些通道在服务终结点发送和接收消息。
DuplexClientBase<TChannel>	用于创建双工服务的通道，并将该通道与回调对象相关联。
EndpointAddress	提供客户端用来与服务终结点进行通信的唯一网络地址。
EndpointAddressBuilder	一个用特定属性值生成新（不可变）终结点地址的工厂。
EndpointIdentity	一个抽象类，实现此类后可提供一个标识，与终结点交换消息的客户端可以使用该标识对终结点进行身份验证。
EndpointNotFoundException	无法找到或访问远程终结点时引发的异常。
EnvelopeVersion	包含与 SOAP 版本相关的信息，该版本与消息及其交换关联。
ExceptionDetail	表示错误详细信息。
FaultCode	表示 SOAP 错误代码。
FaultContractAttribute	指定在服务操作遇到处理错误时返回的一个或多个 SOAP 错误。
FaultException	表示 SOAP 错误。
FaultException<TDetail>	用于在客户端应用程序中捕获通过协定方式指定的 SOAP 错误。
FaultReason	提供 SOAP 错误的文本说明。
FaultReasonText	表示 SOAP 错误原因的文本。
HttpBindingBase	指定基本 HTTP 绑定。
HttpClientCredentialType	枚举 HTTP 客户端的有效凭据类型。
HttpTransportSecurity	表示 WSHttpBinding 的传输级安全设置。
IClientChannel	定义出站请求的行为和客户端应用程序使用的请求/答复通道。
ICommunicationObject	为系统中所有面向通信的对象（包括通道、通道管理器、工厂、侦听器以及调度程序和服务主机）定义基本状态机的协定。
IContextChannel	定义通道的上下文控件接口。
IDefaultCommunicationTimeouts	定义用于指定通道、通道管理器（如通道侦听器和通道工厂）和服务主机所使用的通信超时的接口。
IExtensibleObject<T>	使对象可以参与自定义行为，例如注册事件或监视状态转换等。
IExtension<T>	使对象可以通过聚合扩展另一个对象。
IExtensionCollection<T>	允许按照其类型检索 IExtension<T> 的 IExtension<T> 对象集合。
InstanceContext	表示服务实例的上下文信息。
InvalidMessageContractException	表示无效的消息协定。
MessageBodyMemberAttribute	指定将成员序列化为 SOAP 正文中的元素。
MessageContractAttribute	定义与 SOAP 消息相对应的强类型类。
MessageContractMemberAttribute	声明 MessageBodyMemberAttribute 和 MessageHeaderAttribute 的基成员。
MessageCredentialType	枚举有效的消息凭据类型。
MessageHeader<T>	表示 SOAP 标头的内容。
MessageHeaderException	在处理消息时，如果不能满足与 SOAP 消息头有关的期望，则引发该异常。
MessageParameterAttribute	控制请求和响应参数的名称。不能与消息或消息协定结合使用。
MessageSecurityOverTcp	为使用 TCP 传输发送的消息配置消息级安全性。
MessageSecurityVersion	一个抽象容器类，在由多个静态属性实现时包含安全组件的版本信息。
NetHttpBinding	指定用于 NetHttpBinding 的设置。
NetHttpMessageEncoding	指定网络 Http 消息编码。
NetTcpBinding	一种适合于跨计算机通信的安全可靠的绑定。
NetTcpSecurity	指定用 NetTcpBinding 配置的终结点所使用的传输级安全性和消息级安全性的类型。
OperationContext	提供对服务方法的执行上下文的访问权限。
OperationContextScope	创建一个块，其中的 OperationContext 对象在范围之内。
OperationContractAttribute	指示方法定义一个操作，该操作是应用程序中服务协定的一部分。
OperationFormatStyle	表示 SOAP 样式，该样式确定如何设置服务的 WSDL 元数据格式。
ProtocolException	当由于数据传输协议不匹配而导致无法与远程方进行通信时，将在客户端引发此异常。
QuotaExceededException	当超过消息配额时引发的异常。
SecurityMode	确定绑定的安全设置。
ServerTooBusyException	服务器太忙而无法接受消息时引发的异常。
ServiceActivationException	无法激活服务时引发的异常。
ServiceContractAttribute	指示接口或类在应用程序中定义服务协定。
ServiceKnownTypeAttribute	指定序列化或反序列化时服务要使用的已知类型。
SpnEndpointIdentity	表示当绑定使用 Kerberos 时标识的服务主体名称 (SPN)。
TcpClientCredentialType	枚举 TCP 客户端的有效凭据类型。
TcpTransportSecurity	提供控制 TCP 传输的身份验证参数和保护级别的属性。
TransferMode	指示通道是使用流处理模式还是缓冲模式来传输请求和响应消息。
UnknownMessageReceivedEventArgs	包含通过通道接收但不能与任何回调操作或挂起请求相关联的消息。
UpnEndpointIdentity	表示当绑定使用 SSPINegotiate 身份验证模式时所使用的标识的用户主体名称 (UPN)。
XmlSerializerFormatAttribute	指示基础结构使用 XmlSerializer 而不是 XmlObjectSerializer。

System.ServiceModel.Channels 命名空间

适用于 Windows 应用商店应用的 .NET 中支持的类型	说明
AddressHeader	表示一个地址头，它封装的地址信息项用于标识终结点或与终结点进行交互。
AddressHeaderCollection	表示地址头的线程安全的只读集合。
AddressingVersion	与 SOAP 消息关联或终结点所理解的 WS-Addressing 版本。
BinaryMessageEncodingBindingElement	用于指定编码消息时所采用的 .NET 二进制 XML 格式的绑定元素。
Binding	包含绑定元素，这些元素指定客户端和服务之间的通信所用的协议、传输和消息编码器。
BindingContext	提供关于生成通道侦听器和通道工厂所需的地址、绑定、绑定元素和绑定参数的信息。
BindingElement	用于为各种类型的通道生成通道工厂和通道侦听器以处理传出和传入消息的绑定元素。
BindingElementCollection	表示绑定中使用的绑定元素的集合。
BindingParameterCollection	表示一个绑定参数的集合，这些参数存储由绑定元素用来生成工厂的信息。
BodyWriter	表示消息正文的编写器。
BufferManager	许多功能都需要使用缓冲区，但创建和销毁缓冲区的造价非常高。使用 BufferManager 类管理缓冲池。缓冲池及其缓冲区是在实例化此类时创建，在垃圾回收将缓冲池回收时销毁。每次需要使用缓冲区时，就可以从缓冲池中取出一个缓冲区来使用，然后在使用完毕后将其返回到缓冲池。这个过程要比每次需要使用缓冲区时就创建一个然后再销毁快得多。
ChannelBase	提供自定义通道的基实现。
ChannelFactoryBase	为所有自定义通道工厂提供一个通用基实现。
ChannelFactoryBase<TChannel>	为客户端上的通道工厂提供通用的基实现，以创建具有指定类型、与指定地址连接的通道。
ChannelManagerBase	提供基实现，用以管理与通道和侦听器工厂关联的默认超时。
ChannelParameterCollection	表示通道参数的集合。
CommunicationObject	为系统中所有面向通信的对象（包括通道、侦听器以及通道和侦听器工厂）公用的基本状态机提供通用的基实现。
CompressionFormat	指定通道压缩格式。
ConnectionOrientedTransportBindingElement	一个抽象类，可以向基 TransportBindingElement 补充面向连接的传输（如 TCP 和命名管道）所通用的其他属性。
CustomBinding	从一个绑定元素列表定义绑定。
FaultConverter	将通道引发的异常转换为符合通道协议的 SOAP 错误消息。
HttpRequestMessageProperty	提供对 HTTP 请求的访问，以访问和响应通过 HTTP 协议提供给请求的附加信息。
HttpResponseMessageProperty	提供对 HTTP 响应的访问，以便访问和响应通过 HTTP 协议提供给请求的附加信息。
HttpsTransportBindingElement	表示用于指定 HTTPS 传输以传输消息的绑定元素。
HttpTransportBindingElement	表示用于指定 HTTP 传输以传输消息的绑定元素。
IChannel	定义所有通道对象都必须实现的基本接口。它要求通道对象实现由所有通信对象共享的状态机接口，还要求通道对象实现从通道堆栈中检索对象的方法。
IChannelFactory	定义必须由通道工厂实现来生成通道的接口。
IChannelFactory<TChannel>	定义必须由创建特定类型通道的通道工厂实现的接口。
IDuplexChannel	定义通道为发送和接收消息而必须实现的接口。
IDuplexSession	定义会话接口，该接口在消息终结点之间的双向通信的两端实现。
IDuplexSessionChannel	定义将双工通道与会话进行关联的接口。
IHttpCookieContainerManager	表示 Cookie 容器管理器。
IInputChannel	定义通道为接收消息而必须实现的接口。
IInputSession	定义会话接口，该接口在消息传递终结点之间的单向通信的接收端实现。
IInputSessionChannel	定义将输入通道与会话进行关联的接口。
IMessageProperty	定义一个接口，可通过实现该接口来描述消息的一组属性。
IOutputChannel	定义通道为发送消息而必须实现的接口。
IOutputSession	定义会话接口，该接口在消息终结点之间的单向通信的发送端实现。
IOutputSessionChannel	定义将输出通道与会话进行关联的接口。
IRequestChannel	定义一个协定，通道必须实现该协定，才能成为消息传递终结点之间的请求-回复通信的请求端。
IRequestSessionChannel	定义将请求通道与会话进行关联的接口。
ISession	通过提供通信会话的 ID，定义在交换消息的各方之间建立共享上下文的接口。
ISessionChannel<TSession>	定义将通道与特定会话类型进行关联的接口。
LocalClientSecuritySettings	指定本地客户端安全设置。
Message	表示分布式环境中终结点之间的通信单元。
MessageBuffer	表示一个内存缓冲区，该内存缓冲区存储了未来要使用的整个消息。
MessageEncoder	编码器是用于将消息写入到流中并从流中读取消息的组件。
MessageEncoderFactory	一个抽象基类，表示用于生成消息编码器的工厂，消息编码器可从流中读取消息和将消息写入流以进行多种类型的消息编码。
MessageEncodingBindingElement	用于指定对消息进行编码时所用消息版本的绑定元素。
MessageFault	表示 SOAP 错误在内存中的表示形式，该错误可以传递到 Message.CreateMessage 以创建包含错误的消息。
MessageHeader	表示 SOAP 标头的内容。
MessageHeaderInfo	表示与 SOAP 消息头有关的系统信息。
MessageHeaders	表示消息的消息头集合。无法继承此类。
MessageProperties	表示消息的一组属性。无法继承此类。
MessageState	指定消息的状态。
MessageVersion	指定与消息及其交换相关联的 SOAP 和 WS-Addressing 的版本。
RequestContext	提供一个与传入请求关联的答复。
SecurityBindingElement	一个抽象类，在实现时表示支持通道 SOAP 消息安全的绑定元素。
SecurityHeaderLayout	描述安全标头的布局。
SslStreamSecurityBindingElement	表示一个自定义绑定元素，它支持使用 SSL 流的通道安全。
TcpConnectionPoolSettings	表示控制 TCP 连接池的行为的属性。
TcpTransportBindingElement	表示 TCP 传输的绑定元素。
TextMessageEncodingBindingElement	绑定元素，指定用于基于文本的 SOAP 消息的字符编码与消息版本管理。
TransportBindingElement	一个表示传输绑定元素的抽象基类。
TransportSecurityBindingElement	表示一个自定义绑定元素，它支持混合模式安全（如安全传输中优化的消息安全）。
WebSocketTransportSettings	表示 Web 套接字传输设置。
WebSocketTransportUsage	指定 WebSocket 传输用法的枚举。
WindowsStreamSecurityBindingElement	表示用于指定 Windows 流安全设置的绑定元素。

System.ServiceModel.Description 命名空间

适用于 Windows 应用商店应用的 .NET 中支持的类型	说明
ClientCredentials	使用户能够配置客户端和服务凭据以及服务凭据身份验证设置，以用于通信的客户端。
ContractDescription	描述指定终结点向外部传递的信息的协定。
DataContractSerializerOperationBehavior	表示 DataContractSerializer 的运行时行为。
FaultDescription	表示 SOAP 错误。
FaultDescriptionCollection	可用于获取协定中 SOAP 错误的相关信息的 FaultDescription 对象集合。
IContractBehavior	实现可用于扩展服务或客户端应用程序中的协定的运行时行为的方法。
IEndpointBehavior	实现可用于扩展服务或客户端应用程序中的终结点的运行时行为的方法。
IOperationBehavior	实现可用于扩展服务或客户端应用程序中的操作的运行时行为的方法。
MessageBodyDescription	表示 SOAP 消息的正文。
MessageDescription	表示消息的说明。
MessageDescriptionCollection	提供用于存储消息说明的集合，其中消息为组成协定所属操作的消息。
MessageDirection	指定消息的方向。
MessageHeaderDescription	表示 SOAP 消息头。
MessageHeaderDescriptionCollection	表示 MessageHeaderDescription 对象的集合。
MessagePartDescription	表示 SOAP 消息部分的说明。
MessagePartDescriptionCollection	表示 MessagePartDescription 对象的集合。
MessagePropertyDescription	表示 MessagePropertyAttribute 指定的消息属性。
MessagePropertyDescriptionCollection	表示 MessagePropertyDescription 对象的集合。
OperationDescription	表示协定操作的说明，该协定操作可提供组成操作的消息的说明。
OperationDescriptionCollection	表示包含操作说明的集合。
ServiceEndpoint	表示允许服务的客户端查找并与服务通信的服务的终结点。

System.ServiceModel.Dispatcher 命名空间

适用于 Windows 应用商店应用的 .NET 中支持的类型	说明
ClientOperation	用于在客户端对象或客户端通道对象中修改或扩展特定协定操作的执行行为。无法继承此类。
ClientRuntime	类的插入点，这些类可以扩展客户端应用程序处理的所有消息的客户端对象的功能。
DispatchOperation	用于修改或扩展服务终结点中的特定服务操作的执行行为。无法继承此类。
DispatchRuntime	公开某些属性，这些属性用于修改默认服务行为以及附加自定义对象，而这些对象可修改将传入消息转换为对象和调度到操作的方式。无法继承此类。
EndpointDispatcher	公开属性的运行时对象，使用这些属性可以在服务应用程序中插入运行时扩展或修改消息。
IClientMessageFormatter	定义用于控制客户端应用程序的消息与对象之间的转换的方法。
IClientMessageInspector	定义一个消息检查器对象，将该对象添加到 MessageInspectors 集合即可查看或修改消息。
IClientOperationSelector	定义操作选择器的协定。
IParameterInspector	定义自定义参数检查器实现的协定，有了该协定，就可在客户端或服务进行调用之前或紧接着其调用，检查或修改信息。

System.ServiceModel.Security 命名空间

适用于 Windows 应用商店应用的 .NET 中支持的类型	说明
BasicSecurityProfileVersion	提供与基本安全配置文件规范相对应的消息版本。
HttpDigestClientCredential	用于 HTTP 客户端的摘要式身份验证。
MessageSecurityException	表示当应用到消息的安全出现错误时发生的异常。
SecureConversationVersion	包含受支持的 WS-SecureConversation 版本集合。这是一个抽象类。
SecurityAccessDeniedException	表示安全授权请求失败时引发的安全异常。
SecurityPolicyVersion	包含受支持的 WS-SecurityPolicy 版本集合。这是一个抽象类。
SecurityVersion	包含受支持的 WS-Security 版本集合。这是一个抽象类。
TrustVersion	包含受支持的 WS-Trust 版本集合。这是一个抽象类。
UserNamePasswordClientCredential	表示基于用户名和密码的客户端凭据。
WindowsClientCredential	使你可以指定与 Windows 凭据（用于表示客户端）相关的属性。

System.ServiceModel.Security.Tokens 命名空间

适用于 Windows 应用商店应用的 .NET 中支持的类型	说明
SecureConversationSecurityTokenParameters	表示安全对话安全令牌的参数。
SecurityTokenParameters	一个抽象类，可在实现时表示安全令牌参数。
SupportingTokenParameters	表示支持安全绑定元素所要求的安全令牌的参数。
UserNameSecurityTokenParameters	表示用户名安全令牌的参数。

请参见

概念

.NET for Windows Store 应用程序 - 支持的 API

通过

System.ServiceModel 命名空间

System.ServiceModel 命名空间

System.ServiceModel.Channels 命名空间

System.ServiceModel.Description 命名空间

System.ServiceModel.Dispatcher 命名空间

System.ServiceModel.Security 命名空间

System.ServiceModel.Security.Tokens 命名空间

请参见

概念

其他资源