共用方式為


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 成功完成 InvokeAsync 對 BeginOperationDelegate 所發出呼叫時,叫用的委派。

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 錯誤,當服務作業遇到處理錯誤時會傳回這些 SOAP 錯誤。

FaultException

表示 SOAP 錯誤。

FaultException<TDetail>

在用戶端應用程式中用於攔截以合約方式指定的 SOAP 錯誤。

FaultReason

提供 SOAP 錯誤的文字描述。

FaultReasonText

表示 SOAP 錯誤原因的文字。

HttpBindingBase

指定基底 HTTP 繫結。

HttpClientCredentialType

列舉 HTTP 用戶端的有效認證型別。

HttpTransportSecurity

表示 WSHttpBinding 的傳輸層級安全性設定。

IClientChannel

定義用戶端應用程式所使用之傳出要求和要求/回覆通道的行為。

ICommunicationObject

定義系統中所有通訊導向物件 (包括通道、通道管理員、處理站、接聽程式、發送器和服務主機) 的基本狀態機器合約。

IContextChannel

定義通道內容控制的介面。

IDefaultCommunicationTimeouts

定義通道、通道管理員 (例如通道接聽項與通道處理站和服務主機) 用來指定通訊逾時的介面。

IExtensibleObject<T>

讓物件參與自訂行為 (如註冊事件),或監控狀態轉換。

IExtension<T>

讓物件可以透過彙總 (Aggregation) 擴充另一個物件。

IExtensionCollection<T>

IExtension<T> 物件的集合,這個物件允許透過它的型別來擷取 IExtension<T>。

InstanceContext

表示服務執行個體的內容資訊。

InvalidMessageContractException

表示無效的訊息合約。

MessageBodyMemberAttribute

指定成員序列化成為 SOAP 本文內的項目。

MessageContractAttribute

定義對應到 SOAP 訊息的強型別類別。

MessageContractMemberAttribute

宣告 MessageBodyMemberAttribute 和 MessageHeaderAttribute 的基底成員。

MessageCredentialType

列舉有效訊息的認證類型。

MessageHeader<T>

表示 SOAP 標頭的內容。

MessageHeaderException

處理訊息時,因無法符合有關 SOAP 訊息標頭的預期而所擲回的例外狀況。

MessageParameterAttribute

控制要求的名稱並回應參數名稱。不能與 Message 或訊息合約一起使用。

MessageSecurityOverTcp

為使用 TCP 傳輸傳送的訊息設定訊息層級安全性。

MessageSecurityVersion

一個抽象容器類別,當它的數個靜態屬性實作它時,此類別會包含安全性元件的版本資訊。

NetHttpBinding

指定 NetHttpBinding 的設定。

NetHttpMessageEncoding

指定 Net 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

表示位址標頭的安全執行緒 (Thread-Safe)、唯讀集合。

AddressingVersion

與 SOAP 訊息相關聯或是由端點所了解的 WS-Addressing 版本。

BinaryMessageEncodingBindingElement

繫結項目,指定 XML 用來編碼訊息的 .NET 二進位格式。

Binding

包含繫結項目,這些項目會指定用於用戶端與服務之通訊的通訊協定、傳輸和訊息編碼器。

BindingContext

提供建置通道接聽程式和通道處理站所需之位址、繫結、繫結項目和繫結參數的相關資訊。

BindingElement

繫結的項目,這些繫結可以建置各種通道型別的通道處理站和通道接聽程式,以用來處理傳出和傳入的訊息。

BindingElementCollection

表示用於繫結之繫結項目的集合。

BindingParameterCollection

表示繫結參數的集合,這些參數可儲存繫結項目建立處理站時所用的資訊。

BodyWriter

表示訊息本文的寫入器。

BufferManager

許多功能都需要使用緩衝區,但是反覆建立與終結緩衝區是相當費時的工作。您可以使用 BufferManager 類別管理緩衝集區。當您產生這個類別時會建立集區與其緩衝區,而當記憶體回收要收回緩衝集區時就會加以終結。當您每次需要使用緩衝區時,就從集區取用一個,使用完畢後再交還給集區。這個程序比每次需要使用時才建立與終結緩衝區要快得多。

ChannelBase

提供自訂通道的基底實作。

ChannelFactoryBase

針對所有自訂通道處理站提供通用基底實作。

ChannelFactoryBase<TChannel>

提供用戶端上通道處理站的通用基底實作,以建立連接至指定之位址的特定型別通道。

ChannelManagerBase

為與通道和接聽程式處理站關聯的預設逾時值管理提供基底實作。

ChannelParameterCollection

表示通道參數的集合。

CommunicationObject

提供對系統中所有通訊導向物件而言常用的基本狀態機器基底實作,這些物件包括通道、接聽程式,以及通道與接聽程式處理站。

CompressionFormat

指定通道壓縮格式。

ConnectionOrientedTransportBindingElement

使用連線導向傳輸 (例如 TCP 和具名管道) 常用的額外屬性,補充基底 TransportBindingElement 的抽象類別。

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

為通訊工作階段提供識別碼來定義此介面,於交換訊息的各端之間建立共用內容。

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

FaultDescription 物件的集合,可以用於取得有關合約中 SOAP 錯誤的訊息。

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

提供對應於 Basic Security Profile 規格的訊息版本。

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 - 支援的應用程式開發介面