WebClient.BaseAddress Свойство

Определение

Пространство имен:

System.Net

Сборка:

System.Net.WebClient.dll

Исходный код:

WebClient.cs

Возвращает или задает базовый универсальный код ресурса (URI) для запросов, выполненных WebClient.

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

Значение свойства

String

String, содержащий базовый URI для запросов, выполненных WebClient или Empty, если базовый адрес не указан.

Исключения

ArgumentException

BaseAddress имеет недопустимый универсальный код ресурса (URI). Внутреннее исключение может содержать сведения, которые помогут найти ошибку.

Примеры

В следующем примере кода скачиваются данные с интернет-сервера и отображаются на консоли. Предполагается, что адрес сервера (например, http://www.contoso.com) находится в hostUri, а путь к ресурсу (например,default.htm) находится в uriSuffix.

// 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."))

Комментарии

Осторожность

WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.

Свойство BaseAddress содержит базовый URI, объединенный с относительным адресом. При вызове метода, который отправляет или загружает данные, объект WebClient объединяет этот базовый URI с относительным адресом, указанным в вызове метода. Если указать абсолютный URI, WebClient не использует значение свойства BaseAddress.

Чтобы удалить ранее заданное значение, задайте для этого свойства значение null или пустую строку ("").