WebClient.DownloadData Yöntem

Tanım

Kaynağı belirtilen URI'den Byte dizisi olarak indirir.

Aşırı Yüklemeler

DownloadData(String)

Kaynağı belirtilen URI'den Byte dizisi olarak indirir.

DownloadData(Uri)

Kaynağı belirtilen URI'den Byte dizisi olarak indirir.

DownloadData(String)

Kaynak:
WebClient.cs
Kaynak:
WebClient.cs
Kaynak:
WebClient.cs

Kaynağı belirtilen URI'den Byte dizisi olarak indirir.

C#
public byte[] DownloadData(string address);

Parametreler

address
String

Verilerin indirildiği URI.

Döndürülenler

Byte[]

İndirilen kaynağı içeren bir Byte dizisi.

Özel durumlar

address parametresi null.

BaseAddress ve address birleştirilerek oluşturulan URI geçersiz.

-veya-

Veriler indirilirken bir hata oluştu.

yöntemi birden çok iş parçacığında aynı anda çağrıldı.

Örnekler

Aşağıdaki kod örneği bir sunucudan veri isteğinde bulunur ve döndürülen verileri görüntüler. remoteUri istenen veriler için geçerli bir URI içerdiği varsayılır.

C#
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.");

Açıklamalar

Dikkat

WebRequest, HttpWebRequest, ServicePointve WebClient kullanım dışıdır ve bunları yeni geliştirme için kullanmamalısınız. Bunun yerine HttpClient kullanın.

DownloadData yöntemi, address parametresi tarafından belirtilen URI'ye sahip kaynağı indirir. Bu yöntem, kaynağı indirirken engeller. Bir kaynağı indirmek ve sunucunun yanıtını beklerken yürütmeye devam etmek için DownloadDataAsync yöntemlerinden birini kullanın.

BaseAddress özelliği boş bir dize ("") değilse ve address mutlak bir URI içermiyorsa, address istenen verilerin mutlak URI'sini oluşturmak için BaseAddress ile birleştirilen göreli bir URI olmalıdır. QueryString özelliği boş bir dize değilse, addresseklenir.

Bu yöntem, FTP kaynağını indirmek için RETR komutunu kullanır. BIR HTTP kaynağı için GET yöntemi kullanılır.

Not

Bu üye, uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz. .NET FrameworkAğ İzleme.

Şunlara uygulanır

.NET 10 ve diğer sürümler
Ürün Sürümler
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

DownloadData(Uri)

Kaynak:
WebClient.cs
Kaynak:
WebClient.cs
Kaynak:
WebClient.cs

Kaynağı belirtilen URI'den Byte dizisi olarak indirir.

C#
public byte[] DownloadData(Uri address);

Parametreler

address
Uri

Uri nesnesi tarafından temsil edilen URI' den veri indirilir.

Döndürülenler

Byte[]

İndirilen kaynağı içeren bir Byte dizisi.

Özel durumlar

address parametresi null.

Açıklamalar

Dikkat

WebRequest, HttpWebRequest, ServicePointve WebClient kullanım dışıdır ve bunları yeni geliştirme için kullanmamalısınız. Bunun yerine HttpClient kullanın.

DownloadData yöntemi, address parametresi tarafından belirtilen URI'ye sahip kaynağı indirir. Bu yöntem, kaynağı indirirken engeller. Bir kaynağı indirmek ve sunucunun yanıtını beklerken yürütmeye devam etmek için DownloadDataAsync yöntemlerinden birini kullanın.

BaseAddress özelliği boş bir dize ("") değilse ve address mutlak bir URI içermiyorsa, address istenen verilerin mutlak URI'sini oluşturmak için BaseAddress ile birleştirilen göreli bir URI olmalıdır. QueryString özelliği boş bir dize değilse, addresseklenir.

Bu yöntem, FTP kaynağını indirmek için RETR komutunu kullanır. BIR HTTP kaynağı için GET yöntemi kullanılır.

Not

Bu üye, uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz. .NET FrameworkAğ İzleme.

Şunlara uygulanır

.NET 10 ve diğer sürümler
Ürün Sürümler
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1