AtomPubClient 類別

定義

命名空間:

Windows.Web.AtomPub

封裝實作 AtomPub 通訊協定所需的方法，以使用 Atom 1.0 連線格式啟用 Web 資源的 HTTP CRUD 存取。

public ref class AtomPubClient sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(Windows.Web.AtomPub.IAtomPubClientFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class AtomPubClient final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Web.AtomPub.IAtomPubClientFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class AtomPubClient

function AtomPubClient(serverCredential)

Public NotInheritable Class AtomPubClient

繼承

Object Platform::Object IInspectable AtomPubClient

屬性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

實作

ISyndicationClient

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)
應用程式功能	internetClient privateNetworkClientServer

備註

如需如何實作這些類別方法以建立、擷取、更新或刪除新聞訂閱內容的範例，請參閱 快速入門：管理摘要專案。

建構函式

AtomPubClient()	建立新的 AtomPubClient 物件。
AtomPubClient(PasswordCredential)	使用向伺服器提出要求時要使用的認證，建立新的 AtomPubClient 物件。 一開始，「使用者名稱/密碼」Tuple。 不過，針對網域認證，用戶名稱必須位於 『domain\user form』 中。

屬性

BypassCacheOnRetrieve	取得或設定 布爾 值，指定是否要在擷取摘要時略過快取。
MaxResponseBufferSize	取得或設定從伺服器接收回應時要緩衝的最大位元元組數目。
ProxyCredential	取得或設定透過 Proxy 提出要求時要使用的認證。
ServerCredential	取得或設定對伺服器提出要求時要使用的認證。
Timeout	取得或設定等候任何異步操作完成的時間量上限，以毫秒為單位。 如果作業在此時間內未完成，則會失敗，並顯示狀態代碼指出逾時。

方法

CancelAsyncOperations()	取消任何進行中的異步操作，使其無法以異步方式 () ，並顯示錯誤碼指出取消。
CreateMediaResourceAsync(Uri, String, String, IInputStream)	在指定的集合中建立新的媒體資源。
CreateResourceAsync(Uri, String, SyndicationItem)	在指定的集合中建立新的 Entry 資源。 從 RetrieveResourceAsync 方法擷取的 ResourceCollection 物件中，可以探索要在其中建立新資源的集合 URI。
DeleteResourceAsync(Uri)	刪除現有的專案或媒體鏈接資源。
DeleteResourceItemAsync(SyndicationItem)	刪除現有的專案或媒體鏈接資源。 這與 DeleteResourceAsync 方法不同，因為會指定代表要刪除之資源的 SyndicationItem 物件，而不是 URI。 DeleteResourceItemAsync 方法會使用所指定 SyndicationItem 的 屬性做為要刪除之資源的 URI。
RetrieveFeedAsync(Uri)	啟動異步操作，以從指定的 URI 下載新聞訂閱摘要。 這個方法會從摘要字串具現化 SyndicationFeed 物件，它可以是 SyndicationFormat 中指定的其中一種格式。
RetrieveMediaResourceAsync(Uri)	從指定的統一資源標識碼 (URI) 擷取媒體鏈接資源。
RetrieveResourceAsync(Uri)	從指定的統一資源標識符擷取專案資源或媒體鏈接資源 (URI) 。
RetrieveServiceDocumentAsync(Uri)	從指定的 URI 擷取服務檔。
SetRequestHeader(String, String)	設定要求的 HTTP 標頭。 這個方法可以多次呼叫，以設定多個標頭。 當相同的標頭設定多次時，這些值將會串連，並以 “，”分隔。
UpdateMediaResourceAsync(Uri, String, IInputStream)	從指定的統一資源標識碼 (URI) 匯報 媒體鏈接資源。
UpdateResourceAsync(Uri, SyndicationItem)	匯報 現有的專案或媒體鏈接資源。 如果在擷取此資源時看到 ETag： 標頭 (擷取此資源，以回應 RetrieveResourceAsync、 CreateResourceAsync 或先前呼叫 UpdateResourceAsync) ，這個方法會自動傳送具有已記住值的 If-Match： 標頭。
UpdateResourceItemAsync(SyndicationItem)	匯報 現有的專案或媒體鏈接資源。 這與 UpdateResourceAsync 方法不同，因為所指定 SyndicationItem 物件的 EditUri 屬性會當做要更新之資源的 URI 使用。

另請參閱

• 快速入門：管理摘要專案
• AtomPub 範例