HttpClient.GetBufferAsync(Uri) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Senden Sie eine GET-Anforderung an den angegebenen URI, und geben Sie den Antworttext als Puffer in einem asynchronen Vorgang zurück. Programmieranleitungen für die HttpClient-Klasse und Codebeispiele finden Sie im konzeptuellen Thema HttpClient .
public:
virtual IAsyncOperationWithProgress<IBuffer ^, HttpProgress> ^ GetBufferAsync(Uri ^ uri) = GetBufferAsync;/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<IBuffer, HttpProgress> GetBufferAsync(Uri const& uri);[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<IBuffer,HttpProgress> GetBufferAsync(System.Uri uri);function getBufferAsync(uri)Public Function GetBufferAsync (uri As Uri) As IAsyncOperationWithProgress(Of IBuffer, HttpProgress)Parameter
Gibt zurück
Das -Objekt, das den asynchronen Vorgang darstellt.
- Attribute
Hinweise
Diese Methode wird häufig beim Herunterladen von binären Inhalten wie kleinen Bildern und komprimierten Dateien bezeichnet. Sehr große binäre Inhalte sollten als Stream mit HttpClient.GetInputStreamAsync heruntergeladen werden, um nicht benötigte Pufferung zu verhindern.
Dieser Vorgang wird nicht blockiert. Der zurückgegebene IAsyncOperationWithProgress (von IBuffer und HttpProgress) wird abgeschlossen, nachdem der gesamte Antworttext gelesen wurde.
Die HttpClient-Klasse wird häufig von einer App verwendet, um Text herunterzuladen und dann zu analysieren. Es ist möglich, dass die im Content-Type-Header von einem HTTP-Server angegebene Zeichencodierung nicht mit der Zeichencodierung des HTTP-Antworttexts übereinstimmt (z. B. die XML-Codierung in einem XML-Dokument). Eine Möglichkeit, HttpClient mit Text zu verwenden, besteht darin, die GetStringAsync-Methode aufzurufen und die zurückgegebene Zeichenfolge an den Textparser zu übergeben. Dies kann jedoch zu Fehlern führen, wenn der Content-Type kein Typ ist, der als Zeichenfolge ausgedrückt werden kann. Eine zuverlässige Möglichkeit, HttpClient mit einem XML-Parser zu verwenden, besteht darin, die GetBufferAsync-Methode aufzurufen und den Puffer für das Element "<?xml>" zu analysieren. Verwenden Sie dann die angegebene Zeichencodierung ("<xmlversion="1.0" encoding="UTF-8"?>", z. B.), um den HTTP-Antworttext zu analysieren. Für andere Textformate können ähnliche Methoden verwendet werden, wenn die App den anfänglichen Teil des HTTP-Antworttexts überprüft, um die verwendete Zeichencodierung zu bestimmen.
Im Folgenden finden Sie die Ausnahmen, die von dieser Funktion ausgelöst werden.
E_INVALIDARG
Der URI-Parameter war ein NULL-Verweis (Nothing in Visual Basic).