WebClient.OpenWriteTaskAsync Methode

Definition

Namespace:

System.Net

Assembly:

System.Net.WebClient.dll

Öffnet einen Stream für das Schreiben von Daten in die angegebene Ressource mithilfe eines Taskobjekts als asynchronen Vorgang. Durch diese Methoden wird der aufrufende Thread nicht blockiert.

Überlädt

OpenWriteTaskAsync(String)	Öffnet einen Stream für das Schreiben von Daten in die angegebene Ressource mithilfe eines Taskobjekts als asynchronen Vorgang.
OpenWriteTaskAsync(Uri)	Öffnet einen Stream für das Schreiben von Daten in die angegebene Ressource mithilfe eines Taskobjekts als asynchronen Vorgang.
OpenWriteTaskAsync(String, String)	Öffnet einen Stream für das Schreiben von Daten in die angegebene Ressource mithilfe eines Taskobjekts als asynchronen Vorgang.
OpenWriteTaskAsync(Uri, String)	Öffnet einen Stream für das Schreiben von Daten in die angegebene Ressource mithilfe eines Taskobjekts als asynchronen Vorgang.

OpenWriteTaskAsync(String)

Quelle:

WebClient.cs

Öffnet einen Stream für das Schreiben von Daten in die angegebene Ressource mithilfe eines Taskobjekts als asynchronen Vorgang.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenWriteTaskAsync(System::String ^ address);

public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (string address);

member this.OpenWriteTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function OpenWriteTaskAsync (address As String) As Task(Of Stream)

Parameter

address

String

Der URI der Ressource, die die Daten empfangen soll.

Gibt zurück

Task<Stream>

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt. Die Result-Eigenschaft im Task-Objekt gibt Stream zurück, das verwendet wird, um Daten in die Ressource zu schreiben.

Ausnahmen

ArgumentNullException

Der address-Parameter ist null.

WebException

Der durch Kombinieren von BaseAddress und address gebildete URI ist ungültig.

- oder -

Fehler beim Öffnen des Streams.

Hinweise

Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem der beschreibbare Stream für die Datenressource geöffnet wurde. Diese Methode blockiert den aufrufenden Thread nicht, während der Stream geöffnet wird.

Diese Methode ruft eine Stream instance ab, die zum Schreiben von Daten in die durch den address Parameter angegebene Ressource verwendet wird. Der Stream wird mithilfe von Threadressourcen abgerufen, die automatisch aus dem Threadpool zugeordnet werden.

Hinweis

Sie müssen aufrufen Stream.Close , wenn Sie mit dem Stream fertig sind, um zu vermeiden, dass die Systemressourcen knapp werden.

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

Wenn die BaseAddress Eigenschaft keine leere Zeichenfolge ("") ist und address keinen absoluten URI enthält, muss es sich um einen relativen URI handeln, address der mit BaseAddress kombiniert wird, um den absoluten URI der angeforderten Daten zu bilden. Wenn die QueryString Eigenschaft keine leere Zeichenfolge ist, wird sie an addressangefügt.

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

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.

Weitere Informationen

• Stream

OpenWriteTaskAsync(Uri)

Quelle:

WebClient.cs

Öffnet einen Stream für das Schreiben von Daten in die angegebene Ressource mithilfe eines Taskobjekts als asynchronen Vorgang.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenWriteTaskAsync(Uri ^ address);

public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (Uri address);

member this.OpenWriteTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function OpenWriteTaskAsync (address As Uri) As Task(Of Stream)

Parameter

address

Uri

Der URI der Ressource, die die Daten empfangen soll.

Gibt zurück

Task<Stream>

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt. Die Result-Eigenschaft im Task-Objekt gibt Stream zurück, das verwendet wird, um Daten in die Ressource zu schreiben.

Ausnahmen

ArgumentNullException

Der address-Parameter ist null.

WebException

Der durch Kombinieren von BaseAddress und address gebildete URI ist ungültig.

- oder -

Fehler beim Öffnen des Streams.

Hinweise

Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem der beschreibbare Stream für die Datenressource geöffnet wurde. Diese Methode blockiert den aufrufenden Thread nicht, während der Stream geöffnet wird.

Diese Methode ruft eine Stream instance ab, die zum Schreiben von Daten in die durch den address Parameter angegebene Ressource verwendet wird. Der Stream wird mithilfe von Threadressourcen abgerufen, die automatisch aus dem Threadpool zugeordnet werden.

Hinweis

Sie müssen aufrufen Stream.Close , wenn Sie mit dem Stream fertig sind, um zu vermeiden, dass die Systemressourcen knapp werden.

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

Wenn die BaseAddress Eigenschaft keine leere Zeichenfolge ("") ist und address keinen absoluten URI enthält, muss es sich um einen relativen URI handeln, address der mit BaseAddress kombiniert wird, um den absoluten URI der angeforderten Daten zu bilden. Wenn die QueryString Eigenschaft keine leere Zeichenfolge ist, wird sie an addressangefügt.

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

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.

