WebClient.UploadDataTaskAsync Methode

Definition

Namespace:

System.Net

Assemblys:

netstandard.dll, System.Net.WebClient.dll

Lädt einen Datenpuffer hoch, der ein Byte Array enthält, in den URI, der als asynchroner Vorgang mit einem Aufgabenobjekt angegeben ist. Diese Methoden blockieren den aufrufenden Thread nicht.

Überlädt

Name	Beschreibung
UploadDataTaskAsync(String, Byte[])	Lädt einen Datenpuffer hoch, der ein Byte Array enthält, in den URI, der als asynchroner Vorgang mit einem Aufgabenobjekt angegeben ist.
UploadDataTaskAsync(Uri, Byte[])	Lädt einen Datenpuffer hoch, der ein Byte Array enthält, in den URI, der als asynchroner Vorgang mit einem Aufgabenobjekt angegeben ist.
UploadDataTaskAsync(String, String, Byte[])	Lädt einen Datenpuffer hoch, der ein Byte Array enthält, in den URI, der als asynchroner Vorgang mit einem Aufgabenobjekt angegeben ist.
UploadDataTaskAsync(Uri, String, Byte[])	Lädt einen Datenpuffer hoch, der ein Byte Array enthält, in den URI, der als asynchroner Vorgang mit einem Aufgabenobjekt angegeben ist.

UploadDataTaskAsync(String, Byte[])

Quelle:

WebClient.cs

Lädt einen Datenpuffer hoch, der ein Byte Array enthält, in den URI, der als asynchroner Vorgang mit einem Aufgabenobjekt angegeben ist.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadDataTaskAsync(System::String ^ address, cli::array <System::Byte> ^ data);

public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync(string address, byte[] data);

member this.UploadDataTaskAsync : string * byte[] -> System.Threading.Tasks.Task<byte[]>

Public Function UploadDataTaskAsync (address As String, data As Byte()) As Task(Of Byte())

Parameter

address

String

Der URI der Ressource, die die Daten empfängt.

data

Byte[]

Der Datenpuffer, der an die Ressource gesendet werden soll.

Gibt zurück

Task<Byte[]>

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt. Die Result Eigenschaft für das Taskobjekt gibt ein Byte Array zurück, das den Textkörper der Antwort enthält, die von der Ressource empfangen wurde, als der Datenpuffer hochgeladen wurde.

Ausnahmen

ArgumentNullException

Der address Parameter ist null.

WebException

Der URI, der durch Kombinieren BaseAddress und address Ungültiges gebildet wird.

-oder-

Fehler beim Öffnen des Datenstroms.

-oder-

Es gab keine Antwort vom Server, auf dem die Ressource gehostet wurde.

Hinweise

Vorsicht

WebRequest, HttpWebRequest, ServicePointund WebClient sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.

Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem der Datenpuffer in die Ressource hochgeladen wurde.

Diese Methode sendet einen Datenpuffer an eine Ressource. Der Datenpuffer wird asynchron mithilfe von Threadressourcen gesendet, die automatisch aus dem Threadpool zugeordnet werden. Die Daten werden nicht codiert.

In .NET Framework und .NET Core 1.0 können Sie asynchrone Vorgänge abbrechen, die nicht abgeschlossen wurden, indem Sie die CancelAsync Methode aufrufen.

Wenn es sich bei der BaseAddress Eigenschaft nicht um eine leere Zeichenfolge ("") handelt und address keinen absoluten URI enthält, muss es sich um einen relativen URI sein, address der kombiniert BaseAddress wird, um den absoluten URI der angeforderten Daten zu bilden. Wenn die QueryString Eigenschaft keine leere Zeichenfolge ist, wird sie angefügt address.

Diese Methode verwendet den STOR-Befehl, um eine FTP-Ressource hochzuladen. Für eine HTTP-Ressource wird die POST-Methode verwendet.

Anmerkung

Dieses Mitglied gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Network Tracing in .NET Framework.

