WebClient.DownloadData Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Stáhne prostředek jako Byte pole ze zadaného identifikátoru URI.
Přetížení
DownloadData(String) |
Stáhne prostředek jako Byte pole ze zadaného identifikátoru URI. |
DownloadData(Uri) |
Stáhne prostředek jako Byte pole ze zadaného identifikátoru URI. |
DownloadData(String)
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
Stáhne prostředek jako Byte pole ze zadaného identifikátoru URI.
public:
cli::array <System::Byte> ^ DownloadData(System::String ^ address);
public byte[] DownloadData (string address);
member this.DownloadData : string -> byte[]
Public Function DownloadData (address As String) As Byte()
Parametry
- address
- String
Identifikátor URI, ze kterého se mají stahovat data.
Návraty
Pole Byte obsahující stažený prostředek.
Výjimky
Parametr address
je null
.
Identifikátor URI vytvořený kombinací BaseAddress a address
je neplatný.
-nebo-
Při stahování dat došlo k chybě.
Metoda byla volána současně ve více vláknech.
Příklady
Následující příklad kódu požaduje data ze serveru a zobrazí vrácená data. Předpokládá, že remoteUri
obsahuje platný identifikátor URI pro požadovaná data.
Console::Write( "\nPlease enter a URI (e.g. http://www.contoso.com): " );
String^ remoteUri = Console::ReadLine();
// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;
// Download home page data.
Console::WriteLine( "Downloading {0}", remoteUri );
// Download the Web resource and save it into a data buffer.
array<Byte>^ myDataBuffer = myWebClient->DownloadData( remoteUri );
// Display the downloaded data.
String^ download = Encoding::ASCII->GetString( myDataBuffer );
Console::WriteLine( download );
Console::WriteLine( "Download successful." );
Console.Write("\nPlease enter a URI (for example, http://www.contoso.com): ");
string remoteUri = Console.ReadLine();
// Create a new WebClient instance.
WebClient myWebClient = new WebClient();
// Download home page data.
Console.WriteLine("Downloading " + remoteUri);
// Download the Web resource and save it into a data buffer.
byte[] myDataBuffer = myWebClient.DownloadData (remoteUri);
// Display the downloaded data.
string download = Encoding.ASCII.GetString(myDataBuffer);
Console.WriteLine(download);
Console.WriteLine("Download successful.");
Console.Write(ControlChars.Cr + "Please enter a Url(for example, http://www.msn.com): ")
Dim remoteUrl As String = Console.ReadLine()
' Create a new WebClient instance.
Dim myWebClient As New WebClient()
' Download the home page data.
Console.WriteLine(("Downloading " + remoteUrl))
' DownloadData() method takes a 'uriRemote.ToString()' and downloads the Web resource and saves it into a data buffer.
Dim myDatabuffer As Byte() = myWebClient.DownloadData(remoteUrl)
' Display the downloaded data.
Dim download As String = Encoding.ASCII.GetString(myDataBuffer)
Console.WriteLine(download)
Console.WriteLine("Download successful.")
Poznámky
Metoda DownloadData stáhne prostředek s identifikátorem URI určeným parametrem address
. Tato metoda blokuje při stahování prostředku. Pokud chcete stáhnout prostředek a pokračovat v provádění při čekání na odpověď serveru, použijte jednu z DownloadDataAsync těchto metod.
BaseAddress Pokud vlastnost není prázdný řetězec ("") a address
neobsahuje absolutní identifikátor URI, address
musí být relativní identifikátor URI, který je kombinován sBaseAddress, aby vytvořil absolutní identifikátor URI požadovaných dat.
QueryString Pokud vlastnost není prázdný řetězec, připojí se k address
.
Tato metoda používá příkaz RETR ke stažení prostředku FTP. Pro prostředek HTTP se používá metoda GET.
Poznámka
Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace najdete v tématu Trasování sítě v rozhraní .NET Framework.
Platí pro
DownloadData(Uri)
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
Stáhne prostředek jako Byte pole ze zadaného identifikátoru URI.
public:
cli::array <System::Byte> ^ DownloadData(Uri ^ address);
public byte[] DownloadData (Uri address);
member this.DownloadData : Uri -> byte[]
Public Function DownloadData (address As Uri) As Byte()
Parametry
Návraty
Pole Byte obsahující stažený prostředek.
Výjimky
Parametr address
je null
.
Poznámky
Metoda DownloadData stáhne prostředek s identifikátorem URI určeným parametrem address
. Tato metoda blokuje při stahování prostředku. Pokud chcete stáhnout prostředek a pokračovat v provádění při čekání na odpověď serveru, použijte jednu z DownloadDataAsync těchto metod.
BaseAddress Pokud vlastnost není prázdný řetězec ("") a address
neobsahuje absolutní identifikátor URI, address
musí být relativní identifikátor URI, který je kombinován sBaseAddress, aby vytvořil absolutní identifikátor URI požadovaných dat.
QueryString Pokud vlastnost není prázdný řetězec, připojí se k address
.
Tato metoda používá příkaz RETR ke stažení prostředku FTP. Pro prostředek HTTP se používá metoda GET.
Poznámka
Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace najdete v tématu Trasování sítě v rozhraní .NET Framework.
Platí pro
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro