WebClient.OpenWriteTaskAsync 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.
Ö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)
Ö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);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (string address);member this.OpenWriteTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>[<System.Runtime.InteropServices.ComVisible(false)>]
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
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.
- Attribute
Ausnahmen
Der address-Parameter ist null.
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 schreibbare Datenstrom der Datenressource geöffnet wurde. Diese Methode blockiert den aufrufenden Thread nicht, während der Datenstrom geöffnet wird.
Diese Methode ruft eine Stream Instanz ab, die zum Schreiben von Daten in die vom address Parameter angegebene Ressource verwendet wird. Der Datenstrom wird mithilfe von Threadressourcen abgerufen, die automatisch aus dem Threadpool zugewiesen werden.
Hinweis
Sie müssen aufrufen Stream.Close , wenn Sie mit der Stream Ausführung von Systemressourcen fertig sind, um den Ablauf von Systemressourcen zu vermeiden.
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 keine absolute URI enthält, muss ein relativer URI sein, address der mit BaseAddress dem absoluten URI der angeforderten Daten kombiniert wird. 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.
Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter "Netzwerkablaufverfolgung" in .NET Framework.
Siehe auch
Gilt für
OpenWriteTaskAsync(Uri)
Ö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);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (Uri address);member this.OpenWriteTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>[<System.Runtime.InteropServices.ComVisible(false)>]
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
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.
- Attribute
Ausnahmen
Der address-Parameter ist null.
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 schreibbare Datenstrom der Datenressource geöffnet wurde. Diese Methode blockiert den aufrufenden Thread nicht, während der Datenstrom geöffnet wird.
Diese Methode ruft eine Stream Instanz ab, die zum Schreiben von Daten in die vom address Parameter angegebene Ressource verwendet wird. Der Datenstrom wird mithilfe von Threadressourcen abgerufen, die automatisch aus dem Threadpool zugewiesen werden.
Hinweis
Sie müssen aufrufen Stream.Close , wenn Sie mit der Stream Ausführung von Systemressourcen fertig sind, um den Ablauf von Systemressourcen zu vermeiden.
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 keine absolute URI enthält, muss ein relativer URI sein, address der mit BaseAddress dem absoluten URI der angeforderten Daten kombiniert wird. 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.
Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter "Netzwerkablaufverfolgung" in .NET Framework.
Gilt für
OpenWriteTaskAsync(String, String)
Ö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);public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (string address, string method);[System.Runtime.InteropServices.ComVisible(false)]
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>[<System.Runtime.InteropServices.ComVisible(false)>]
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
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.
- Attribute
Ausnahmen
Der address-Parameter ist null.
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 schreibbare Datenstrom der Datenressource geöffnet wurde. Diese Methode blockiert den aufrufenden Thread nicht, während der Datenstrom geöffnet wird.
Diese Methode ruft eine Stream Instanz ab, die zum Schreiben von Daten in die vom address Parameter angegebene Ressource verwendet wird. Der Datenstrom wird mithilfe von Threadressourcen abgerufen, die automatisch vom Threadpool zugewiesen werden.
Hinweis
Sie müssen aufrufen Stream.Close , wenn Sie fertig Stream sind, um zu vermeiden, dass Systemressourcen nicht mehr ausgeführt werden.
Wenn der method Parameter eine Methode angibt, die vom Server nicht verstanden wird, bestimmen die zugrunde liegenden Protokollklassen, was auftritt. In der Regel wird ein WebException Fehler ausgelöst, bei dem 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 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.
Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter "Netzwerkablaufverfolgung" in .NET Framework.
Siehe auch
Gilt für
OpenWriteTaskAsync(Uri, String)
Ö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);public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (Uri address, string method);[System.Runtime.InteropServices.ComVisible(false)]
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>[<System.Runtime.InteropServices.ComVisible(false)>]
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
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.
- Attribute
Ausnahmen
Der address-Parameter ist null.
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 schreibbare Datenstrom für die Datenressource geöffnet wurde. Diese Methode blockiert den aufrufenden Thread nicht, während der Datenstrom geöffnet wird.
Diese Methode ruft eine Stream Instanz ab, die zum Schreiben von Daten in die vom address Parameter angegebene Ressource verwendet wird. Der Datenstrom wird mithilfe von Threadressourcen abgerufen, die automatisch vom Threadpool zugewiesen werden.
Hinweis
Sie müssen aufrufen Stream.Close , wenn Sie fertig Stream sind, um zu vermeiden, dass Systemressourcen nicht mehr ausgeführt werden.
Wenn der method Parameter eine Methode angibt, die vom Server nicht verstanden wird, bestimmen die zugrunde liegenden Protokollklassen, was auftritt. In der Regel wird ein WebException Fehler ausgelöst, bei dem 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 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.
Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter "Netzwerkablaufverfolgung" in .NET Framework.