WebClient Konstruktor
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Achtung
WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.
Initialisiert eine neue Instanz der WebClient-Klasse.
public:
WebClient();
public WebClient ();
[System.Obsolete("WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.", DiagnosticId="SYSLIB0014", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public WebClient ();
Public Sub New ()
- Attribute
Beispiele
Im folgenden Codebeispiel wird eine WebClient instance erstellt und anschließend zum Herunterladen von Daten von einem Server und zum Anzeigen in der Systemkonsole, zum Herunterladen von Daten von einem Server und zum Schreiben in eine Datei sowie zum Hochladen von Formularwerten auf einen Server und zum Empfangen der Antwort verwendet.
try
{
// Download the data to a buffer.
WebClient^ client = gcnew WebClient;
array<Byte>^ pageData = client->DownloadData( "http://www.contoso.com" );
String^ pageHtml = Encoding::ASCII->GetString( pageData );
Console::WriteLine( pageHtml );
// Download the data to a file.
client->DownloadFile( "http://www.contoso.com", "page.htm" );
// Upload some form post values.
NameValueCollection^ form = gcnew NameValueCollection;
form->Add( "MyName", "MyValue" );
array<Byte>^ responseData = client->UploadValues( "http://www.contoso.com/form.aspx", form );
}
catch ( WebException^ webEx )
{
Console::WriteLine( webEx->ToString() );
if ( webEx->Status == WebExceptionStatus::ConnectFailure )
{
Console::WriteLine( "Are you behind a firewall? If so, go through the proxy server." );
}
}
try {
// Download the data to a buffer.
WebClient client = new WebClient();
Byte[] pageData = client.DownloadData("http://www.contoso.com");
string pageHtml = Encoding.ASCII.GetString(pageData);
Console.WriteLine(pageHtml);
// Download the data to a file.
client.DownloadFile("http://www.contoso.com", "page.htm");
// Upload some form post values.
NameValueCollection form = new NameValueCollection();
form.Add("MyName", "MyValue");
Byte[] responseData = client.UploadValues("http://www.contoso.com/form.aspx", form);
}
catch (WebException webEx) {
Console.WriteLine(webEx.ToString());
if(webEx.Status == WebExceptionStatus.ConnectFailure) {
Console.WriteLine("Are you behind a firewall? If so, go through the proxy server.");
}
}
Public Shared Sub Main()
Try
Dim client As New WebClient()
Dim pageData As [Byte]() = client.DownloadData("http://www.contoso.com")
Dim pageHtml As String = Encoding.ASCII.GetString(pageData)
' Download the data to a buffer.
Console.WriteLine(pageHtml)
' Download the data to a file.
client.DownloadFile("http://www.contoso.com", "page.htm")
' Upload some form post values.
dim form as New NameValueCollection()
form.Add("MyName", "MyValue")
' Note that you need to replace "http://localhost/somefile.aspx" with the name of
' a file that is available to your computer.
Dim responseData As [Byte]() = client.UploadValues("http://www.contoso.com/form.aspx", form)
Console.WriteLine(Encoding.ASCII.GetString(responseData))
Catch webEx As WebException
if webEx.Status = WebExceptionStatus.ConnectFailure then
Console.WriteLine("Are you behind a firewall? If so, go through the proxy server.")
end if
Console.Write(webEx.ToString())
End Try
End Sub
Hinweise
Der parameterlose Konstruktor erstellt eine neue instance der WebClient -Klasse. Die HTTP-Standardmethode ist GET. Die FTP-Standardmethode ist RETR. Der Standardwert von Encoding lautet Default. Der Standardwert von AllowAutoRedirect ist true
.
Gilt für:
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für