WebClient.OpenReadAsync Metódus

Definíció

Névtér:

System.Net

Szerelvények:

netstandard.dll, System.Net.WebClient.dll

Megnyitja a megadott erőforrást tartalmazó olvasható streamet. Ezek a metódusok nem tiltják le a hívó szálat.

Túlterhelések

Name	Description
OpenReadAsync(Uri)	Megnyitja a megadott erőforrást tartalmazó olvasható streamet. Ez a metódus nem blokkolja a hívó szálat.
OpenReadAsync(Uri, Object)	Megnyitja a megadott erőforrást tartalmazó olvasható streamet. Ez a metódus nem blokkolja a hívó szálat.

OpenReadAsync(Uri)

Forrás:

WebClient.cs

Megnyitja a megadott erőforrást tartalmazó olvasható streamet. Ez a metódus nem blokkolja a hívó szálat.

public:
 void OpenReadAsync(Uri ^ address);

public void OpenReadAsync(Uri address);

member this.OpenReadAsync : Uri -> unit

Public Sub OpenReadAsync (address As Uri)

Paraméterek

address

Uri

A lekérni kívánt erőforrás URI-ja.

Kivételek

ArgumentNullException

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

WebException

Az egyesítéssel BaseAddress és a címmel létrehozott URI érvénytelen.

-vagy-

Hiba történt az erőforrás letöltése közben.

-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 lekéri a Stream paraméter által megadott erőforrás eléréséhez használt példányt address . A stream a szálkészletből automatikusan lefoglalt szálerőforrások használatával lesz lekérve. Ha értesítést szeretne kapni, ha a stream elérhető, adjon hozzá egy eseménykezelőt az OpenReadCompleted eseményhez.

Note

A rendszererőforrások elfogyásának elkerülése érdekében hívásra Stream.Close van szükség, ha végzett a Stream művelettel.

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

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

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

Ez a metódus a RETR paranccsal tölt le egy FTP-erőforrást. HTTP-erőforrás esetén a GET 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 OpenRead(Uri)kiadott kivételeket: .

OpenReadAsync(Uri, Object)

Forrás:

WebClient.cs

Megnyitja a megadott erőforrást tartalmazó olvasható streamet. Ez a metódus nem blokkolja a hívó szálat.

public:
 void OpenReadAsync(Uri ^ address, System::Object ^ userToken);

public void OpenReadAsync(Uri address, object? userToken);

member this.OpenReadAsync : Uri * obj -> unit

Public Sub OpenReadAsync (address As Uri, userToken As Object)

Paraméterek

address

Uri

A lekérni kívánt erőforrás URI-ja.

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

Az egyesítéssel BaseAddress és a címmel létrehozott URI érvénytelen.

-vagy-

Hiba történt az erőforrás letöltése közben.

-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 lekéri a Stream paraméter által megadott erőforrás eléréséhez használt példányt address . A stream a szálkészletből automatikusan lefoglalt szálerőforrások használatával lesz lekérve. Ha értesítést szeretne kapni, ha a stream elérhető, adjon hozzá egy eseménykezelőt az OpenReadCompleted eseményhez.

Note

A rendszererőforrások elfogyásának elkerülése érdekében hívásra Stream.Close van szükség, ha végzett a Stream művelettel.

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

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

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

Ez a metódus a RETR paranccsal tölt le egy FTP-erőforrást. HTTP-erőforrás esetén a GET 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.