Freigeben über


WebClient.OpenWriteTaskAsync Methode

Definition

Öffnet einen Datenstrom zum Schreiben von Daten in die angegebene Ressource als asynchronen Vorgang mithilfe eines Aufgabenobjekts. Diese Methoden blockieren den aufrufenden Thread nicht.

Überlädt

OpenWriteTaskAsync(String)

Öffnet einen Datenstrom zum Schreiben von Daten in die angegebene Ressource als asynchronen Vorgang mithilfe eines Aufgabenobjekts.

OpenWriteTaskAsync(Uri)

Öffnet einen Datenstrom zum Schreiben von Daten in die angegebene Ressource als asynchronen Vorgang mithilfe eines Aufgabenobjekts.

OpenWriteTaskAsync(String, String)

Öffnet einen Datenstrom zum Schreiben von Daten in die angegebene Ressource als asynchronen Vorgang mithilfe eines Aufgabenobjekts.

OpenWriteTaskAsync(Uri, String)

Öffnet einen Datenstrom zum Schreiben von Daten in die angegebene Ressource als asynchronen Vorgang mithilfe eines Aufgabenobjekts.

OpenWriteTaskAsync(String)

Quelle:
WebClient.cs
Quelle:
WebClient.cs
Quelle:
WebClient.cs

Öffnet einen Datenstrom zum Schreiben von Daten in die angegebene Ressource als asynchronen Vorgang mithilfe eines Aufgabenobjekts.

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 empfängt.

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt. Die Result-Eigenschaft für das Taskobjekt gibt eine Stream zurück, die zum Schreiben von Daten in die Ressource verwendet wird.

Attribute

Ausnahmen

Der parameter address ist null.

Der URI, der durch die Kombination von BaseAddress und address gebildet wird, ist ungültig.

-oder-

Fehler beim Öffnen des Datenstroms.

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 schreibbare Datenstrom zur Datenressource geöffnet wurde. Mit dieser Methode wird der aufrufende Thread beim Öffnen des Datenstroms nicht blockiert.

Mit dieser Methode wird eine Stream Instanz abgerufen, 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 zugeordnet werden.

Anmerkung

Sie müssen Stream.Close aufrufen, wenn Sie mit dem Stream fertig sind, um zu vermeiden, dass Systemressourcen nicht mehr vorhanden sind.

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 address ein relativer URI sein, der mit BaseAddress kombiniert wird, um den absoluten URI der angeforderten Daten zu bilden. Wenn die eigenschaft QueryString 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.

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

Weitere Informationen

Gilt für:

OpenWriteTaskAsync(Uri)

Quelle:
WebClient.cs
Quelle:
WebClient.cs
Quelle:
WebClient.cs

Öffnet einen Datenstrom zum Schreiben von Daten in die angegebene Ressource als asynchronen Vorgang mithilfe eines Aufgabenobjekts.

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 empfängt.

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt. Die Result-Eigenschaft für das Taskobjekt gibt eine Stream zurück, die zum Schreiben von Daten in die Ressource verwendet wird.

Attribute

Ausnahmen

Der parameter address ist null.

Der URI, der durch die Kombination von BaseAddress und address gebildet wird, ist ungültig.

-oder-

Fehler beim Öffnen des Datenstroms.

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 schreibbare Datenstrom zur Datenressource geöffnet wurde. Mit dieser Methode wird der aufrufende Thread beim Öffnen des Datenstroms nicht blockiert.

Mit dieser Methode wird eine Stream Instanz abgerufen, 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 zugeordnet werden.

Anmerkung

Sie müssen Stream.Close aufrufen, wenn Sie mit dem Stream fertig sind, um zu vermeiden, dass Systemressourcen nicht mehr vorhanden sind.

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 address ein relativer URI sein, der mit BaseAddress kombiniert wird, um den absoluten URI der angeforderten Daten zu bilden. Wenn die eigenschaft QueryString 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.

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

Gilt für:

OpenWriteTaskAsync(String, String)

Quelle:
WebClient.cs
Quelle:
WebClient.cs
Quelle:
WebClient.cs

Öffnet einen Datenstrom zum Schreiben von Daten in die angegebene Ressource als asynchronen Vorgang mithilfe eines Aufgabenobjekts.

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 empfängt.

method
String

Die Methode, die zum Senden der Daten an die Ressource verwendet wird. Wenn NULL, ist der Standardwert POST für HTTP und STOR für ftp.

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt. Die Result-Eigenschaft für das Taskobjekt gibt eine Stream zurück, die zum Schreiben von Daten in die Ressource verwendet wird.

Attribute

Ausnahmen

Der parameter address ist null.

Der URI, der durch die Kombination von BaseAddress und address gebildet wird, ist ungültig.

-oder-

Fehler beim Öffnen des Datenstroms.

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 schreibbare Datenstrom zur Datenressource geöffnet wurde. Mit dieser Methode wird der aufrufende Thread beim Öffnen des Datenstroms nicht blockiert.

Mit dieser Methode wird eine Stream Instanz abgerufen, 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 zugeordnet werden.

Anmerkung

Sie müssen Stream.Close aufrufen, wenn Sie mit dem Stream fertig sind, um zu vermeiden, dass Systemressourcen nicht mehr vorhanden sind.

Wenn der parameter method eine Methode angibt, die vom Server nicht verstanden wird, bestimmen die zugrunde liegenden Protokollklassen, was auftritt. 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 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 address ein relativer URI sein, der mit BaseAddress kombiniert wird, um den absoluten URI der angeforderten Daten zu bilden. Wenn die eigenschaft QueryString 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.

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

Weitere Informationen

Gilt für:

OpenWriteTaskAsync(Uri, String)

Quelle:
WebClient.cs
Quelle:
WebClient.cs
Quelle:
WebClient.cs

Öffnet einen Datenstrom zum Schreiben von Daten in die angegebene Ressource als asynchronen Vorgang mithilfe eines Aufgabenobjekts.

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 empfängt.

method
String

Die Methode, die zum Senden der Daten an die Ressource verwendet wird. Wenn NULL, ist der Standardwert POST für HTTP und STOR für ftp.

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt. Die Result-Eigenschaft für das Taskobjekt gibt eine Stream zurück, die zum Schreiben von Daten in die Ressource verwendet wird.

Attribute

Ausnahmen

Der parameter address ist null.

Der URI, der durch die Kombination von BaseAddress und address gebildet wird, ist ungültig.

-oder-

Fehler beim Öffnen des Datenstroms.

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 schreibbare Datenstrom zur Datenressource geöffnet wurde. Mit dieser Methode wird der aufrufende Thread beim Öffnen des Datenstroms nicht blockiert.

Mit dieser Methode wird eine Stream Instanz abgerufen, 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 zugeordnet werden.

Anmerkung

Sie müssen Stream.Close aufrufen, wenn Sie mit dem Stream fertig sind, um zu vermeiden, dass Systemressourcen nicht mehr vorhanden sind.

Wenn der parameter method eine Methode angibt, die vom Server nicht verstanden wird, bestimmen die zugrunde liegenden Protokollklassen, was auftritt. 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 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 address ein relativer URI sein, der mit BaseAddress kombiniert wird, um den absoluten URI der angeforderten Daten zu bilden. Wenn die eigenschaft QueryString 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.

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

Weitere Informationen

Gilt für: