System.ServiceModel 命名空间

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

表示用户名安全令牌的参数。

请参见

概念

用于 Windows 应用商店应用的 .NET API