WebClient.BaseAddress Eigenschaft

Definition

Namespace:

System.Net

Assembly:

System.Net.WebClient.dll

Quelle:

WebClient.cs

Dient zum Abrufen oder Festlegen des Basis-URI für Anforderungen eines 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

Eigenschaftswert

String

Eine String, die den Basis-URI für Anforderungen eines WebClient oder Empty enthält, wenn keine Basisadresse angegeben wurde.

Ausnahmen

ArgumentException

BaseAddress ist auf einen ungültigen URI festgelegt. Die innere Ausnahme kann Informationen enthalten, die Ihnen helfen, den Fehler zu finden.

Beispiele

Im folgenden Codebeispiel werden Daten von einem Internetserver heruntergeladen und auf der Konsole angezeigt. Es wird davon ausgegangen, dass sich die Adresse des Servers (z. B. http://www.contoso.com) in hostUri befindet und dass sich der Pfad zur Ressource (z. B. /default.htm) in uriSuffixbefindet.

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

Hinweise

Vorsicht

WebRequest, HttpWebRequest, ServicePointund WebClient sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.

Die BaseAddress-Eigenschaft enthält einen Basis-URI, der mit einer relativen Adresse kombiniert wird. Wenn Sie eine Methode aufrufen, die Daten hochlädt oder herunterlädt, kombiniert das WebClient-Objekt diesen Basis-URI mit der relativen Adresse, die Sie im Methodenaufruf angeben. Wenn Sie einen absoluten URI angeben, verwendet WebClient nicht den wert der BaseAddress Eigenschaft.

Um einen zuvor festgelegten Wert zu entfernen, legen Sie diese Eigenschaft auf null oder eine leere Zeichenfolge ("") fest.