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 AtomPubClientfunction AtomPubClient(serverCredential)Public NotInheritable Class 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 обновляемого ресурса. |