AtomPubClient Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Incapsula i metodi necessari per implementare il protocollo AtomPub che consente l'accesso CRUD HTTP alle risorse Web usando il formato di collegamento 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
- Ereditarietà
- Attributi
- Implementazioni
Requisiti Windows
Famiglia di dispositivi |
Windows 10 (è stato introdotto in 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)
|
Funzionalità dell'app |
internetClient
privateNetworkClientServer
|
Commenti
Per esempi di implementazione di questi metodi di classe per creare, recuperare, aggiornare o eliminare contenuto syndicato, vedere Guida introduttiva: Gestione delle voci dei feed.
Costruttori
AtomPubClient() |
Crea un nuovo oggetto AtomPubClient . |
AtomPubClient(PasswordCredential) |
Crea un nuovo oggetto AtomPubClient con le credenziali da usare durante l'esecuzione di richieste al server. Inizialmente, una tupla "username/password". Per le credenziali di dominio, tuttavia, il nome utente deve essere nel formato "dominio\utente". |
Proprietà
BypassCacheOnRetrieve |
Ottiene o imposta un valore booleano che specifica se ignorare la cache durante il recupero del feed. |
MaxResponseBufferSize |
Ottiene o imposta il numero massimo di byte da memorizzare nel buffer durante la ricezione di una risposta da un server. |
ProxyCredential |
Ottiene o imposta le credenziali da usare quando si effettuano richieste tramite un proxy. |
ServerCredential |
Ottiene o imposta le credenziali da utilizzare durante l'esecuzione di richieste al server. |
Timeout |
Ottiene o imposta la quantità massima di tempo, espressa in millisecondi, per attendere il completamento di una delle operazioni asincrone. Se l'operazione non viene completata entro questo periodo di tempo, l'operazione avrà esito negativo con un codice di stato che indica il timeout. |
Metodi
CancelAsyncOperations() |
Annulla tutte le operazioni asincrone in corso, causando un errore (asincrono) con un codice di errore che indica l'annullamento. |
CreateMediaResourceAsync(Uri, String, String, IInputStream) |
Crea una nuova risorsa multimediale nella raccolta specificata. |
CreateResourceAsync(Uri, String, SyndicationItem) |
Crea una nuova risorsa Entry nella raccolta specificata. L'URI dell'insieme in cui creare la nuova risorsa può essere individuato dall'oggetto ResourceCollection recuperato dal metodo RetrieveResourceAsync . |
DeleteResourceAsync(Uri) |
Elimina una risorsa Voce o Collegamento multimediale esistente. |
DeleteResourceItemAsync(SyndicationItem) |
Elimina una risorsa Voce o Collegamento multimediale esistente. Ciò è diverso dal metodo DeleteResourceAsync in quanto l'oggetto SyndicationItem che rappresenta la risorsa da eliminare viene specificato anziché l'Uri. Il metodo DeleteResourceItemAsync usa la proprietà dell'oggetto SyndicationItem specificato come URI della risorsa da eliminare. |
RetrieveFeedAsync(Uri) |
Avvia un'operazione asincrona per scaricare il feed di diffusione dall'URI specificato. Questo metodo crea un'istanza di un oggetto SyndicationFeed dalla stringa del feed, che può trovarsi in uno dei formati specificati in SyndicationFormat. |
RetrieveMediaResourceAsync(Uri) |
Recupera una risorsa di collegamento multimediale dall'URI (Uniform Resource Identifier) specificato. |
RetrieveResourceAsync(Uri) |
Recupera una risorsa Entry o una risorsa Collegamento multimediale dall'URI (Uniform Resource Identifier) specificato. |
RetrieveServiceDocumentAsync(Uri) |
Recupera un documento di servizio dall'URI specificato. |
SetRequestHeader(String, String) |
Imposta un'intestazione HTTP per la richiesta. Questo metodo può essere chiamato più volte per impostare più intestazioni. Quando la stessa intestazione viene impostata più volte, i valori verranno concatenati e separati da ",". |
UpdateMediaResourceAsync(Uri, String, IInputStream) |
Aggiornamenti una risorsa di collegamento multimediale dall'URI (Uniform Resource Identifier) specificato. |
UpdateResourceAsync(Uri, SyndicationItem) |
Aggiornamenti una risorsa Voce o Collegamento multimediale esistente. Se in precedenza è stata rilevata un'intestazione ETag: durante il recupero di questa risorsa (in risposta a RetrieveResourceAsync, CreateResourceAsync o una precedente chiamata a UpdateResourceAsync), questo metodo invia automaticamente un'intestazione If-Match: con il valore memorizzato. |
UpdateResourceItemAsync(SyndicationItem) |
Aggiornamenti una risorsa Voce o Collegamento multimediale esistente. Ciò è diverso dal metodo UpdateResourceAsync in quanto la proprietà EditUri dell'oggetto SyndicationItem specificato viene utilizzata come Uri della risorsa da aggiornare. |