WebClient.OpenWriteTaskAsync Metoda

Definicja

Otwiera strumień służący do zapisywania danych w określonym zasobie jako operacja asynchroniczna przy użyciu obiektu zadania.Opens a stream for writing data to the specified resource as an asynchronous operation using a task object. Te metody nie blokują wątku wywołującego.These methods do not block the calling thread.

Przeciążenia

OpenWriteTaskAsync(String)

Otwiera strumień służący do zapisywania danych w określonym zasobie jako operacja asynchroniczna przy użyciu obiektu zadania.Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.

OpenWriteTaskAsync(Uri)

Otwiera strumień służący do zapisywania danych w określonym zasobie jako operacja asynchroniczna przy użyciu obiektu zadania.Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.

OpenWriteTaskAsync(String, String)

Otwiera strumień służący do zapisywania danych w określonym zasobie jako operacja asynchroniczna przy użyciu obiektu zadania.Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.

OpenWriteTaskAsync(Uri, String)

Otwiera strumień służący do zapisywania danych w określonym zasobie jako operacja asynchroniczna przy użyciu obiektu zadania.Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.

OpenWriteTaskAsync(String)

Otwiera strumień służący do zapisywania danych w określonym zasobie jako operacja asynchroniczna przy użyciu obiektu zadania.Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.

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>
Public Function OpenWriteTaskAsync (address As String) As Task(Of Stream)

Parametry

address
String

Identyfikator URI zasobu, do którego mają zostać odebrane dane.The URI of the resource to receive the data.

Zwraca

Obiekt zadania reprezentujący operację asynchroniczną.The task object representing the asynchronous operation. Właściwość Result obiektu Task zwraca Stream używany do zapisywania danych w zasobie.The Result property on the task object returns a Stream used to write data to the resource.

Atrybuty

Wyjątki

Parametr address ma wartość null.The address parameter is null.

Identyfikator URI utworzony przez połączenie BaseAddress i address jest nieprawidłowy.The URI formed by combining BaseAddress and address is invalid.

— lub —-or- Wystąpił błąd podczas otwierania strumienia.An error occurred while opening the stream.

Uwagi

Ta operacja nie będzie blokować.This operation will not block. Zwrócony obiekt Task<TResult> zakończy się po otwarciu strumienia zapisywalnego do zasobu danych.The returned Task<TResult> object will complete after the a writable stream to the data resource has been opened. Ta metoda nie blokuje wątku wywołującego podczas otwierania strumienia.This method does not block the calling thread while the stream is opening.

Ta metoda pobiera wystąpienie Stream używane do zapisywania danych do zasobu określonego przez parametr address.This method retrieves a Stream instance used to write data to the resource specified by the address parameter. Strumień jest uzyskiwany przy użyciu zasobów wątków, które są automatycznie przydzieleni z puli wątków.The stream is obtained using thread resources that are automatically allocated from the thread pool.

Uwaga

Musisz wywołać Stream.Close po zakończeniu Stream, aby uniknąć braku zasobów systemowych.You must call Stream.Close when you are finished with the Stream to avoid running out of system resources.

Operacje asynchroniczne, które nie zostały ukończone, można anulować przy użyciu metody CancelAsync.Asynchronous operations that have not completed can be canceled using the CancelAsync method.

Jeśli właściwość BaseAddress nie jest pustym ciągiem (""), a address nie zawiera bezwzględnego identyfikatora URI, address musi być względnym identyfikatorem URI, który jest połączony z BaseAddress, aby utworzyć bezwzględny identyfikator URI żądanych danych.If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Jeśli właściwość QueryString nie jest pustym ciągiem, jest dołączana do address.If the QueryString property is not an empty string, it is appended to address.

Ta metoda służy do przekazywania zasobu FTP przy użyciu polecenia STOR.This method uses the STOR command to upload an FTP resource. W przypadku zasobu HTTP używana jest metoda POST.For an HTTP resource, the POST method is used.

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji.This member outputs trace information when you enable network tracing in your application. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.For more information, see Network Tracing in the .NET Framework.

Zobacz też

OpenWriteTaskAsync(Uri)

Otwiera strumień służący do zapisywania danych w określonym zasobie jako operacja asynchroniczna przy użyciu obiektu zadania.Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.

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>
Public Function OpenWriteTaskAsync (address As Uri) As Task(Of Stream)

Parametry

address
Uri

Identyfikator URI zasobu, do którego mają zostać odebrane dane.The URI of the resource to receive the data.

Zwraca

Obiekt zadania reprezentujący operację asynchroniczną.The task object representing the asynchronous operation. Właściwość Result obiektu Task zwraca Stream używany do zapisywania danych w zasobie.The Result property on the task object returns a Stream used to write data to the resource.

Atrybuty

