WebClient.OpenWriteAsync Metódus

Definíció

Névtér:

System.Net

Szerelvények:

netstandard.dll, System.Net.WebClient.dll

Megnyit egy adatfolyamot, amely adatokat ír a megadott erőforrásba. Ezek a metódusok nem tiltják le a hívó szálat.

Túlterhelések

Name	Description
OpenWriteAsync(Uri, String, Object)	Megnyit egy adatfolyamot, amely adatokat ír a megadott erőforrásba a megadott módszerrel. Ez a metódus nem blokkolja a hívó szálat.
OpenWriteAsync(Uri, String)	Megnyit egy adatfolyamot, amely adatokat ír a megadott erőforrásba. Ez a metódus nem blokkolja a hívó szálat.
OpenWriteAsync(Uri)	Megnyit egy adatfolyamot, amely adatokat ír a megadott erőforrásba. Ez a metódus nem blokkolja a hívó szálat.

OpenWriteAsync(Uri, String, Object)

Forrás:

WebClient.cs

Megnyit egy adatfolyamot, amely adatokat ír a megadott erőforrásba a megadott módszerrel. Ez a metódus nem blokkolja a hívó szálat.

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)

Paraméterek

address

Uri

Az erőforrás URI-ja az adatok fogadásához.

method

String

Az adatok erőforrásba való küldéséhez használt módszer. Null érték esetén az alapértelmezett érték a POST a http és az ftp STOR esetében.

userToken

Object

Egy felhasználó által definiált objektum, amelyet a rendszer az aszinkron művelet befejezésekor meghívt metódusnak ad át.

Kivételek

ArgumentNullException

A address paraméter a következő null: .

WebException

A kombinálással BaseAddressaddress létrehozott URI érvénytelen.

-vagy-

Hiba történt a stream megnyitása közben.

Megjegyzések

Figyelmeztetés

WebRequest, HttpWebRequest, ServicePointés WebClient elavultak, és nem szabad új fejlesztésre használni őket. A HttpClient használható helyette.

Ez a metódus egy írható adatfolyamot kér le, amely adatokat küld egy erőforrásnak. A rendszer aszinkron módon kéri le a streamet a szálkészletből automatikusan lefoglalt szálerőforrások használatával. Ha értesítést szeretne kapni, ha a stream elérhető, adjon hozzá egy eseménykezelőt az OpenWriteCompleted eseményhez. A stream bezárásakor a rendszer elküldi a stream tartalmát a kiszolgálónak.

Ha a method paraméter olyan metódust ad meg, amelyet a kiszolgáló nem ért meg, a mögöttes protokollosztályok határozzák meg, hogy mi történik. A rendszer általában a WebException hibát jelző tulajdonsággal Status dob egy értéket.

A .NET-keretrendszerben a CancelAsync metódus meghívásával megszakíthatja a nem befejezett aszinkron műveleteket.

Ez a metódus nem blokkolja a hívó szálat a stream megnyitása közben. Ha blokkolni szeretné a streamre való várakozást, használja az egyik metódust OpenWrite .

Ha a BaseAddress tulajdonság nem üres sztring ("") és address nem tartalmaz abszolút URI-t, akkor relatív URI-nak kell lennie, address amely a BaseAddress kért adatok abszolút URI-jának létrehozásához van kombinálva. Ha a QueryString tulajdonság nem üres sztring, a program hozzáfűzi.address

Note

Ez a tag nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Network Tracing in .NET Framework.

OpenWriteAsync(Uri, String)

Forrás:

WebClient.cs

Megnyit egy adatfolyamot, amely adatokat ír a megadott erőforrásba. Ez a metódus nem blokkolja a hívó szálat.

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)

Paraméterek

address

Uri

Az erőforrás URI-ja az adatok fogadásához.

method

String

Az adatok erőforrásba való küldéséhez használt módszer. Null érték esetén az alapértelmezett érték a POST a http és az ftp STOR esetében.

Kivételek

ArgumentNullException

A address paraméter a következő null: .

Megjegyzések

Figyelmeztetés

WebRequest, HttpWebRequest, ServicePointés WebClient elavultak, és nem szabad új fejlesztésre használni őket. A HttpClient használható helyette.

Ez a metódus egy írható adatfolyamot kér le, amely adatokat küld egy erőforrásnak. A rendszer a szálkészletből automatikusan lefoglalt szálerőforrások használatával kéri le a streamet. Ha értesítést szeretne kapni, ha a stream elérhető, adjon hozzá egy eseménykezelőt az OpenWriteCompleted eseményhez. Amikor bezárja a streamet, a szál blokkolja a kérés elküldését address és a válasz fogadását.

Ez a metódus nem blokkolja a hívó szálat a stream megnyitása közben. Ha blokkolni szeretné a streamre való várakozást, használja az egyik metódust OpenWrite .

Ha a BaseAddress tulajdonság nem üres sztring ("") és address nem tartalmaz abszolút URI-t, akkor relatív URI-nak kell lennie, address amely a BaseAddress kért adatok abszolút URI-jának létrehozásához van kombinálva. Ha a QueryString tulajdonság nem üres sztring, a program hozzáfűzi.address

Note

Ez a tag nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Network Tracing in .NET Framework.

Ez a metódus a feladatban tárolja az összes olyan nem használati kivételt, amelyet a metódus szinkron megfelelője tud dobni. Ha egy kivételt tárol a visszaadott tevékenységben, akkor a rendszer akkor küldi el a kivételt, amikor a feladatra vár. A használati kivételek(például ArgumentException) továbbra is szinkron módon jelennek meg. A tárolt kivételekről lásd a következő által OpenWrite(Uri, String)kiadott kivételeket: .

OpenWriteAsync(Uri)

Forrás:

WebClient.cs

Megnyit egy adatfolyamot, amely adatokat ír a megadott erőforrásba. Ez a metódus nem blokkolja a hívó szálat.

public:
 void OpenWriteAsync(Uri ^ address);

public void OpenWriteAsync(Uri address);

member this.OpenWriteAsync : Uri -> unit

Public Sub OpenWriteAsync (address As Uri)

Paraméterek

address

Uri

Az erőforrás URI-ja az adatok fogadásához.

Kivételek

ArgumentNullException

A address paraméter a következő null: .

Megjegyzések

Figyelmeztetés

WebRequest, HttpWebRequest, ServicePointés WebClient elavultak, és nem szabad új fejlesztésre használni őket. A HttpClient használható helyette.

Ez a metódus egy írható adatfolyamot kér le, amely adatokat küld egy erőforrásnak. A rendszer a szálkészletből automatikusan lefoglalt szálerőforrások használatával kéri le a streamet. Ha értesítést szeretne kapni, ha a stream elérhető, adjon hozzá egy eseménykezelőt az OpenWriteCompleted eseményhez. Amikor bezárja a streamet, a szál blokkolja a kérés elküldését address és a válasz fogadását.

Ez a metódus nem blokkolja a hívó szálat a stream megnyitása közben. Ha blokkolni szeretné a streamre való várakozást, használja az egyik metódust OpenWrite .

Ha a BaseAddress tulajdonság nem üres sztring ("") és address nem tartalmaz abszolút URI-t, akkor relatív URI-nak kell lennie, address amely a BaseAddress kért adatok abszolút URI-jának létrehozásához van kombinálva. Ha a QueryString tulajdonság nem üres sztring, a program hozzáfűzi.address

Ez a metódus a STOR paranccsal tölt fel egy FTP-erőforrást. HTTP-erőforrás esetén a POST metódust használja a rendszer.

Note

Ez a tag nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Network Tracing in .NET Framework.

Ez a metódus a feladatban tárolja az összes olyan nem használati kivételt, amelyet a metódus szinkron megfelelője tud dobni. Ha egy kivételt tárol a visszaadott tevékenységben, akkor a rendszer akkor küldi el a kivételt, amikor a feladatra vár. A használati kivételek(például ArgumentException) továbbra is szinkron módon jelennek meg. A tárolt kivételekről lásd a következő által OpenWrite(Uri)kiadott kivételeket: .