WebClient Конструктор
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Внимание
WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.
Инициализирует новый экземпляр класса 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 WebClient();
Public Sub New ()
- Атрибуты
Примеры
Следующий пример кода создает WebClient экземпляр, а затем использует его для скачивания данных с сервера и отображения его на системной консоли, для скачивания данных с сервера и записи его в файл, а также для отправки значений формы на сервер и получения ответа.
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
Комментарии
Конструктор без параметров создает новый экземпляр WebClient класса. Метод HTTP по умолчанию — GET. Метод FTP по умолчанию — RETR. По умолчанию Encoding является Default. Значение AllowAutoRedirect по умолчанию — true.