WebClient.OpenWriteAsync Metoda

Definicja

Przestrzeń nazw:

System.Net

Zestawy:

netstandard.dll, System.Net.WebClient.dll

Otwiera strumień do zapisywania danych w określonym zasobie. Te metody nie blokują wątku wywołującego.

Przeciążenia

Nazwa	Opis
OpenWriteAsync(Uri, String, Object)	Otwiera strumień do zapisywania danych w określonym zasobie przy użyciu określonej metody. Ta metoda nie blokuje wątku wywołującego.
OpenWriteAsync(Uri, String)	Otwiera strumień do zapisywania danych w określonym zasobie. Ta metoda nie blokuje wątku wywołującego.
OpenWriteAsync(Uri)	Otwiera strumień do zapisywania danych w określonym zasobie. Ta metoda nie blokuje wątku wywołującego.

OpenWriteAsync(Uri, String, Object)

Źródło:

WebClient.cs

Otwiera strumień do zapisywania danych w określonym zasobie przy użyciu określonej metody. Ta metoda nie blokuje wątku wywołującego.

public:
 void OpenWriteAsync(Uri ^ address, System::String ^ method, System::Object ^ userToken);

public void OpenWriteAsync(Uri address, string? method, object? userToken);

member this.OpenWriteAsync : Uri * string * obj -> unit

Public Sub OpenWriteAsync (address As Uri, method As String, userToken As Object)

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.

userToken

Object

Obiekt zdefiniowany przez użytkownika, który jest przekazywany do metody wywoływanej po zakończeniu operacji asynchronicznej.

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, , HttpWebRequestServicePointi WebClient są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Użyj HttpClient zamiast tego.

Ta metoda pobiera zapisywalny strumień używany do wysyłania danych do zasobu. Strumień jest pobierany asynchronicznie przy użyciu zasobów wątków, które są automatycznie przydzielane z puli wątków. Aby otrzymywać powiadomienia, gdy strumień jest dostępny, dodaj do zdarzenia program obsługi zdarzeń OpenWriteCompleted . Zawartość strumienia jest wysyłana do serwera po zamknięciu strumienia.

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

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 .

Ta metoda nie blokuje wątku wywołującego podczas otwierania strumienia. Aby zablokować podczas oczekiwania na strumień, użyj jednej z OpenWrite metod.

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

Nuta

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.

OpenWriteAsync(Uri, String)

Źródło:

WebClient.cs

Otwiera strumień do zapisywania danych w określonym zasobie. Ta metoda nie blokuje wątku wywołującego.

public:
 void OpenWriteAsync(Uri ^ address, System::String ^ method);

public void OpenWriteAsync(Uri address, string? method);

member this.OpenWriteAsync : Uri * string -> unit

Public Sub OpenWriteAsync (address As Uri, method As String)

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.

Wyjątki

ArgumentNullException

Parametr address jest null.

Uwagi

Ostrożność

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

Ta metoda pobiera zapisywalny strumień używany do wysyłania danych do zasobu. Strumień jest pobierany przy użyciu zasobów wątków, które są automatycznie przydzielane z puli wątków. Aby otrzymywać powiadomienia, gdy strumień jest dostępny, dodaj do zdarzenia program obsługi zdarzeń OpenWriteCompleted . Po zamknięciu strumienia wątek blokuje się do address momentu wysłania żądania i odebrania odpowiedzi.

Ta metoda nie blokuje wątku wywołującego podczas otwierania strumienia. Aby zablokować podczas oczekiwania na strumień, użyj jednej z OpenWrite metod.

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

Nuta

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.

Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez program OpenWrite(Uri, String).

OpenWriteAsync(Uri)

Źródło:

WebClient.cs

Otwiera strumień do zapisywania danych w określonym zasobie. Ta metoda nie blokuje wątku wywołującego.

public:
 void OpenWriteAsync(Uri ^ address);

public void OpenWriteAsync(Uri address);

member this.OpenWriteAsync : Uri -> unit

Public Sub OpenWriteAsync (address As Uri)

Parametry

address

Uri

Identyfikator URI zasobu do odbierania danych.

Wyjątki

ArgumentNullException

Parametr address jest null.

Uwagi

Ostrożność

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

Ta metoda pobiera zapisywalny strumień używany do wysyłania danych do zasobu. Strumień jest pobierany przy użyciu zasobów wątków, które są automatycznie przydzielane z puli wątków. Aby otrzymywać powiadomienia, gdy strumień jest dostępny, dodaj do zdarzenia program obsługi zdarzeń OpenWriteCompleted . Po zamknięciu strumienia wątek blokuje się do address momentu wysłania żądania i odebrania odpowiedzi.

Ta metoda nie blokuje wątku wywołującego podczas otwierania strumienia. Aby zablokować podczas oczekiwania na strumień, użyj jednej z OpenWrite metod.

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

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

Nuta

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.

Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez program OpenWrite(Uri).