Wyjątki

Parametr address ma wartość null.The address parameter is null.

Identyfikator URI utworzony przez połączenie BaseAddress i address jest nieprawidłowy.The URI formed by combining BaseAddress and address is invalid.

— lub —-or- Wystąpił błąd podczas otwierania strumienia.An error occurred while opening the stream.

Uwagi

Ta operacja nie będzie blokować.This operation will not block. Zwrócony obiekt Task<TResult> zakończy się po otwarciu strumienia zapisywalnego do zasobu danych.The returned Task<TResult> object will complete after the a writable stream to the data resource has been opened. Ta metoda nie blokuje wątku wywołującego podczas otwierania strumienia.This method does not block the calling thread while the stream is opening.

Ta metoda pobiera wystąpienie Stream używane do zapisywania danych do zasobu określonego przez parametr address.This method retrieves a Stream instance used to write data to the resource specified by the address parameter. Strumień jest uzyskiwany przy użyciu zasobów wątków, które są automatycznie przydzieleni z puli wątków.The stream is obtained using thread resources that are automatically allocated from the thread pool.

Uwaga

Musisz wywołać Stream.Close po zakończeniu Stream, aby uniknąć braku zasobów systemowych.You must call Stream.Close when you are finished with the Stream to avoid running out of system resources.

Operacje asynchroniczne, które nie zostały ukończone, można anulować przy użyciu metody CancelAsync.Asynchronous operations that have not completed can be canceled using the CancelAsync method.

Jeśli właściwość BaseAddress nie jest pustym ciągiem (""), a address nie zawiera bezwzględnego identyfikatora URI, address musi być względnym identyfikatorem URI, który jest połączony z BaseAddress, aby utworzyć bezwzględny identyfikator URI żądanych danych.If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Jeśli właściwość QueryString nie jest pustym ciągiem, jest dołączana do address.If the QueryString property is not an empty string, it is appended to address.

Ta metoda służy do przekazywania zasobu FTP przy użyciu polecenia STOR.This method uses the STOR command to upload an FTP resource. W przypadku zasobu HTTP używana jest metoda POST.For an HTTP resource, the POST method is used.

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji.This member outputs trace information when you enable network tracing in your application. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.For more information, see Network Tracing in the .NET Framework.

OpenWriteTaskAsync(String, String)

Otwiera strumień służący do zapisywania danych w określonym zasobie jako operacja asynchroniczna przy użyciu obiektu zadania.Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.

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);
[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>
Public Function OpenWriteTaskAsync (address As String, method As String) As Task(Of Stream)

Parametry

address
String

Identyfikator URI zasobu, do którego mają zostać odebrane dane.The URI of the resource to receive the data.

method
String

Metoda używana do wysyłania danych do zasobu.The method used to send the data to the resource. Jeśli wartość jest równa null, wartość domyślna to POST dla protokołów HTTP i STOR dla usługi FTP.If null, the default is POST for http and STOR for ftp.

Zwraca

Obiekt zadania reprezentujący operację asynchroniczną.The task object representing the asynchronous operation. Właściwość Result obiektu Task zwraca Stream używany do zapisywania danych w zasobie.The Result property on the task object returns a Stream used to write data to the resource.

Atrybuty

Wyjątki

Parametr address ma wartość null.The address parameter is null.

Identyfikator URI utworzony przez połączenie BaseAddress i address jest nieprawidłowy.The URI formed by combining BaseAddress and address is invalid.

— lub —-or- Wystąpił błąd podczas otwierania strumienia.An error occurred while opening the stream.

Uwagi

Ta operacja nie będzie blokować.This operation will not block. Zwrócony obiekt Task<TResult> zakończy się po otwarciu strumienia zapisywalnego do zasobu danych.The returned Task<TResult> object will complete after the a writable stream to the data resource has been opened. Ta metoda nie blokuje wątku wywołującego podczas otwierania strumienia.This method does not block the calling thread while the stream is opening.

Ta metoda pobiera wystąpienie Stream używane do zapisywania danych do zasobu określonego przez parametr address.This method retrieves a Stream instance used to write data to the resource specified by the address parameter. Strumień jest uzyskiwany przy użyciu zasobów wątków, które są automatycznie przydzieleni z puli wątków.The stream is obtained using thread resources that are automatically allocated from the thread pool.

Uwaga

Musisz wywołać Stream.Close po zakończeniu Stream, aby uniknąć braku zasobów systemowych.You must call Stream.Close when you are finished with the Stream to avoid running out of system resources.

Jeśli parametr method określa metodę, która nie jest zrozumiała dla serwera, podstawowe klasy protokołu określają, co się dzieje.If the method parameter specifies a method that is not understood by the server, the underlying protocol classes determine what occurs. Zwykle WebException jest generowany z właściwością Status ustawioną, aby wskazać błąd.Typically, a WebException is thrown with the Status property set to indicate the error.

Operacje asynchroniczne, które nie zostały ukończone, można anulować przy użyciu metody CancelAsync.Asynchronous operations that have not completed can be canceled using the CancelAsync method.

Jeśli właściwość BaseAddress nie jest pustym ciągiem (""), a address nie zawiera bezwzględnego identyfikatora URI, address musi być względnym identyfikatorem URI, który jest połączony z BaseAddress, aby utworzyć bezwzględny identyfikator URI żądanych danych.If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Jeśli właściwość QueryString nie jest pustym ciągiem, jest dołączana do address.If the QueryString property is not an empty string, it is appended to address.

Ta metoda służy do przekazywania zasobu FTP przy użyciu polecenia STOR.This method uses the STOR command to upload an FTP resource. W przypadku zasobu HTTP używana jest metoda POST.For an HTTP resource, the POST method is used.

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji.This member outputs trace information when you enable network tracing in your application. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.For more information, see Network Tracing in the .NET Framework.

Zobacz też

OpenWriteTaskAsync(Uri, String)

Otwiera strumień służący do zapisywania danych w określonym zasobie jako operacja asynchroniczna przy użyciu obiektu zadania.Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.

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);
[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>
Public Function OpenWriteTaskAsync (address As Uri, method As String) As Task(Of Stream)

Parametry

address
Uri

Identyfikator URI zasobu, do którego mają zostać odebrane dane.The URI of the resource to receive the data.

method
String

Metoda używana do wysyłania danych do zasobu.The method used to send the data to the resource. Jeśli wartość jest równa null, wartość domyślna to POST dla protokołów HTTP i STOR dla usługi FTP.If null, the default is POST for http and STOR for ftp.

Zwraca

Obiekt zadania reprezentujący operację asynchroniczną.The task object representing the asynchronous operation. Właściwość Result obiektu Task zwraca Stream używany do zapisywania danych w zasobie.The Result property on the task object returns a Stream used to write data to the resource.

Atrybuty

Wyjątki

Parametr address ma wartość null.The address parameter is null.

Identyfikator URI utworzony przez połączenie BaseAddress i address jest nieprawidłowy.The URI formed by combining BaseAddress and address is invalid.

— lub —-or- Wystąpił błąd podczas otwierania strumienia.An error occurred while opening the stream.

Uwagi

Ta operacja nie będzie blokować.This operation will not block. Zwrócony obiekt Task<TResult> zakończy się po otwarciu strumienia zapisywalnego do zasobu danych.The returned Task<TResult> object will complete after the a writable stream to the data resource has been opened. Ta metoda nie blokuje wątku wywołującego podczas otwierania strumienia.This method does not block the calling thread while the stream is opening.

Ta metoda pobiera wystąpienie Stream używane do zapisywania danych do zasobu określonego przez parametr address.This method retrieves a Stream instance used to write data to the resource specified by the address parameter. Strumień jest uzyskiwany przy użyciu zasobów wątków, które są automatycznie przydzieleni z puli wątków.The stream is obtained using thread resources that are automatically allocated from the thread pool.

Uwaga

Musisz wywołać Stream.Close po zakończeniu Stream, aby uniknąć braku zasobów systemowych.You must call Stream.Close when you are finished with the Stream to avoid running out of system resources.

Jeśli parametr method określa metodę, która nie jest zrozumiała dla serwera, podstawowe klasy protokołu określają, co się dzieje.If the method parameter specifies a method that is not understood by the server, the underlying protocol classes determine what occurs. Zwykle WebException jest generowany z właściwością Status ustawioną, aby wskazać błąd.Typically, a WebException is thrown with the Status property set to indicate the error.

Operacje asynchroniczne, które nie zostały ukończone, można anulować przy użyciu metody CancelAsync.Asynchronous operations that have not completed can be canceled using the CancelAsync method.

Jeśli właściwość BaseAddress nie jest pustym ciągiem (""), a address nie zawiera bezwzględnego identyfikatora URI, address musi być względnym identyfikatorem URI, który jest połączony z BaseAddress, aby utworzyć bezwzględny identyfikator URI żądanych danych.If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Jeśli właściwość QueryString nie jest pustym ciągiem, jest dołączana do address.If the QueryString property is not an empty string, it is appended to address.

Ta metoda służy do przekazywania zasobu FTP przy użyciu polecenia STOR.This method uses the STOR command to upload an FTP resource. W przypadku zasobu HTTP używana jest metoda POST.For an HTTP resource, the POST method is used.

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji.This member outputs trace information when you enable network tracing in your application. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.For more information, see Network Tracing in the .NET Framework.

Zobacz też

Dotyczy