WebClient.OpenReadTaskAsync Metódus

Definíció

Névtér:

System.Net

Szerelvények:

netstandard.dll, System.Net.WebClient.dll

Megnyit egy olvasható adatfolyamot, amely a megadott erőforrást aszinkron műveletként tartalmazza egy tevékenységobjektum használatával. Ezek a metódusok nem tiltják le a hívó szálat.

Túlterhelések

Name	Description
OpenReadTaskAsync(String)	Megnyit egy olvasható adatfolyamot, amely a megadott erőforrást aszinkron műveletként tartalmazza egy tevékenységobjektum használatával.
OpenReadTaskAsync(Uri)	Megnyit egy olvasható adatfolyamot, amely a megadott erőforrást aszinkron műveletként tartalmazza egy tevékenységobjektum használatával.

OpenReadTaskAsync(String)

Forrás:

WebClient.cs

Megnyit egy olvasható adatfolyamot, amely a megadott erőforrást aszinkron műveletként tartalmazza egy tevékenységobjektum használatával.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenReadTaskAsync(System::String ^ address);

public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync(string address);

member this.OpenReadTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function OpenReadTaskAsync (address As String) As Task(Of Stream)

Paraméterek

address

String

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

Válaszok

Task<Stream>

Az aszinkron műveletet képviselő tevékenységobjektum. A Result tevékenységobjektum tulajdonsága egy Stream erőforrásból származó adatok beolvasására használt értéket ad vissza.

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 művelet nem blokkolja a műveletet. A visszaadott Task<TResult> objektum befejeződik, miután megnyitotta az adaterőforrásnak az olvasható adatfolyamot. Ez a metódus nem blokkolja a hívó szálat a stream megnyitása közben.

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.

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.

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.

Lásd még

• Stream

OpenReadTaskAsync(Uri)

Forrás:

WebClient.cs

Megnyit egy olvasható adatfolyamot, amely a megadott erőforrást aszinkron műveletként tartalmazza egy tevékenységobjektum használatával.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenReadTaskAsync(Uri ^ address);

public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync(Uri address);

member this.OpenReadTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function OpenReadTaskAsync (address As Uri) As Task(Of Stream)

Paraméterek

address

Uri

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

Válaszok

Task<Stream>

Az aszinkron műveletet képviselő tevékenységobjektum. A Result tevékenységobjektum tulajdonsága egy Stream erőforrásból származó adatok beolvasására használt értéket ad vissza.

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 művelet nem blokkolja a műveletet. A visszaadott Task<TResult> objektum befejeződik, miután megnyitotta az adaterőforrásnak az olvasható adatfolyamot. Ez a metódus nem blokkolja a hívó szálat a stream megnyitása közben.

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.

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.

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.

Lásd még

• Stream