WebClient.OpenWriteTaskAsync Metoda

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.WebClient.dll

Otwiera strumień do zapisywania danych do określonego zasobu jako operację asynchroniczną przy użyciu obiektu zadania. Te metody nie blokują wątku wywołującego.

Przeciążenia

OpenWriteTaskAsync(String)	Otwiera strumień do zapisywania danych do określonego zasobu jako operację asynchroniczną przy użyciu obiektu zadania.
OpenWriteTaskAsync(Uri)	Otwiera strumień do zapisywania danych do określonego zasobu jako operację asynchroniczną przy użyciu obiektu zadania.
OpenWriteTaskAsync(String, String)	Otwiera strumień do zapisywania danych do określonego zasobu jako operację asynchroniczną przy użyciu obiektu zadania.
OpenWriteTaskAsync(Uri, String)	Otwiera strumień do zapisywania danych do określonego zasobu jako operację asynchroniczną przy użyciu obiektu zadania.

OpenWriteTaskAsync(String)

Źródło:

WebClient.cs

Otwiera strumień do zapisywania danych do określonego zasobu jako operację asynchroniczną przy użyciu obiektu zadania.

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)

Parametry

address

String

Identyfikator URI zasobu do odbierania danych.

Zwraca

Task<Stream>

Obiekt zadania reprezentujący operację asynchroniczną. Właściwość Result obiektu zadania zwraca Stream używany do zapisywania danych w zasobie.

Wyjątki

ArgumentNullException

Parametr address jest null.

WebException

Identyfikator URI utworzony przez połączenie BaseAddress i address jest nieprawidłowy.

-lub-

Wystąpił błąd podczas otwierania strumienia.

Uwagi

Ostrożność

WebRequest, HttpWebRequest, ServicePointi WebClient są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.

Ta operacja nie zostanie zablokowana. Zwrócony obiekt Task<TResult> zostanie ukończony po otwarciu strumienia zapisywalnego do zasobu danych. Ta metoda nie blokuje wywoływanego wątku podczas otwierania strumienia.

Ta metoda pobiera wystąpienie Stream używane do zapisywania danych w zasobie określonym przez parametr address. Strumień jest uzyskiwany przy użyciu zasobów wątków, które są automatycznie przydzielane z puli wątków.

Nuta

Należy wywołać Stream.Close po zakończeniu pracy z Stream, aby uniknąć wyczerpania zasobów systemowych.

W programach .NET Framework i .NET Core 1.0 można anulować operacje asynchroniczne, które nie zostały ukończone, wywołując metodę CancelAsync.

Jeśli właściwość BaseAddress nie jest pustym ciągiem ("") i address nie zawiera bezwzględnego identyfikatora URI, address musi być względnym identyfikatorem URI połączonym z BaseAddress, aby utworzyć bezwzględny identyfikator URI żądanych danych. Jeśli właściwość QueryString nie jest pustym ciągiem, jest dołączana do address.

Ta metoda używa polecenia STOR do przekazania zasobu FTP. W przypadku zasobu HTTP jest używana metoda POST.

Ten element członkowski generuje informacje śledzenia po włączeniu śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w programie .NET Framework.

Zobacz też

• Stream

OpenWriteTaskAsync(Uri)

Źródło:

WebClient.cs

Otwiera strumień do zapisywania danych do określonego zasobu jako operację asynchroniczną przy użyciu obiektu zadania.

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)

Parametry

address

Uri

Identyfikator URI zasobu do odbierania danych.

Zwraca

Task<Stream>

Obiekt zadania reprezentujący operację asynchroniczną. Właściwość Result obiektu zadania zwraca Stream używany do zapisywania danych w zasobie.

Wyjątki

ArgumentNullException

Parametr address jest null.

WebException

Identyfikator URI utworzony przez połączenie BaseAddress i address jest nieprawidłowy.

-lub-

Wystąpił błąd podczas otwierania strumienia.

Uwagi

Ostrożność

WebRequest, HttpWebRequest, ServicePointi WebClient są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.

Ta operacja nie zostanie zablokowana. Zwrócony obiekt Task<TResult> zostanie ukończony po otwarciu strumienia zapisywalnego do zasobu danych. Ta metoda nie blokuje wywoływanego wątku podczas otwierania strumienia.

Ta metoda pobiera wystąpienie Stream używane do zapisywania danych w zasobie określonym przez parametr address. Strumień jest uzyskiwany przy użyciu zasobów wątków, które są automatycznie przydzielane z puli wątków.

Nuta

Należy wywołać Stream.Close po zakończeniu pracy z Stream, aby uniknąć wyczerpania zasobów systemowych.

W programach .NET Framework i .NET Core 1.0 można anulować operacje asynchroniczne, które nie zostały ukończone, wywołując metodę CancelAsync.

Jeśli właściwość BaseAddress nie jest pustym ciągiem ("") i address nie zawiera bezwzględnego identyfikatora URI, address musi być względnym identyfikatorem URI połączonym z BaseAddress, aby utworzyć bezwzględny identyfikator URI żądanych danych. Jeśli właściwość QueryString nie jest pustym ciągiem, jest dołączana do address.

Ta metoda używa polecenia STOR do przekazania zasobu FTP. W przypadku zasobu HTTP jest używana metoda POST.

Ten element członkowski generuje informacje śledzenia po włączeniu śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w programie .NET Framework.

OpenWriteTaskAsync(String, String)

Źródło:

WebClient.cs

Otwiera strumień do zapisywania danych do określonego zasobu jako operację asynchroniczną przy użyciu obiektu zadania.

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)

Parametry

address

String

Identyfikator URI zasobu do odbierania danych.

method

String

Metoda używana do wysyłania danych do zasobu. Jeśli wartość null, wartość domyślna to POST dla protokołu HTTP i stor dla protokołu FTP.

Zwraca

Task<Stream>

Obiekt zadania reprezentujący operację asynchroniczną. Właściwość Result obiektu zadania zwraca Stream używany do zapisywania danych w zasobie.

Wyjątki

ArgumentNullException

Parametr address jest null.

WebException

Identyfikator URI utworzony przez połączenie BaseAddress i address jest nieprawidłowy.

-lub-

Wystąpił błąd podczas otwierania strumienia.

Uwagi

Ostrożność

WebRequest, HttpWebRequest, ServicePointi WebClient są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.

Ta operacja nie zostanie zablokowana. Zwrócony obiekt Task<TResult> zostanie ukończony po otwarciu strumienia zapisywalnego do zasobu danych. Ta metoda nie blokuje wywoływanego wątku podczas otwierania strumienia.

Ta metoda pobiera wystąpienie Stream używane do zapisywania danych w zasobie określonym przez parametr address. Strumień jest uzyskiwany przy użyciu zasobów wątków, które są automatycznie przydzielane z puli wątków.

Nuta

Należy wywołać Stream.Close po zakończeniu pracy z Stream, aby uniknąć wyczerpania zasobów systemowych.

Jeśli parametr method określa metodę, która nie jest rozumiana przez serwer, podstawowe klasy protokołów określają, co się dzieje. Zazwyczaj WebException jest zgłaszana z właściwością Status ustawioną na wartość błędu.

W programach .NET Framework i .NET Core 1.0 można anulować operacje asynchroniczne, które nie zostały ukończone, wywołując metodę CancelAsync.

Jeśli właściwość BaseAddress nie jest pustym ciągiem ("") i address nie zawiera bezwzględnego identyfikatora URI, address musi być względnym identyfikatorem URI połączonym z BaseAddress, aby utworzyć bezwzględny identyfikator URI żądanych danych. Jeśli właściwość QueryString nie jest pustym ciągiem, jest dołączana do address.

Ta metoda używa polecenia STOR do przekazania zasobu FTP. W przypadku zasobu HTTP jest używana metoda POST.

Ten element członkowski generuje informacje śledzenia po włączeniu śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w programie .NET Framework.

Zobacz też

• Stream

OpenWriteTaskAsync(Uri, String)

Źródło:

WebClient.cs

Otwiera strumień do zapisywania danych do określonego zasobu jako operację asynchroniczną przy użyciu obiektu zadania.

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)

Parametry

address

Uri

Identyfikator URI zasobu do odbierania danych.

method

String

Metoda używana do wysyłania danych do zasobu. Jeśli wartość null, wartość domyślna to POST dla protokołu HTTP i stor dla protokołu FTP.

Zwraca

Task<Stream>

Obiekt zadania reprezentujący operację asynchroniczną. Właściwość Result obiektu zadania zwraca Stream używany do zapisywania danych w zasobie.

Wyjątki

ArgumentNullException

Parametr address jest null.

WebException

Identyfikator URI utworzony przez połączenie BaseAddress i address jest nieprawidłowy.

-lub-

Wystąpił błąd podczas otwierania strumienia.

Uwagi

Ostrożność

WebRequest, HttpWebRequest, ServicePointi WebClient są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.

Ta operacja nie zostanie zablokowana. Zwrócony obiekt Task<TResult> zostanie ukończony po otwarciu strumienia zapisywalnego do zasobu danych. Ta metoda nie blokuje wywoływanego wątku podczas otwierania strumienia.

Ta metoda pobiera wystąpienie Stream używane do zapisywania danych w zasobie określonym przez parametr address. Strumień jest uzyskiwany przy użyciu zasobów wątków, które są automatycznie przydzielane z puli wątków.

Nuta

Należy wywołać Stream.Close po zakończeniu pracy z Stream, aby uniknąć wyczerpania zasobów systemowych.

Jeśli parametr method określa metodę, która nie jest rozumiana przez serwer, podstawowe klasy protokołów określają, co się dzieje. Zazwyczaj WebException jest zgłaszana z właściwością Status ustawioną na wartość błędu.

W programach .NET Framework i .NET Core 1.0 można anulować operacje asynchroniczne, które nie zostały ukończone, wywołując metodę CancelAsync.

Jeśli właściwość BaseAddress nie jest pustym ciągiem ("") i address nie zawiera bezwzględnego identyfikatora URI, address musi być względnym identyfikatorem URI połączonym z BaseAddress, aby utworzyć bezwzględny identyfikator URI żądanych danych. Jeśli właściwość QueryString nie jest pustym ciągiem, jest dołączana do address.

Ta metoda używa polecenia STOR do przekazania zasobu FTP. W przypadku zasobu HTTP jest używana metoda POST.

Ten element członkowski generuje informacje śledzenia po włączeniu śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w programie .NET Framework.

Zobacz też

• Stream