UploadDataTaskAsync(Uri, Byte[])

Quelle:

WebClient.cs

Lädt einen Datenpuffer hoch, der ein Byte Array enthält, in den URI, der als asynchroner Vorgang mit einem Aufgabenobjekt angegeben ist.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadDataTaskAsync(Uri ^ address, cli::array <System::Byte> ^ data);

public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync(Uri address, byte[] data);

member this.UploadDataTaskAsync : Uri * byte[] -> System.Threading.Tasks.Task<byte[]>

Public Function UploadDataTaskAsync (address As Uri, data As Byte()) As Task(Of Byte())

Parameter

address

Uri

Der URI der Ressource, die die Daten empfängt.

data

Byte[]

Der Datenpuffer, der an die Ressource gesendet werden soll.

Gibt zurück

Task<Byte[]>

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt. Die Result Eigenschaft für das Taskobjekt gibt ein Byte Array zurück, das den Textkörper der Antwort enthält, die von der Ressource empfangen wurde, als der Datenpuffer hochgeladen wurde.

Ausnahmen

ArgumentNullException

Der address Parameter ist null.

WebException

Der URI, der durch Kombinieren BaseAddress und address Ungültiges gebildet wird.

-oder-

Fehler beim Öffnen des Datenstroms.

-oder-

Es gab keine Antwort vom Server, auf dem die Ressource gehostet wurde.

Hinweise

Vorsicht

WebRequest, HttpWebRequest, ServicePointund WebClient sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.

Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem der Datenpuffer in die Ressource hochgeladen wurde.

Diese Methode sendet einen Datenpuffer an eine Ressource. Der Datenpuffer wird asynchron mithilfe von Threadressourcen gesendet, die automatisch aus dem Threadpool zugeordnet werden. Die Daten werden nicht codiert.

In .NET Framework und .NET Core 1.0 können Sie asynchrone Vorgänge abbrechen, die nicht abgeschlossen wurden, indem Sie die CancelAsync Methode aufrufen.

Wenn es sich bei der BaseAddress Eigenschaft nicht um eine leere Zeichenfolge ("") handelt und address keinen absoluten URI enthält, muss es sich um einen relativen URI sein, address der kombiniert BaseAddress wird, um den absoluten URI der angeforderten Daten zu bilden. Wenn die QueryString Eigenschaft keine leere Zeichenfolge ist, wird sie angefügt address.

Diese Methode verwendet den STOR-Befehl, um eine FTP-Ressource hochzuladen. Für eine HTTP-Ressource wird die POST-Methode verwendet.

Anmerkung

Dieses Mitglied gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Network Tracing in .NET Framework.

UploadDataTaskAsync(String, String, Byte[])

Quelle:

WebClient.cs

Lädt einen Datenpuffer hoch, der ein Byte Array enthält, in den URI, der als asynchroner Vorgang mit einem Aufgabenobjekt angegeben ist.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadDataTaskAsync(System::String ^ address, System::String ^ method, cli::array <System::Byte> ^ data);

public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync(string address, string? method, byte[] data);

member this.UploadDataTaskAsync : string * string * byte[] -> System.Threading.Tasks.Task<byte[]>

Public Function UploadDataTaskAsync (address As String, method As String, data As Byte()) As Task(Of Byte())

Parameter

address

String

Der URI der Ressource, die die Daten empfängt.

method

String

Die Methode, die zum Senden der Daten an die Ressource verwendet wird. If null, the default is POST for http and STOR for ftp.

data

Byte[]

Der Datenpuffer, der an die Ressource gesendet werden soll.

Gibt zurück

Task<Byte[]>

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt. Die Result Eigenschaft für das Taskobjekt gibt ein Byte Array zurück, das den Textkörper der Antwort enthält, die von der Ressource empfangen wurde, als der Datenpuffer hochgeladen wurde.

Ausnahmen

ArgumentNullException

Der address Parameter ist null.

WebException

Der URI, der durch Kombinieren BaseAddress und address Ungültiges gebildet wird.

-oder-

Fehler beim Öffnen des Datenstroms.

-oder-

Es gab keine Antwort vom Server, auf dem die Ressource gehostet wurde.

Hinweise

Vorsicht

WebRequest, HttpWebRequest, ServicePointund WebClient sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.

Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem der Datenpuffer in die Ressource hochgeladen wurde.

Diese Methode sendet einen Datenpuffer an eine Ressource. Der Datenpuffer wird asynchron mithilfe von Threadressourcen gesendet, die automatisch aus dem Threadpool zugeordnet werden. Die Daten werden nicht codiert.

In .NET Framework und .NET Core 1.0 können Sie asynchrone Vorgänge abbrechen, die nicht abgeschlossen wurden, indem Sie die CancelAsync Methode aufrufen.

Wenn es sich bei der BaseAddress Eigenschaft nicht um eine leere Zeichenfolge ("") handelt und address keinen absoluten URI enthält, muss es sich um einen relativen URI sein, address der kombiniert BaseAddress wird, um den absoluten URI der angeforderten Daten zu bilden. Wenn die QueryString Eigenschaft keine leere Zeichenfolge ist, wird sie angefügt address.

Anmerkung

Dieses Mitglied gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Network Tracing in .NET Framework.

UploadDataTaskAsync(Uri, String, Byte[])

Quelle:

WebClient.cs

Lädt einen Datenpuffer hoch, der ein Byte Array enthält, in den URI, der als asynchroner Vorgang mit einem Aufgabenobjekt angegeben ist.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadDataTaskAsync(Uri ^ address, System::String ^ method, cli::array <System::Byte> ^ data);

public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync(Uri address, string? method, byte[] data);

member this.UploadDataTaskAsync : Uri * string * byte[] -> System.Threading.Tasks.Task<byte[]>

Public Function UploadDataTaskAsync (address As Uri, method As String, data As Byte()) As Task(Of Byte())

Parameter

address

Uri

Der URI der Ressource, die die Daten empfängt.

method

String

Die Methode, die zum Senden der Daten an die Ressource verwendet wird. If null, the default is POST for http and STOR for ftp.

data

Byte[]

Der Datenpuffer, der an die Ressource gesendet werden soll.

Gibt zurück

Task<Byte[]>

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt. Die Result Eigenschaft für das Taskobjekt gibt ein Byte Array zurück, das den Textkörper der Antwort enthält, die von der Ressource empfangen wurde, als der Datenpuffer hochgeladen wurde.

Ausnahmen

ArgumentNullException

Der address Parameter ist null.

WebException

Der URI, der durch Kombinieren BaseAddress und address Ungültiges gebildet wird.

-oder-

Fehler beim Öffnen des Datenstroms.

-oder-

Es gab keine Antwort vom Server, auf dem die Ressource gehostet wurde.

Hinweise

Vorsicht

WebRequest, HttpWebRequest, ServicePointund WebClient sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.

Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem der Datenpuffer in die Ressource hochgeladen wurde.

Diese Methode sendet einen Datenpuffer an eine Ressource. Der Datenpuffer wird asynchron mithilfe von Threadressourcen gesendet, die automatisch aus dem Threadpool zugeordnet werden. Die Daten werden nicht codiert.

In .NET Framework und .NET Core 1.0 können Sie asynchrone Vorgänge abbrechen, die nicht abgeschlossen wurden, indem Sie die CancelAsync Methode aufrufen.

Wenn es sich bei der BaseAddress Eigenschaft nicht um eine leere Zeichenfolge ("") handelt und address keinen absoluten URI enthält, muss es sich um einen relativen URI sein, address der kombiniert BaseAddress wird, um den absoluten URI der angeforderten Daten zu bilden. Wenn die QueryString Eigenschaft keine leere Zeichenfolge ist, wird sie angefügt address.

Anmerkung

Dieses Mitglied gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Network Tracing in .NET Framework.