WebClient.OpenReadAsync 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. Dessa metoder blockerar inte den anropande tråden.
Överlagringar
| Name | Description |
|---|---|
| OpenReadAsync(Uri) |
Öppnar en läsbar ström som innehåller den angivna resursen. Den här metoden blockerar inte den anropande tråden. |
| OpenReadAsync(Uri, Object) |
Öppnar en läsbar ström som innehåller den angivna resursen. Den här metoden blockerar inte den anropande tråden. |
OpenReadAsync(Uri)
Öppnar en läsbar ström som innehåller den angivna resursen. Den här metoden blockerar inte den anropande tråden.
public:
void OpenReadAsync(Uri ^ address);public void OpenReadAsync(Uri address);member this.OpenReadAsync : Uri -> unitPublic Sub OpenReadAsync (address As Uri)Parametrar
- address
- Uri
URI:n för resursen som ska hämtas.
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 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. Om du vill få ett meddelande när strömmen är tillgänglig lägger du till en händelsehanterare i OpenReadCompleted händelsen.
Note
Du måste anropa Stream.Close när du är klar med Stream för att undvika att systemresurserna tar slut.
Den här metoden blockerar inte den anropande tråden när strömmen öppnas. Om du vill blockera i väntan på strömmen använder du OpenReadAsync -metoden.
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.
Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av OpenRead(Uri).
Gäller för
OpenReadAsync(Uri, Object)
Öppnar en läsbar ström som innehåller den angivna resursen. Den här metoden blockerar inte den anropande tråden.
public:
void OpenReadAsync(Uri ^ address, System::Object ^ userToken);public void OpenReadAsync(Uri address, object userToken);member this.OpenReadAsync : Uri * obj -> unitPublic Sub OpenReadAsync (address As Uri, userToken As Object)Parametrar
- address
- Uri
URI:n för resursen som ska hämtas.
- userToken
- Object
Ett användardefinierat objekt som skickas till metoden som anropas när den asynkrona åtgärden slutförs.
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 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. Om du vill få ett meddelande när strömmen är tillgänglig lägger du till en händelsehanterare i OpenReadCompleted händelsen.
Note
Du måste anropa Stream.Close när du är klar med Stream för att undvika att systemresurserna tar slut.
Den här metoden blockerar inte den anropande tråden när strömmen öppnas. Om du vill blockera i väntan på strömmen använder du OpenRead -metoden.
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.