WebClient.BaseAddress Propriété

Définition

Espace de noms:

System.Net

Assembly:

System.Net.WebClient.dll

Source:

WebClient.cs

Obtient ou définit l'URI de base pour les requêtes effectuées par 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

Valeur de propriété

String

String qui contient l'URI de base pour les demandes effectuées par WebClient ou Empty si aucune adresse de base n'a été spécifiée.

Exceptions

ArgumentException

La valeur de BaseAddress est un URI non valide. L'exception interne peut contenir des informations qui vous aideront à trouver l'erreur.

Exemples

L’exemple de code suivant télécharge des données à partir d’un serveur Internet et les affiche sur la console. Il suppose que l’adresse du serveur (telle que http://www.contoso.com) est dans hostUri et que le chemin d’accès à la ressource (tel que /default.htm) se trouve dans 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."))

Remarques

La BaseAddress propriété contient un URI de base combiné à une adresse relative. Lorsque vous appelez une méthode qui charge ou télécharge des données, l’objet WebClient combine cet URI de base avec l’adresse relative que vous spécifiez dans l’appel de méthode. Si vous spécifiez un URI absolu, WebClient n’utilise pas la valeur de la BaseAddress propriété.

Pour supprimer une valeur précédemment définie, définissez cette propriété sur null ou une chaîne vide («  »).