OpenWriteTaskAsync(String, String)

Quelle:

WebClient.cs

Öffnet einen Stream für das Schreiben von Daten in die angegebene Ressource mithilfe eines Taskobjekts als asynchronen Vorgang.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenWriteTaskAsync(System::String ^ address, System::String ^ method);

public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (string address, string? method);

member this.OpenWriteTaskAsync : string * string -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function OpenWriteTaskAsync (address As String, method As String) As Task(Of Stream)

Parameter

address

String

Der URI der Ressource, die die Daten empfangen soll.

method

String

Die Methode, die zum Senden der Daten an die Ressource verwendet wird. Wenn NULL, lautet der Standard für http POST und für ftp STOR.

Gibt zurück

Task<Stream>

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt. Die Result-Eigenschaft im Task-Objekt gibt Stream zurück, das verwendet wird, um Daten in die Ressource zu schreiben.

Ausnahmen

ArgumentNullException

Der address-Parameter ist null.

WebException

Der durch Kombinieren von BaseAddress und address gebildete URI ist ungültig.

- oder -

Fehler beim Öffnen des Streams.

Hinweise

Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem der beschreibbare Stream für die Datenressource geöffnet wurde. Diese Methode blockiert den aufrufenden Thread nicht, während der Stream geöffnet wird.

Diese Methode ruft eine Stream instance ab, die zum Schreiben von Daten in die durch den address Parameter angegebene Ressource verwendet wird. Der Stream wird mithilfe von Threadressourcen abgerufen, die automatisch aus dem Threadpool zugeordnet werden.

Hinweis

Sie müssen aufrufen Stream.Close , wenn Sie mit dem Stream fertig sind, um zu vermeiden, dass die Systemressourcen knapp werden.

Wenn der method -Parameter eine Methode angibt, die vom Server nicht verstanden wird, bestimmen die zugrunde liegenden Protokollklassen, was geschieht. In der Regel wird ein WebException ausgelöst, wobei die Status Eigenschaft festgelegt ist, um den Fehler anzugeben.

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

Wenn die BaseAddress Eigenschaft keine leere Zeichenfolge ("") ist und address keinen absoluten URI enthält, muss es sich um einen relativen URI handeln, address der mit BaseAddress kombiniert wird, um den absoluten URI der angeforderten Daten zu bilden. Wenn die QueryString Eigenschaft keine leere Zeichenfolge ist, wird sie an addressangefügt.

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

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.

Weitere Informationen

• Stream

OpenWriteTaskAsync(Uri, String)

Quelle:

WebClient.cs

Öffnet einen Stream für das Schreiben von Daten in die angegebene Ressource mithilfe eines Taskobjekts als asynchronen Vorgang.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenWriteTaskAsync(Uri ^ address, System::String ^ method);

public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (Uri address, string? method);

member this.OpenWriteTaskAsync : Uri * string -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function OpenWriteTaskAsync (address As Uri, method As String) As Task(Of Stream)

Parameter

address

Uri

Der URI der Ressource, die die Daten empfangen soll.

method

String

Die Methode, die zum Senden der Daten an die Ressource verwendet wird. Wenn NULL, lautet der Standard für http POST und für ftp STOR.

Gibt zurück

Task<Stream>

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt. Die Result-Eigenschaft im Task-Objekt gibt Stream zurück, das verwendet wird, um Daten in die Ressource zu schreiben.

Ausnahmen

ArgumentNullException

Der address-Parameter ist null.

WebException

Der durch Kombinieren von BaseAddress und address gebildete URI ist ungültig.

- oder -

Fehler beim Öffnen des Streams.

Hinweise

Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem der beschreibbare Stream für die Datenressource geöffnet wurde. Diese Methode blockiert den aufrufenden Thread nicht, während der Stream geöffnet wird.

Diese Methode ruft eine Stream instance ab, die zum Schreiben von Daten in die durch den address Parameter angegebene Ressource verwendet wird. Der Stream wird mithilfe von Threadressourcen abgerufen, die automatisch aus dem Threadpool zugeordnet werden.

Hinweis

Sie müssen aufrufen Stream.Close , wenn Sie mit dem Stream fertig sind, um zu vermeiden, dass die Systemressourcen knapp werden.

Wenn der method Parameter eine Methode angibt, die vom Server nicht verstanden wird, bestimmen die zugrunde liegenden Protokollklassen, was geschieht. In der Regel wird eine WebException ausgelöst, wobei die Status -Eigenschaft festgelegt ist, um den Fehler anzugeben.

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 die BaseAddress Eigenschaft keine leere Zeichenfolge ("") ist und address keinen absoluten URI enthält, muss ein relativer URI sein, address der mit BaseAddress kombiniert wird, um den absoluten URI der angeforderten Daten zu bilden. Wenn die QueryString Eigenschaft keine leere Zeichenfolge ist, wird sie an addressangefügt.

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

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.

Weitere Informationen

• Stream