WebClient.BaseAddress Proprietà

Definizione

Recupera o imposta l'URI di base per richieste effettuate da un oggetto WebClient.Gets or sets the base URI for requests made by a 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

Valore della proprietà

Classe String contenente l'URI di base per le richieste fatte da una classe WebClient o da un campo Empty nel caso non sia stato specificato l'indirizzo di base.A String containing the base URI for requests made by a WebClient or Empty if no base address has been specified.

Eccezioni

BaseAddress è impostato su un URI non valido.BaseAddress is set to an invalid URI. L'eccezione interna può contenere le informazioni utili per individuare l'errore.The inner exception may contain information that will help you locate the error.

Esempi

L'esempio di codice seguente Scarica i dati da un server Internet e li Visualizza nella console.The following code example downloads data from an Internet server and displays it on the console. Si presuppone che l'indirizzo del server (ad esempio http://www.contoso.com) sia in hostUri e che il percorso della risorsa (ad esempio/default.htm) sia in uriSuffix.It assumes that the server's address (such as http://www.contoso.com) is in hostUri and that the path to the resource (such as /default.htm) is in 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."))

Commenti

La proprietà BaseAddress contiene un URI di base combinato con un indirizzo relativo.The BaseAddress property contains a base URI that is combined with a relative address. Quando si chiama un metodo che carica o Scarica i dati, l'oggetto WebClient combina questo URI di base con l'indirizzo relativo specificato nella chiamata al metodo.When you call a method that uploads or downloads data, the WebClient object combines this base URI with the relative address you specify in the method call. Se si specifica un URI assoluto, WebClient non utilizzerà il valore della proprietà BaseAddress.If you specify an absolute URI, WebClient does not use the BaseAddress property value.

Per rimuovere un valore impostato in precedenza, impostare questa proprietà su null o su una stringa vuota ("").To remove a previously set value, set this property to null or an empty string ("").

Si applica a