AtomPubClient Klasse

Definition

Namespace:

Windows.Web.AtomPub

Kapselt die Methoden, die zum Implementieren des AtomPub-Protokolls erforderlich sind, das http CRUD-Zugriff auf Webressourcen mit dem Atom 1.0-Wire-Format ermöglicht.

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

Vererbung

Object Platform::Object IInspectable AtomPubClient

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementiert

ISyndicationClient

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)
App-Funktionen	internetClient privateNetworkClientServer

Hinweise

Beispiele für die Implementierung dieser Klassenmethoden zum Erstellen, Abrufen, Aktualisieren oder Löschen von syndizierten Inhalten finden Sie unter Schnellstart: Verwalten von Feedeinträgen.

Konstruktoren

AtomPubClient()	Erstellt ein neues AtomPubClient-Objekt .
AtomPubClient(PasswordCredential)	Erstellt ein neues AtomPubClient-Objekt mit den Anmeldeinformationen, die beim Senden von Anforderungen an den Server verwendet werden sollen. Zunächst ein "Benutzername/Kennwort"-Tupel. Für Domänenanmeldeinformationen muss sich der Benutzername jedoch in "Domäne\Benutzerformular" befinden.

Eigenschaften

BypassCacheOnRetrieve	Ruft einen booleschen Wert ab, der angibt, ob der Cache beim Abrufen des Feeds umgangen werden soll, oder legt diesen fest.
MaxResponseBufferSize	Ruft die maximale Anzahl von Bytes ab, die beim Empfangen einer Antwort von einem Server gepuffert werden sollen, oder legt diese fest.
ProxyCredential	Ruft die Anmeldeinformationen ab, die beim Senden von Anforderungen über einen Proxy verwendet werden sollen, oder legt diese fest.
ServerCredential	Ruft die Anmeldeinformationen ab, die beim Senden von Anforderungen an den Server verwendet werden sollen, oder legt diese fest.
Timeout	Ruft die maximale Zeitspanne in Millisekunden ab, die auf den Abschluss der asynchronen Vorgänge gewartet werden soll, oder legt diesen fest. Wenn der Vorgang innerhalb dieser Zeit nicht abgeschlossen ist, schlägt er mit einem status Code fehl, der angibt, dass ein Timeout aufgetreten ist.

Methoden

CancelAsyncOperations()	Bricht alle laufenden asynchronen Vorgänge ab, sodass sie (asynchron) mit einem Fehlercode fehlschlagen, der den Abbruch angibt.
CreateMediaResourceAsync(Uri, String, String, IInputStream)	Erstellt eine neue Medienressource in der angegebenen Auflistung.
CreateResourceAsync(Uri, String, SyndicationItem)	Erstellt eine neue Eintragsressource in der angegebenen Auflistung. Der URI der Auflistung, in der die neue Ressource erstellt werden soll, kann aus dem ResourceCollection-Objekt ermittelt werden, das von der RetrieveResourceAsync-Methode abgerufen wurde.
DeleteResourceAsync(Uri)	Löscht eine vorhandene Eintrags- oder Media Link-Ressource.
DeleteResourceItemAsync(SyndicationItem)	Löscht eine vorhandene Eintrags- oder Media Link-Ressource. Dies unterscheidet sich von der DeleteResourceAsync-Methode darin, dass das SyndicationItem-Objekt , das die zu löschende Ressource darstellt, anstelle des URI angegeben wird. Die DeleteResourceItemAsync-Methode verwendet die -Eigenschaft des angegebenen SyndicationItem als URI der zu löschenden Ressource.
RetrieveFeedAsync(Uri)	Startet einen asynchronen Vorgang zum Herunterladen des Syndikationsfeeds aus dem angegebenen URI. Diese Methode instanziiert ein SyndicationFeed-Objekt aus der Feedzeichenfolge, das in einem der in SyndicationFormat angegebenen Formate vorliegen kann.
RetrieveMediaResourceAsync(Uri)	Ruft eine Medienlinkressource aus dem angegebenen URI (Uniform Resource Identifier) ab.
RetrieveResourceAsync(Uri)	Ruft eine Eintragsressource oder Media Link-Ressource aus dem angegebenen URI (Uniform Resource Identifier) ab.
RetrieveServiceDocumentAsync(Uri)	Ruft ein Dienstdokument aus dem angegebenen URI ab.
SetRequestHeader(String, String)	Legt einen HTTP-Header für die Anforderung fest. Diese Methode kann mehrmals aufgerufen werden, um mehrere Header festzulegen. Wenn derselbe Header mehrmals festgelegt wird, werden die Werte verkettet und durch "," getrennt.
UpdateMediaResourceAsync(Uri, String, IInputStream)	Updates eine Medienlinkressource aus dem angegebenen URI (Uniform Resource Identifier) aus.
UpdateResourceAsync(Uri, SyndicationItem)	Updates einer vorhandenen Entry- oder Media Link-Ressource. Wenn beim Abrufen dieser Ressource zuvor ein ETag:-Header (in einer Antwort auf RetrieveResourceAsync, CreateResourceAsync oder ein vorheriger Aufruf von UpdateResourceAsync) angezeigt wurde, sendet diese Methode automatisch einen If-Match:-Header mit dem gespeicherten Wert.
UpdateResourceItemAsync(SyndicationItem)	Updates einer vorhandenen Entry- oder Media Link-Ressource. Dies unterscheidet sich von der UpdateResourceAsync-Methode darin, dass die EditUri-Eigenschaft des angegebenen SyndicationItem-Objekts als URI der zu aktualisierenden Ressource verwendet wird.

Weitere Informationen

• Schnellstart: Verwalten von Feedeinträgen
• AtomPub-Beispiel