Поделиться через


AtomPubClient Класс

Определение

Инкапсулирует методы, необходимые для реализации протокола AtomPub, который обеспечивает доступ HTTP CRUD к веб-ресурсам с помощью формата подключения Atom 1.0.

public ref class AtomPubClient sealed
/// [Windows.Foundation.Metadata.Activatable(Windows.Web.AtomPub.IAtomPubClientFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class AtomPubClient final
/// [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.Activatable(typeof(Windows.Web.AtomPub.IAtomPubClientFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class AtomPubClient
[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
Атрибуты
Реализации

Требования к 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 в указанной коллекции. Универсальный код ресурса (URI) коллекции, в которой создается новый ресурс, можно обнаружить из объекта ResourceCollection , полученного из метода RetrieveResourceAsync .

DeleteResourceAsync(Uri)

Удаляет существующий ресурс Entry или Media Link.

DeleteResourceItemAsync(SyndicationItem)

Удаляет существующий ресурс Entry или Media Link. Это отличается от метода DeleteResourceAsync тем, что вместо URI указывается объект SyndicationItem , представляющий удаляемый ресурс. Метод DeleteResourceItemAsync использует свойство указанного Объекта SyndicationItem в качестве URI удаляемого ресурса.

RetrieveFeedAsync(Uri)

Запускает асинхронную операцию для скачивания веб-канала синдикации из заданного URI. Этот метод создает экземпляр объекта SyndicationFeed из строки веб-канала, который может иметь один из форматов, указанных в SyndicationFormat.

RetrieveMediaResourceAsync(Uri)

Извлекает ресурс ссылки на мультимедиа из указанного универсального кода ресурса (URI).

RetrieveResourceAsync(Uri)

Извлекает ресурс Entry или ресурс Media Link из указанного универсального кода ресурса (URI).

RetrieveServiceDocumentAsync(Uri)

Извлекает сервисный документ из указанного универсального кода ресурса (URI).

SetRequestHeader(String, String)

Задает http-заголовок для запроса. Этот метод можно вызывать несколько раз, чтобы задать несколько заголовков. Если один и тот же заголовок задается несколько раз, значения будут сцеплены и разделены символом ",".

UpdateMediaResourceAsync(Uri, String, IInputStream)

Обновления ресурс ссылки на мультимедиа из указанного универсального кода ресурса (URI).

UpdateResourceAsync(Uri, SyndicationItem)

Обновления существующий ресурс Entry или Media Link. Если при извлечении этого ресурса ранее был виден заголовок ETag: (в ответ на RetrieveResourceAsync, CreateResourceAsync или предыдущий вызов UpdateResourceAsync), этот метод автоматически отправляет заголовок If-Match: с запоминающимся значением.

UpdateResourceItemAsync(SyndicationItem)

Обновления существующий ресурс Entry или Media Link. Это отличается от метода UpdateResourceAsync тем, что свойство EditUri указанного объекта SyndicationItem используется в качестве URI обновляемого ресурса.

Применяется к

См. также раздел