WebClient.BaseAddress Özellik

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kod:

System.Net.WebClient.dll

Kaynak:

WebClient.cs

WebClienttarafından yapılan istekler için temel URI'yi alır veya ayarlar.

public:
 property System::String ^ BaseAddress { System::String ^ get(); void set(System::String ^ value); };

public string BaseAddress { get; set; }

member this.BaseAddress : string with get, set

Public Property BaseAddress As String

Özellik Değeri

String

Temel adres belirtilmemişse WebClient veya Empty tarafından yapılan istekler için temel URI'yi içeren bir String.

Özel durumlar

ArgumentException

BaseAddress geçersiz bir URI'ye ayarlandı. İç özel durum, hatayı bulmanıza yardımcı olacak bilgiler içerebilir.

Örnekler

Aşağıdaki kod örneği, bir İnternet sunucusundan verileri indirir ve konsolda görüntüler. Sunucunun adresinin (http://www.contoso.comgibi) hostUri olduğunu ve kaynağın yolunun (/default.htmgibi) uriSuffixolduğunu varsayar.

// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;

// Set the BaseAddress of the Web Resource in the WebClient.
myWebClient->BaseAddress = hostUri;
Console::WriteLine( "Downloading from {0}/ {1}", hostUri, uriSuffix );
Console::WriteLine( "\nPress Enter key to continue" );
Console::ReadLine();

// Download the target Web Resource into a Byte array.
array<Byte>^ myDatabuffer = myWebClient->DownloadData( uriSuffix );

// Display the downloaded data.
String^ download = Encoding::ASCII->GetString( myDatabuffer );
Console::WriteLine( download );
Console::WriteLine( "Download of {0}{1} was successful.", myWebClient->BaseAddress, uriSuffix );

// Create a new WebClient instance.
WebClient myWebClient = new WebClient();

// Set the BaseAddress of the Web Resource in the WebClient.
myWebClient.BaseAddress = hostUri;
Console.WriteLine("Downloading from " + hostUri + "/" + uriSuffix);
Console.WriteLine("\nPress Enter key to continue");
Console.ReadLine();	

// Download the target Web Resource into a byte array.
byte[] myDatabuffer = myWebClient.DownloadData (uriSuffix);

// Display the downloaded data.
string download = Encoding.ASCII.GetString(myDatabuffer);
Console.WriteLine(download);

Console.WriteLine("Download of " + myWebClient.BaseAddress.ToString() + uriSuffix + " was successful.");

    ' Create a new WebClient instance.
    Dim myWebClient As New WebClient()

    ' Set the BaseAddress of the Web resource in the WebClient.
    myWebClient.BaseAddress = hostUri
    Console.WriteLine(("Downloading from " + hostUri + "/" + uriSuffix))
    Console.WriteLine(ControlChars.Cr + "Press Enter key to continue")
    Console.ReadLine()

    ' Download the target Web resource into a byte array.
    Dim myDatabuffer As Byte() = myWebClient.DownloadData(uriSuffix)

    ' Display the downloaded data.
Dim download As String = Encoding.ASCII.GetString(myDatabuffer)
Console.WriteLine(download)

    Console.WriteLine(("Download of " + myWebClient.BaseAddress.ToString() + uriSuffix + " was 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.

BaseAddress özelliği, göreli adresle birleştirilmiş bir temel URI içerir. Verileri karşıya yükleyen veya indiren bir yöntemi çağırdığınızda, WebClient nesnesi bu temel URI'yi yöntem çağrısında belirttiğiniz göreli adresle birleştirir. Mutlak bir URI belirtirseniz, WebClientBaseAddress özellik değerini kullanmaz.

Daha önce ayarlanmış bir değeri kaldırmak için bu özelliği null veya boş bir dize ("") olarak ayarlayın.