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 对象，其中包含向服务器发出请求时要使用的凭据。 最初是“用户名/密码”元组。 但是，对于域凭据，用户名必须位于“域\用户表单”中。

属性

BypassCacheOnRetrieve	获取或设置一个 布尔 值，该值指定在检索源时是否绕过缓存。
MaxResponseBufferSize	获取或设置接收来自服务器的响应时要缓冲的最大字节数。
ProxyCredential	获取或设置通过代理发出请求时要使用的凭据。
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 示例