WebClient.OpenWriteAsync Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Otwiera strumień do zapisywania danych w określonym zasobie. Te metody nie blokują wątku wywołującego.
Przeciążenia
OpenWriteAsync(Uri, String, Object) |
Otwiera strumień do zapisywania danych do określonego zasobu 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
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
Otwiera strumień do zapisywania danych do określonego zasobu 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);
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
Parametr address
ma wartość null
.
Identyfikator URI utworzony przez połączenie BaseAddress i address
jest nieprawidłowy.
-lub-
Wystąpił błąd podczas otwierania strumienia.
Uwagi
Ta metoda pobiera zapisywalny strumień, który jest 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. WebException Zazwyczaj obiekt jest zgłaszany z właściwością ustawioną w Status celu wskazania 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 .
Ta metoda nie blokuje wywołującego wątku 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, musi być względnym identyfikatorem URI połączonym address
z BaseAddress w celu utworzenia bezwzględnego identyfikatora URI żądanych danych. QueryString Jeśli właściwość nie jest ciągiem pustym, jest dołączana do address
elementu .
Uwaga
Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w programie .NET Framework.
Dotyczy
OpenWriteAsync(Uri, String)
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
- Ź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);
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
Parametr address
ma wartość null
.
Uwagi
Ta metoda pobiera zapisywalny strumień, który jest 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 wywołującego wątku 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, musi być względnym identyfikatorem URI połączonym address
z BaseAddress w celu utworzenia bezwzględnego identyfikatora URI żądanych danych. QueryString Jeśli właściwość nie jest ciągiem pustym, jest dołączana do address
elementu .
Uwaga
Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w programie .NET Framework.
Ta metoda jest przechowywana w zadaniu, które zwraca wszystkie wyjątki nieużytowe, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwracanym zadaniu, ten wyjątek zostanie zgłoszony podczas oczekiwania zadania. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłoszone przez OpenWrite(Uri, String)usługę .
Dotyczy
OpenWriteAsync(Uri)
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
- Ź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
Parametr address
ma wartość null
.
Uwagi
Ta metoda pobiera zapisywalny strumień, który jest 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 wywołującego wątku 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, musi być względnym identyfikatorem URI połączonym address
z BaseAddress w celu utworzenia bezwzględnego identyfikatora URI żądanych danych. QueryString Jeśli właściwość nie jest ciągiem pustym, jest dołączana do address
elementu .
Ta metoda używa polecenia STOR do przekazania zasobu FTP. W przypadku zasobu HTTP jest używana metoda POST.
Uwaga
Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w programie .NET Framework.
Ta metoda jest przechowywana w zadaniu, które zwraca wszystkie wyjątki nieużytowe, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwracanym zadaniu, ten wyjątek zostanie zgłoszony podczas oczekiwania zadania. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłoszone przez OpenWrite(Uri)usługę .
Dotyczy
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla