WebClient.BaseAddress Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает базовый 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, содержащая базовый URI для запросов, сделанных WebClient или Empty, если базового адреса не было указано.
Исключения
Базовый адрес 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."))
Комментарии
Свойство BaseAddress содержит базовый URI, объединенный с относительным адресом. При вызове метода, который отправляет или скачивает данные, WebClient объект объединяет этот базовый URI с относительным адресом, указанным в вызове метода. Если указан абсолютный URI, WebClient не использует BaseAddress значение свойства .
Чтобы удалить ранее заданное значение, присвойте этому свойству null
значение или пустую строку ("").
Применяется к
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по