WebClient.OpenReadTaskAsync Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Öppnar en läsbar ström som innehåller den angivna resursen som en asynkron åtgärd med hjälp av ett aktivitetsobjekt. Dessa metoder blockerar inte den anropande tråden.
Överlagringar
| Name | Description |
|---|---|
| OpenReadTaskAsync(String) |
Öppnar en läsbar ström som innehåller den angivna resursen som en asynkron åtgärd med hjälp av ett aktivitetsobjekt. |
| OpenReadTaskAsync(Uri) |
Öppnar en läsbar ström som innehåller den angivna resursen som en asynkron åtgärd med hjälp av ett aktivitetsobjekt. |
OpenReadTaskAsync(String)
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
Öppnar en läsbar ström som innehåller den angivna resursen som en asynkron åtgärd med hjälp av ett aktivitetsobjekt.
public:
System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenReadTaskAsync(System::String ^ address);public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync(string address);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync(string address);member this.OpenReadTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>[<System.Runtime.InteropServices.ComVisible(false)>]
member this.OpenReadTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>Public Function OpenReadTaskAsync (address As String) As Task(Of Stream)Parametrar
- address
- String
URI:n för resursen som ska hämtas.
Returer
Aktivitetsobjektet som representerar den asynkrona åtgärden. Egenskapen Result för aktivitetsobjektet returnerar en Stream som används för att läsa data från en resurs.
- Attribut
Undantag
Parametern address är null.
Den URI som skapas genom att kombinera BaseAddress och adressen är ogiltig.
-eller-
Ett fel uppstod när resursen skulle laddas ned.
-eller-
Ett fel uppstod när strömmen öppnades.
Kommentarer
Caution
WebRequest, HttpWebRequest, ServicePoint, och WebClient är föråldrade och du bör inte använda dem för ny utveckling. Använd HttpClient i stället.
Den här åtgärden kommer inte att blockeras. Det returnerade objektet slutförs Task<TResult> när en läsbar dataström till dataresursen har öppnats. Den här metoden blockerar inte den anropande tråden när strömmen öppnas.
Den här metoden hämtar en Stream instans som används för att komma åt resursen som anges av parametern address . Dataströmmen hämtas med hjälp av trådresurser som automatiskt allokeras från trådpoolen.
Note
Du måste anropa Stream.Close när du är klar med Stream för att undvika att systemresurserna tar slut.
I .NET Framework kan du avbryta asynkrona åtgärder som inte har slutförts genom att anropa metoden CancelAsync.
Om egenskapen BaseAddress inte är en tom sträng ("") och address inte anger en absolut URI, address måste den vara en relativ URI som kombineras med BaseAddress för att bilda den begärda resursens absoluta URI. Om egenskapen QueryString inte nullär läggs den till addressi .
Den här metoden använder RETR-kommandot för att ladda ned en FTP-resurs. För en HTTP-resurs används GET-metoden.
Note
Den här medlemmen matar ut spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Network Tracing in .NET Framework.
Se även
Gäller för
OpenReadTaskAsync(Uri)
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
Öppnar en läsbar ström som innehåller den angivna resursen som en asynkron åtgärd med hjälp av ett aktivitetsobjekt.
public:
System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenReadTaskAsync(Uri ^ address);public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync(Uri address);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync(Uri address);member this.OpenReadTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>[<System.Runtime.InteropServices.ComVisible(false)>]
member this.OpenReadTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>Public Function OpenReadTaskAsync (address As Uri) As Task(Of Stream)Parametrar
- address
- Uri
URI:n för resursen som ska hämtas.
Returer
Aktivitetsobjektet som representerar den asynkrona åtgärden. Egenskapen Result för aktivitetsobjektet returnerar en Stream som används för att läsa data från en resurs.
- Attribut
Undantag
Parametern address är null.
Den URI som skapas genom att kombinera BaseAddress och adressen är ogiltig.
-eller-
Ett fel uppstod när resursen skulle laddas ned.
-eller-
Ett fel uppstod när strömmen öppnades.
Kommentarer
Caution
WebRequest, HttpWebRequest, ServicePoint, och WebClient är föråldrade och du bör inte använda dem för ny utveckling. Använd HttpClient i stället.
Den här åtgärden kommer inte att blockeras. Det returnerade objektet slutförs Task<TResult> när en läsbar dataström till dataresursen har öppnats. Den här metoden blockerar inte den anropande tråden när strömmen öppnas.
Den här metoden hämtar en Stream instans som används för att komma åt resursen som anges av parametern address . Dataströmmen hämtas med hjälp av trådresurser som automatiskt allokeras från trådpoolen.
Note
Du måste anropa Stream.Close när du är klar med Stream för att undvika att systemresurserna tar slut.
I .NET Framework kan du avbryta asynkrona åtgärder som inte har slutförts genom att anropa metoden CancelAsync.
Om egenskapen BaseAddress inte är en tom sträng ("") och address inte anger en absolut URI, address måste den vara en relativ URI som kombineras med BaseAddress för att bilda den begärda resursens absoluta URI. Om egenskapen QueryString inte nullär läggs den till addressi .
Den här metoden använder RETR-kommandot för att ladda ned en FTP-resurs. För en HTTP-resurs används GET-metoden.
Note
Den här medlemmen matar ut spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Network Tracing in .NET Framework.
