WebClient WebClient WebClient WebClient Class

Определение

Предоставляет общие методы обмена данными с ресурсом, заданным URI.Provides common methods for sending data to and receiving data from a resource identified by a URI.

public ref class WebClient : System::ComponentModel::Component
[System.Runtime.InteropServices.ComVisible(true)]
public class WebClient : System.ComponentModel.Component
type WebClient = class
    inherit Component
Public Class WebClient
Inherits Component
Наследование
Атрибуты

Примеры

Следующий пример кода принимает URI ресурса, получает его и отображает ответ.The following code example takes the URI of a resource, retrieves it, and displays the response.

#using <System.dll>

using namespace System;
using namespace System::Net;
using namespace System::IO;
int main()
{
   array<String^>^args = Environment::GetCommandLineArgs();
   if ( args == nullptr || args->Length == 1 )
   {
      throw gcnew ApplicationException( "Specify the URI of the resource to retrieve." );
   }

   WebClient^ client = gcnew WebClient;
   
   // Add a user agent header in case the 
   // requested URI contains a query.
   client->Headers->Add( "user-agent", "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.2; .NET CLR 1.0.3705;)" );
   Stream^ data = client->OpenRead( args[ 1 ] );
   StreamReader^ reader = gcnew StreamReader( data );
   String^ s = reader->ReadToEnd();
   Console::WriteLine( s );
   data->Close();
   reader->Close();
}

using System;
using System.Net;
using System.IO;

public class Test
{
    public static void Main (string[] args)
    {
        if (args == null || args.Length == 0)
        {
            throw new ApplicationException ("Specify the URI of the resource to retrieve.");
        }
        WebClient client = new WebClient ();

        // Add a user agent header in case the 
        // requested URI contains a query.

        client.Headers.Add ("user-agent", "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.2; .NET CLR 1.0.3705;)");

        Stream data = client.OpenRead (args[0]);
        StreamReader reader = new StreamReader (data);
        string s = reader.ReadToEnd ();
        Console.WriteLine (s);
        data.Close ();
        reader.Close ();
    }
}
Imports System.Net
Imports System.IO



Public Class Test
    
    Public Shared Sub Main(args() As String)
        If args Is Nothing OrElse args.Length = 0 Then
            Throw New ApplicationException("Specify the URI of the resource to retrieve.")
        End If
        Dim client As New WebClient()
        
        ' Add a user agent header in case the 
        ' requested URI contains a query.
        client.Headers.Add("user-agent", "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.2; .NET CLR 1.0.3705;)")
        
        Dim data As Stream = client.OpenRead(args(0))
        Dim reader As New StreamReader(data)
        Dim s As String = reader.ReadToEnd()
        Console.WriteLine(s)
        data.Close()
        reader.Close()
    End Sub
End Class 'Test

Комментарии

Важно!

Мы не рекомендуем использовать WebClient класс для новой разработки.We don't recommend that you use the WebClient class for new development. Вместо этого используйте System.Net.Http.HttpClient класс.Instead, use the System.Net.Http.HttpClient class.

WebClient Класс предоставляет общие методы отправки данных или получения данных из любого локального, интрасети или Интернет-ресурса, идентифицируемого по универсальному коду ресурса (URI).The WebClient class provides common methods for sending data to or receiving data from any local, intranet, or Internet resource identified by a URI.

WebClient КлассWebRequest использует класс для предоставления доступа к ресурсам.The WebClient class uses the WebRequest class to provide access to resources. WebClientэкземпляры могут получать доступ к данным WebRequest с любыми потомками, WebRequest.RegisterPrefix зарегистрированными в методе.WebClient instances can access data with any WebRequest descendant registered with the WebRequest.RegisterPrefix method.

Примечание

По умолчанию .NET Framework поддерживает URI, начинающиеся с http:идентификаторов ftp:схем, file: https:, и.By default, the .NET Framework supports URIs that begin with http:, https:, ftp:, and file: scheme identifiers.

В следующей таблице описаны WebClient методы для передачи данных в ресурс.The following table describes WebClient methods for uploading data to a resource.

МетодMethod ОписаниеDescription
OpenWrite Извлекает объект Stream , используемый для отправки данных в ресурс.Retrieves a Stream used to send data to the resource.
OpenWriteAsync Извлекает объект Stream , используемый для отправки данных в ресурс, не блокируя вызывающий поток.Retrieves a Stream used to send data to the resource, without blocking the calling thread.
UploadData Отправляет массив байтов в ресурс и возвращает Byte массив, содержащий любой ответ.Sends a byte array to the resource and returns a Byte array containing any response.
UploadDataAsync Byte Отправляет массив в ресурс, не блокируя вызывающий поток.Sends a Byte array to the resource, without blocking the calling thread.
UploadFile Отправляет локальный файл в ресурс и возвращает Byte массив, содержащий любой ответ.Sends a local file to the resource and returns a Byte array containing any response.
UploadFileAsync Отправляет локальный файл в ресурс, не блокируя вызывающий поток.Sends a local file to the resource, without blocking the calling thread.
UploadValues Отправляет в ресурс и Byte возвращает массив, содержащий любой ответ. NameValueCollectionSends a NameValueCollection to the resource and returns a Byte array containing any response.
UploadValuesAsync Отправляет в ресурс и возвращает массив, содержащий любой ответ, без блокирования вызывающего потока. Byte NameValueCollectionSends a NameValueCollection to the resource and returns a Byte array containing any response, without blocking the calling thread.
UploadString String Отправляет в ресурс, не блокируя вызывающий поток.Sends a String to the resource, without blocking the calling thread.
UploadStringAsync String Отправляет в ресурс, не блокируя вызывающий поток.Sends a String to the resource, without blocking the calling thread.

В следующей таблице описаны WebClient методы загрузки данных из ресурса.The following table describes WebClient methods for downloading data from a resource.

МетодMethod ОписаниеDescription
OpenRead Возвращает данные из ресурса в виде Stream.Returns the data from a resource as a Stream.
OpenReadAsync Возвращает данные из ресурса, не блокируя вызывающий поток.Returns the data from a resource, without blocking the calling thread.
DownloadData Загружает данные из ресурса и возвращает Byte массив.Downloads data from a resource and returns a Byte array.
DownloadDataAsync Загружает данные из ресурса и возвращает Byte массив, не блокируя вызывающий поток.Downloads data from a resource and returns a Byte array, without blocking the calling thread.
DownloadFile Скачивает данные из ресурса в локальный файл.Downloads data from a resource to a local file.
DownloadFileAsync Загружает данные из ресурса в локальный файл, не блокируя вызывающий поток.Downloads data from a resource to a local file, without blocking the calling thread.
DownloadString Скачивает объект String из ресурса и Stringвозвращает.Downloads a String from a resource and returns a String.
DownloadStringAsync Скачивает объект String из ресурса, не блокируя вызывающий поток.Downloads a String from a resource, without blocking the calling thread.

CancelAsync Метод можно использовать для отмены асинхронных операций, которые не были завершены.You can use the CancelAsync method to cancel asynchronous operations that have not completed.

По WebClient умолчанию экземпляр не отправляет дополнительные заголовки HTTP.A WebClient instance does not send optional HTTP headers by default. Если для запроса требуется необязательный заголовок, необходимо добавить заголовок в Headers коллекцию.If your request requires an optional header, you must add the header to the Headers collection. Например, чтобы хранить запросы в ответе, необходимо добавить заголовок User-Agent.For example, to retain queries in the response, you must add a user-agent header. Кроме того, серверы могут возвращать 500 (внутренняя ошибка сервера), если отсутствует заголовок агента пользователя.Also, servers may return 500 (Internal Server Error) if the user agent header is missing.

AllowAutoRedirectимеет значение true в WebClient экземплярах.AllowAutoRedirect is set to true in WebClient instances.

Примечания для тех, кто наследует этот метод

Производные классы должны вызывать реализацию WebClient базового класса, чтобы убедиться, что производный класс работает должным образом.Derived classes should call the base class implementation of WebClient to ensure the derived class works as expected.

Конструкторы

WebClient() WebClient() WebClient() WebClient()

Инициализирует новый экземпляр класса WebClient.Initializes a new instance of the WebClient class.

Свойства

AllowReadStreamBuffering AllowReadStreamBuffering AllowReadStreamBuffering AllowReadStreamBuffering

Получает или задает значение, которое указывает, будет ли выполняться буферизация данных, считываемых с интернет-ресурса для экземпляра WebClient.Gets or sets a value that indicates whether to buffer the data read from the Internet resource for a WebClient instance.

AllowWriteStreamBuffering AllowWriteStreamBuffering AllowWriteStreamBuffering AllowWriteStreamBuffering

Получает или задает значение, которое указывает, будет ли выполняться буферизация данных, записываемых в интернет-ресурс для экземпляра WebClient.Gets or sets a value that indicates whether to buffer the data written to the Internet resource for a WebClient instance.

BaseAddress BaseAddress BaseAddress BaseAddress

Возвращает или задает базовый URI для запросов, выполняемых экземпляром WebClient.Gets or sets the base URI for requests made by a WebClient.

CachePolicy CachePolicy CachePolicy CachePolicy

Возвращает или задает политику кэширования приложения для любых ресурсов, полученных этим экземпляром WebClient с помощью объектов WebRequest.Gets or sets the application's cache policy for any resources obtained by this WebClient instance using WebRequest objects.

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Возвращает значение, показывающее, может ли компонент вызывать событие.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
Container Container Container Container

Возвращает контейнер IContainer, содержащий компонент Component.Gets the IContainer that contains the Component.

(Inherited from Component)
Credentials Credentials Credentials Credentials

Возвращает или задает учетные данные сети, которые передаются на узел и используются для проверки подлинности запроса.Gets or sets the network credentials that are sent to the host and used to authenticate the request.

DesignMode DesignMode DesignMode DesignMode

Возвращает значение, указывающее, находится ли данный компонент Component в режиме конструктора в настоящее время.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Encoding Encoding Encoding Encoding

Получает или задает Encoding, используемые для отправки и скачивания строк.Gets or sets the Encoding used to upload and download strings.

Events Events Events Events

Возвращает список обработчиков событий, которые прикреплены к этому объекту Component.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
Headers Headers Headers Headers

Возвращает или задает коллекцию пар "имя-значение" заголовков, связанных с запросом.Gets or sets a collection of header name/value pairs associated with the request.

IsBusy IsBusy IsBusy IsBusy

Возвращает значение, указывающее, выполняется ли веб-запрос.Gets whether a Web request is in progress.

Proxy Proxy Proxy Proxy

Возвращает или задает прокси-сервер, используемый этим объектом WebClient.Gets or sets the proxy used by this WebClient object.

QueryString QueryString QueryString QueryString

Возвращает или задает коллекцию пар "имя-значение" запросов, связанных с запросом.Gets or sets a collection of query name/value pairs associated with the request.

ResponseHeaders ResponseHeaders ResponseHeaders ResponseHeaders

Возвращает коллекцию пар "имя-значение" заголовков, связанных с запросом.Gets a collection of header name/value pairs associated with the response.

Site Site Site Site

Возвращает или задает ISite объекта Component.Gets or sets the ISite of the Component.

(Inherited from Component)
UseDefaultCredentials UseDefaultCredentials UseDefaultCredentials UseDefaultCredentials

Возвращает или задает значение Boolean, которое управляет отправкой учетных данных DefaultCredentials вместе с запросами.Gets or sets a Boolean value that controls whether the DefaultCredentials are sent with requests.

Методы

CancelAsync() CancelAsync() CancelAsync() CancelAsync()

Отменяет асинхронную операцию в очереди.Cancels a pending asynchronous operation.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Освобождает все ресурсы, занятые модулем Component.Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Освобождает неуправляемые ресурсы, используемые объектом Component, а при необходимости освобождает также управляемые ресурсы.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Inherited from Component)
DownloadData(String) DownloadData(String) DownloadData(String) DownloadData(String)

Загружает ресурс, как массив Byte из заданного URI.Downloads the resource as a Byte array from the URI specified.

DownloadData(Uri) DownloadData(Uri) DownloadData(Uri) DownloadData(Uri)

Загружает ресурс, как массив Byte из заданного URI.Downloads the resource as a Byte array from the URI specified.

DownloadDataAsync(Uri) DownloadDataAsync(Uri) DownloadDataAsync(Uri) DownloadDataAsync(Uri)

Загружает ресурс как массив Byte из URI, указанного как асинхронная операция.Downloads the resource as a Byte array from the URI specified as an asynchronous operation.

DownloadDataAsync(Uri, Object) DownloadDataAsync(Uri, Object) DownloadDataAsync(Uri, Object) DownloadDataAsync(Uri, Object)

Загружает ресурс как массив Byte из URI, указанного как асинхронная операция.Downloads the resource as a Byte array from the URI specified as an asynchronous operation.

DownloadDataTaskAsync(String) DownloadDataTaskAsync(String) DownloadDataTaskAsync(String) DownloadDataTaskAsync(String)

Загружает ресурс как массив Byte из URI, указанного как асинхронная операция с помощью объекта задачи.Downloads the resource as a Byte array from the URI specified as an asynchronous operation using a task object.

DownloadDataTaskAsync(Uri) DownloadDataTaskAsync(Uri) DownloadDataTaskAsync(Uri) DownloadDataTaskAsync(Uri)

Загружает ресурс как массив Byte из URI, указанного как асинхронная операция с помощью объекта задачи.Downloads the resource as a Byte array from the URI specified as an asynchronous operation using a task object.

DownloadFile(String, String) DownloadFile(String, String) DownloadFile(String, String) DownloadFile(String, String)

Загружает в локальный файл ресурс с указанным URI.Downloads the resource with the specified URI to a local file.

DownloadFile(Uri, String) DownloadFile(Uri, String) DownloadFile(Uri, String) DownloadFile(Uri, String)

Загружает в локальный файл ресурс с указанным URI.Downloads the resource with the specified URI to a local file.

DownloadFileAsync(Uri, String) DownloadFileAsync(Uri, String) DownloadFileAsync(Uri, String) DownloadFileAsync(Uri, String)

Загружает в локальный файл ресурс с указанным URI.Downloads, to a local file, the resource with the specified URI. Этот метод не блокирует вызывающий поток.This method does not block the calling thread.

DownloadFileAsync(Uri, String, Object) DownloadFileAsync(Uri, String, Object) DownloadFileAsync(Uri, String, Object) DownloadFileAsync(Uri, String, Object)

Загружает в локальный файл ресурс с указанным URI.Downloads, to a local file, the resource with the specified URI. Этот метод не блокирует вызывающий поток.This method does not block the calling thread.

DownloadFileTaskAsync(String, String) DownloadFileTaskAsync(String, String) DownloadFileTaskAsync(String, String) DownloadFileTaskAsync(String, String)

Загружает указанный ресурс в локальный файл как асинхронная операция с помощью объекта задачи.Downloads the specified resource to a local file as an asynchronous operation using a task object.

DownloadFileTaskAsync(Uri, String) DownloadFileTaskAsync(Uri, String) DownloadFileTaskAsync(Uri, String) DownloadFileTaskAsync(Uri, String)

Загружает указанный ресурс в локальный файл как асинхронная операция с помощью объекта задачи.Downloads the specified resource to a local file as an asynchronous operation using a task object.

DownloadString(String) DownloadString(String) DownloadString(String) DownloadString(String)

Загружает требуемый ресурс как строку String.Downloads the requested resource as a String. Ресурс, который требуется загрузить, указан как строка String, содержащая URI.The resource to download is specified as a String containing the URI.

DownloadString(Uri) DownloadString(Uri) DownloadString(Uri) DownloadString(Uri)

Загружает требуемый ресурс как строку String.Downloads the requested resource as a String. Загружаемый ресурс указан как Uri.The resource to download is specified as a Uri.

DownloadStringAsync(Uri) DownloadStringAsync(Uri) DownloadStringAsync(Uri) DownloadStringAsync(Uri)

Загружает ресурс, указанный как Uri.Downloads the resource specified as a Uri. Этот метод не блокирует вызывающий поток.This method does not block the calling thread.

DownloadStringAsync(Uri, Object) DownloadStringAsync(Uri, Object) DownloadStringAsync(Uri, Object) DownloadStringAsync(Uri, Object)

Загружает указанную строку в указанный ресурс.Downloads the specified string to the specified resource. Этот метод не блокирует вызывающий поток.This method does not block the calling thread.

DownloadStringTaskAsync(String) DownloadStringTaskAsync(String) DownloadStringTaskAsync(String) DownloadStringTaskAsync(String)

Загружает ресурс как String из URI, указанного как асинхронная операция с помощью объекта задачи.Downloads the resource as a String from the URI specified as an asynchronous operation using a task object.

DownloadStringTaskAsync(Uri) DownloadStringTaskAsync(Uri) DownloadStringTaskAsync(Uri) DownloadStringTaskAsync(Uri)

Загружает ресурс как String из URI, указанного как асинхронная операция с помощью объекта задачи.Downloads the resource as a String from the URI specified as an asynchronous operation using a task object.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Возвращает объект, представляющий службу, обеспечиваемую компонентом Component или его контейнером Container.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
GetWebRequest(Uri) GetWebRequest(Uri) GetWebRequest(Uri) GetWebRequest(Uri)

Возвращает объект WebRequest для заданного ресурса.Returns a WebRequest object for the specified resource.

GetWebResponse(WebRequest) GetWebResponse(WebRequest) GetWebResponse(WebRequest) GetWebResponse(WebRequest)

Возвращает объект WebResponse для заданного объекта WebRequest.Returns the WebResponse for the specified WebRequest.

GetWebResponse(WebRequest, IAsyncResult) GetWebResponse(WebRequest, IAsyncResult) GetWebResponse(WebRequest, IAsyncResult) GetWebResponse(WebRequest, IAsyncResult)

Возвращает ответ WebResponse для указанного запроса WebRequest, используя указанный IAsyncResult.Returns the WebResponse for the specified WebRequest using the specified IAsyncResult.

InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Получает объект службы времени существования для управления политикой времени существования для этого экземпляра.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Создает неполную копию текущего объекта MarshalByRefObject.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
OnDownloadDataCompleted(DownloadDataCompletedEventArgs) OnDownloadDataCompleted(DownloadDataCompletedEventArgs) OnDownloadDataCompleted(DownloadDataCompletedEventArgs) OnDownloadDataCompleted(DownloadDataCompletedEventArgs)

Вызывает событие DownloadDataCompleted.Raises the DownloadDataCompleted event.

OnDownloadFileCompleted(AsyncCompletedEventArgs) OnDownloadFileCompleted(AsyncCompletedEventArgs) OnDownloadFileCompleted(AsyncCompletedEventArgs) OnDownloadFileCompleted(AsyncCompletedEventArgs)

Создает событие DownloadFileCompleted.Raises the DownloadFileCompleted event.

OnDownloadProgressChanged(DownloadProgressChangedEventArgs) OnDownloadProgressChanged(DownloadProgressChangedEventArgs) OnDownloadProgressChanged(DownloadProgressChangedEventArgs) OnDownloadProgressChanged(DownloadProgressChangedEventArgs)

Вызывает событие DownloadProgressChanged.Raises the DownloadProgressChanged event.

OnDownloadStringCompleted(DownloadStringCompletedEventArgs) OnDownloadStringCompleted(DownloadStringCompletedEventArgs) OnDownloadStringCompleted(DownloadStringCompletedEventArgs) OnDownloadStringCompleted(DownloadStringCompletedEventArgs)

Создает событие DownloadStringCompleted.Raises the DownloadStringCompleted event.

OnOpenReadCompleted(OpenReadCompletedEventArgs) OnOpenReadCompleted(OpenReadCompletedEventArgs) OnOpenReadCompleted(OpenReadCompletedEventArgs) OnOpenReadCompleted(OpenReadCompletedEventArgs)

Вызывает событие OpenReadCompleted.Raises the OpenReadCompleted event.

OnOpenWriteCompleted(OpenWriteCompletedEventArgs) OnOpenWriteCompleted(OpenWriteCompletedEventArgs) OnOpenWriteCompleted(OpenWriteCompletedEventArgs) OnOpenWriteCompleted(OpenWriteCompletedEventArgs)

Вызывает событие OpenWriteCompleted.Raises the OpenWriteCompleted event.

OnUploadDataCompleted(UploadDataCompletedEventArgs) OnUploadDataCompleted(UploadDataCompletedEventArgs) OnUploadDataCompleted(UploadDataCompletedEventArgs) OnUploadDataCompleted(UploadDataCompletedEventArgs)

Вызывает событие UploadDataCompleted.Raises the UploadDataCompleted event.

OnUploadFileCompleted(UploadFileCompletedEventArgs) OnUploadFileCompleted(UploadFileCompletedEventArgs) OnUploadFileCompleted(UploadFileCompletedEventArgs) OnUploadFileCompleted(UploadFileCompletedEventArgs)

Создает событие UploadFileCompleted.Raises the UploadFileCompleted event.

OnUploadProgressChanged(UploadProgressChangedEventArgs) OnUploadProgressChanged(UploadProgressChangedEventArgs) OnUploadProgressChanged(UploadProgressChangedEventArgs) OnUploadProgressChanged(UploadProgressChangedEventArgs)

Вызывает событие UploadProgressChanged.Raises the UploadProgressChanged event.

OnUploadStringCompleted(UploadStringCompletedEventArgs) OnUploadStringCompleted(UploadStringCompletedEventArgs) OnUploadStringCompleted(UploadStringCompletedEventArgs) OnUploadStringCompleted(UploadStringCompletedEventArgs)

Вызывает событие UploadStringCompleted.Raises the UploadStringCompleted event.

OnUploadValuesCompleted(UploadValuesCompletedEventArgs) OnUploadValuesCompleted(UploadValuesCompletedEventArgs) OnUploadValuesCompleted(UploadValuesCompletedEventArgs) OnUploadValuesCompleted(UploadValuesCompletedEventArgs)

Вызывает событие UploadValuesCompleted.Raises the UploadValuesCompleted event.

OnWriteStreamClosed(WriteStreamClosedEventArgs) OnWriteStreamClosed(WriteStreamClosedEventArgs) OnWriteStreamClosed(WriteStreamClosedEventArgs) OnWriteStreamClosed(WriteStreamClosedEventArgs)

Вызывает событие WriteStreamClosed.Raises the WriteStreamClosed event.

OpenRead(String) OpenRead(String) OpenRead(String) OpenRead(String)

Открывает читаемый поток для данных, загруженных с ресурса, URI которого был указан как String.Opens a readable stream for the data downloaded from a resource with the URI specified as a String.

OpenRead(Uri) OpenRead(Uri) OpenRead(Uri) OpenRead(Uri)

Открывает читаемый поток для данных, загруженных с ресурса, URI которого был указан как Uri.Opens a readable stream for the data downloaded from a resource with the URI specified as a Uri

OpenReadAsync(Uri) OpenReadAsync(Uri) OpenReadAsync(Uri) OpenReadAsync(Uri)

Открывает поток, доступный для чтения и содержащий указанный ресурс.Opens a readable stream containing the specified resource. Этот метод не блокирует вызывающий поток.This method does not block the calling thread.

OpenReadAsync(Uri, Object) OpenReadAsync(Uri, Object) OpenReadAsync(Uri, Object) OpenReadAsync(Uri, Object)

Открывает поток, доступный для чтения и содержащий указанный ресурс.Opens a readable stream containing the specified resource. Этот метод не блокирует вызывающий поток.This method does not block the calling thread.

OpenReadTaskAsync(String) OpenReadTaskAsync(String) OpenReadTaskAsync(String) OpenReadTaskAsync(String)

Открывает считываемый поток, содержащий указанный ресурс как асинхронная операция с помощью объекта задачи.Opens a readable stream containing the specified resource as an asynchronous operation using a task object.

OpenReadTaskAsync(Uri) OpenReadTaskAsync(Uri) OpenReadTaskAsync(Uri) OpenReadTaskAsync(Uri)

Открывает считываемый поток, содержащий указанный ресурс как асинхронная операция с помощью объекта задачи.Opens a readable stream containing the specified resource as an asynchronous operation using a task object.

OpenWrite(String) OpenWrite(String) OpenWrite(String) OpenWrite(String)

Открывает поток для записи данных в указанный ресурс.Opens a stream for writing data to the specified resource.

OpenWrite(String, String) OpenWrite(String, String) OpenWrite(String, String) OpenWrite(String, String)

Открывает поток для записи данных в указанный ресурс с помощью указанного метода.Opens a stream for writing data to the specified resource, using the specified method.

OpenWrite(Uri) OpenWrite(Uri) OpenWrite(Uri) OpenWrite(Uri)

Открывает поток для записи данных в указанный ресурс.Opens a stream for writing data to the specified resource.

OpenWrite(Uri, String) OpenWrite(Uri, String) OpenWrite(Uri, String) OpenWrite(Uri, String)

Открывает поток для записи данных в указанный ресурс с помощью указанного метода.Opens a stream for writing data to the specified resource, by using the specified method.

OpenWriteAsync(Uri) OpenWriteAsync(Uri) OpenWriteAsync(Uri) OpenWriteAsync(Uri)

Открывает поток для записи данных в указанный ресурс.Opens a stream for writing data to the specified resource. Этот метод не блокирует вызывающий поток.This method does not block the calling thread.

OpenWriteAsync(Uri, String) OpenWriteAsync(Uri, String) OpenWriteAsync(Uri, String) OpenWriteAsync(Uri, String)

Открывает поток для записи данных в указанный ресурс.Opens a stream for writing data to the specified resource. Этот метод не блокирует вызывающий поток.This method does not block the calling thread.

OpenWriteAsync(Uri, String, Object) OpenWriteAsync(Uri, String, Object) OpenWriteAsync(Uri, String, Object) OpenWriteAsync(Uri, String, Object)

Открывает поток для записи данных в указанный ресурс с помощью указанного метода.Opens a stream for writing data to the specified resource, using the specified method. Этот метод не блокирует вызывающий поток.This method does not block the calling thread.

OpenWriteTaskAsync(String) OpenWriteTaskAsync(String) OpenWriteTaskAsync(String) OpenWriteTaskAsync(String)

Открывает поток для записи данных в указанный ресурс как асинхронная операция с помощью объекта задачи.Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.

OpenWriteTaskAsync(String, String) OpenWriteTaskAsync(String, String) OpenWriteTaskAsync(String, String) OpenWriteTaskAsync(String, String)

Открывает поток для записи данных в указанный ресурс как асинхронная операция с помощью объекта задачи.Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.

OpenWriteTaskAsync(Uri) OpenWriteTaskAsync(Uri) OpenWriteTaskAsync(Uri) OpenWriteTaskAsync(Uri)

Открывает поток для записи данных в указанный ресурс как асинхронная операция с помощью объекта задачи.Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.

OpenWriteTaskAsync(Uri, String) OpenWriteTaskAsync(Uri, String) OpenWriteTaskAsync(Uri, String) OpenWriteTaskAsync(Uri, String)

Открывает поток для записи данных в указанный ресурс как асинхронная операция с помощью объекта задачи.Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.

ToString() ToString() ToString() ToString()

Возвращает объект String, содержащий имя Component, если оно есть.Returns a String containing the name of the Component, if any. Этот метод не следует переопределять.This method should not be overridden.

(Inherited from Component)
UploadData(String, Byte[]) UploadData(String, Byte[]) UploadData(String, Byte[]) UploadData(String, Byte[])

Передает буфер данных ресурсу, заданному с помощью URI.Uploads a data buffer to a resource identified by a URI.

UploadData(String, String, Byte[]) UploadData(String, String, Byte[]) UploadData(String, String, Byte[]) UploadData(String, String, Byte[])

Выгружает буфер данных на указанный ресурс с помощью указанного метода.Uploads a data buffer to the specified resource, using the specified method.

UploadData(Uri, Byte[]) UploadData(Uri, Byte[]) UploadData(Uri, Byte[]) UploadData(Uri, Byte[])

Передает буфер данных ресурсу, заданному с помощью URI.Uploads a data buffer to a resource identified by a URI.

UploadData(Uri, String, Byte[]) UploadData(Uri, String, Byte[]) UploadData(Uri, String, Byte[]) UploadData(Uri, String, Byte[])

Выгружает буфер данных на указанный ресурс с помощью указанного метода.Uploads a data buffer to the specified resource, using the specified method.

UploadDataAsync(Uri, Byte[]) UploadDataAsync(Uri, Byte[]) UploadDataAsync(Uri, Byte[]) UploadDataAsync(Uri, Byte[])

Выгружает буфер данных в ресурс, указанный с помощью URI, используя метод POST.Uploads a data buffer to a resource identified by a URI, using the POST method. Этот метод не блокирует вызывающий поток.This method does not block the calling thread.

UploadDataAsync(Uri, String, Byte[]) UploadDataAsync(Uri, String, Byte[]) UploadDataAsync(Uri, String, Byte[]) UploadDataAsync(Uri, String, Byte[])

Выгружает буфер данных в ресурс, указанный с помощью URI, используя указанный метод.Uploads a data buffer to a resource identified by a URI, using the specified method. Этот метод не блокирует вызывающий поток.This method does not block the calling thread.

UploadDataAsync(Uri, String, Byte[], Object) UploadDataAsync(Uri, String, Byte[], Object) UploadDataAsync(Uri, String, Byte[], Object) UploadDataAsync(Uri, String, Byte[], Object)

Передает буфер данных в ресурс, определенный с помощью URI, используя при этом указанный метод и маркер идентификации.Uploads a data buffer to a resource identified by a URI, using the specified method and identifying token.

UploadDataTaskAsync(String, Byte[]) UploadDataTaskAsync(String, Byte[]) UploadDataTaskAsync(String, Byte[]) UploadDataTaskAsync(String, Byte[])

Отправляет буфер данных, содержащий массив Byte на URI, указанного как асинхронная операция с помощью объекта задачи.Uploads a data buffer that contains a Byte array to the URI specified as an asynchronous operation using a task object.

UploadDataTaskAsync(String, String, Byte[]) UploadDataTaskAsync(String, String, Byte[]) UploadDataTaskAsync(String, String, Byte[]) UploadDataTaskAsync(String, String, Byte[])

Отправляет буфер данных, содержащий массив Byte на URI, указанного как асинхронная операция с помощью объекта задачи.Uploads a data buffer that contains a Byte array to the URI specified as an asynchronous operation using a task object.

UploadDataTaskAsync(Uri, Byte[]) UploadDataTaskAsync(Uri, Byte[]) UploadDataTaskAsync(Uri, Byte[]) UploadDataTaskAsync(Uri, Byte[])

Отправляет буфер данных, содержащий массив Byte на URI, указанного как асинхронная операция с помощью объекта задачи.Uploads a data buffer that contains a Byte array to the URI specified as an asynchronous operation using a task object.

UploadDataTaskAsync(Uri, String, Byte[]) UploadDataTaskAsync(Uri, String, Byte[]) UploadDataTaskAsync(Uri, String, Byte[]) UploadDataTaskAsync(Uri, String, Byte[])

Отправляет буфер данных, содержащий массив Byte на URI, указанного как асинхронная операция с помощью объекта задачи.Uploads a data buffer that contains a Byte array to the URI specified as an asynchronous operation using a task object.

UploadFile(String, String) UploadFile(String, String) UploadFile(String, String) UploadFile(String, String)

Передает заданный локальный файл ресурсу с заданным URI.Uploads the specified local file to a resource with the specified URI.

UploadFile(String, String, String) UploadFile(String, String, String) UploadFile(String, String, String) UploadFile(String, String, String)

Выгружает указанный локальный файл на указанный ресурс с помощью указанного метода.Uploads the specified local file to the specified resource, using the specified method.

UploadFile(Uri, String) UploadFile(Uri, String) UploadFile(Uri, String) UploadFile(Uri, String)

Передает заданный локальный файл ресурсу с заданным URI.Uploads the specified local file to a resource with the specified URI.

UploadFile(Uri, String, String) UploadFile(Uri, String, String) UploadFile(Uri, String, String) UploadFile(Uri, String, String)

Выгружает указанный локальный файл на указанный ресурс с помощью указанного метода.Uploads the specified local file to the specified resource, using the specified method.

UploadFileAsync(Uri, String) UploadFileAsync(Uri, String) UploadFileAsync(Uri, String) UploadFileAsync(Uri, String)

Выгружает указанный локальный файл на указанный ресурс с помощью метода POST.Uploads the specified local file to the specified resource, using the POST method. Этот метод не блокирует вызывающий поток.This method does not block the calling thread.

UploadFileAsync(Uri, String, String) UploadFileAsync(Uri, String, String) UploadFileAsync(Uri, String, String) UploadFileAsync(Uri, String, String)

Выгружает указанный локальный файл на указанный ресурс с помощью метода POST.Uploads the specified local file to the specified resource, using the POST method. Этот метод не блокирует вызывающий поток.This method does not block the calling thread.

UploadFileAsync(Uri, String, String, Object) UploadFileAsync(Uri, String, String, Object) UploadFileAsync(Uri, String, String, Object) UploadFileAsync(Uri, String, String, Object)

Выгружает указанный локальный файл на указанный ресурс с помощью метода POST.Uploads the specified local file to the specified resource, using the POST method. Этот метод не блокирует вызывающий поток.This method does not block the calling thread.

UploadFileTaskAsync(String, String) UploadFileTaskAsync(String, String) UploadFileTaskAsync(String, String) UploadFileTaskAsync(String, String)

Отправляет указанный локальный файл в ресурс как асинхронная операция с помощью объекта задачи.Uploads the specified local file to a resource as an asynchronous operation using a task object.

UploadFileTaskAsync(String, String, String) UploadFileTaskAsync(String, String, String) UploadFileTaskAsync(String, String, String) UploadFileTaskAsync(String, String, String)

Отправляет указанный локальный файл в ресурс как асинхронная операция с помощью объекта задачи.Uploads the specified local file to a resource as an asynchronous operation using a task object.

UploadFileTaskAsync(Uri, String) UploadFileTaskAsync(Uri, String) UploadFileTaskAsync(Uri, String) UploadFileTaskAsync(Uri, String)

Отправляет указанный локальный файл в ресурс как асинхронная операция с помощью объекта задачи.Uploads the specified local file to a resource as an asynchronous operation using a task object.

UploadFileTaskAsync(Uri, String, String) UploadFileTaskAsync(Uri, String, String) UploadFileTaskAsync(Uri, String, String) UploadFileTaskAsync(Uri, String, String)

Отправляет указанный локальный файл в ресурс как асинхронная операция с помощью объекта задачи.Uploads the specified local file to a resource as an asynchronous operation using a task object.

UploadString(String, String) UploadString(String, String) UploadString(String, String) UploadString(String, String)

Выгружает указанную строку на указанный ресурс с помощью метода POST.Uploads the specified string to the specified resource, using the POST method.

UploadString(String, String, String) UploadString(String, String, String) UploadString(String, String, String) UploadString(String, String, String)

Выгружает указанную строку на указанный ресурс с помощью указанного метода.Uploads the specified string to the specified resource, using the specified method.

UploadString(Uri, String) UploadString(Uri, String) UploadString(Uri, String) UploadString(Uri, String)

Выгружает указанную строку на указанный ресурс с помощью метода POST.Uploads the specified string to the specified resource, using the POST method.

UploadString(Uri, String, String) UploadString(Uri, String, String) UploadString(Uri, String, String) UploadString(Uri, String, String)

Выгружает указанную строку на указанный ресурс с помощью указанного метода.Uploads the specified string to the specified resource, using the specified method.

UploadStringAsync(Uri, String) UploadStringAsync(Uri, String) UploadStringAsync(Uri, String) UploadStringAsync(Uri, String)

Выгружает указанную строку в указанный ресурс.Uploads the specified string to the specified resource. Этот метод не блокирует вызывающий поток.This method does not block the calling thread.

UploadStringAsync(Uri, String, String) UploadStringAsync(Uri, String, String) UploadStringAsync(Uri, String, String) UploadStringAsync(Uri, String, String)

Выгружает указанную строку в указанный ресурс.Uploads the specified string to the specified resource. Этот метод не блокирует вызывающий поток.This method does not block the calling thread.

UploadStringAsync(Uri, String, String, Object) UploadStringAsync(Uri, String, String, Object) UploadStringAsync(Uri, String, String, Object) UploadStringAsync(Uri, String, String, Object)

Выгружает указанную строку в указанный ресурс.Uploads the specified string to the specified resource. Этот метод не блокирует вызывающий поток.This method does not block the calling thread.

UploadStringTaskAsync(String, String) UploadStringTaskAsync(String, String) UploadStringTaskAsync(String, String) UploadStringTaskAsync(String, String)

Выгружает указанную строку в заданный ресурс как асинхронная операция с помощью объекта задачи.Uploads the specified string to the specified resource as an asynchronous operation using a task object.

UploadStringTaskAsync(String, String, String) UploadStringTaskAsync(String, String, String) UploadStringTaskAsync(String, String, String) UploadStringTaskAsync(String, String, String)

Выгружает указанную строку в заданный ресурс как асинхронная операция с помощью объекта задачи.Uploads the specified string to the specified resource as an asynchronous operation using a task object.

UploadStringTaskAsync(Uri, String) UploadStringTaskAsync(Uri, String) UploadStringTaskAsync(Uri, String) UploadStringTaskAsync(Uri, String)

Выгружает указанную строку в заданный ресурс как асинхронная операция с помощью объекта задачи.Uploads the specified string to the specified resource as an asynchronous operation using a task object.

UploadStringTaskAsync(Uri, String, String) UploadStringTaskAsync(Uri, String, String) UploadStringTaskAsync(Uri, String, String) UploadStringTaskAsync(Uri, String, String)

Выгружает указанную строку в заданный ресурс как асинхронная операция с помощью объекта задачи.Uploads the specified string to the specified resource as an asynchronous operation using a task object.

UploadValues(String, NameValueCollection) UploadValues(String, NameValueCollection) UploadValues(String, NameValueCollection) UploadValues(String, NameValueCollection)

Передает указанную коллекцию "имя-значение" указанному ресурсу, указанному с помощью URI.Uploads the specified name/value collection to the resource identified by the specified URI.

UploadValues(String, String, NameValueCollection) UploadValues(String, String, NameValueCollection) UploadValues(String, String, NameValueCollection) UploadValues(String, String, NameValueCollection)

Передает указанную коллекцию "имя-значение" указанному ресурсу, указанному с помощью URI, используя указанный метод.Uploads the specified name/value collection to the resource identified by the specified URI, using the specified method.

UploadValues(Uri, NameValueCollection) UploadValues(Uri, NameValueCollection) UploadValues(Uri, NameValueCollection) UploadValues(Uri, NameValueCollection)

Передает указанную коллекцию "имя-значение" указанному ресурсу, указанному с помощью URI.Uploads the specified name/value collection to the resource identified by the specified URI.

UploadValues(Uri, String, NameValueCollection) UploadValues(Uri, String, NameValueCollection) UploadValues(Uri, String, NameValueCollection) UploadValues(Uri, String, NameValueCollection)

Передает указанную коллекцию "имя-значение" указанному ресурсу, указанному с помощью URI, используя указанный метод.Uploads the specified name/value collection to the resource identified by the specified URI, using the specified method.

UploadValuesAsync(Uri, NameValueCollection) UploadValuesAsync(Uri, NameValueCollection) UploadValuesAsync(Uri, NameValueCollection) UploadValuesAsync(Uri, NameValueCollection)

Выгружает дату в указанной коллекции "имя-значение" в указанный ресурс, определенному с помощью URI.Uploads the data in the specified name/value collection to the resource identified by the specified URI. Этот метод не блокирует вызывающий поток.This method does not block the calling thread.

UploadValuesAsync(Uri, String, NameValueCollection) UploadValuesAsync(Uri, String, NameValueCollection) UploadValuesAsync(Uri, String, NameValueCollection) UploadValuesAsync(Uri, String, NameValueCollection)

Выгружает дату в указанной коллекции "имя-значение" в указанный ресурс, определенный с помощью URI, используя указанный метод.Uploads the data in the specified name/value collection to the resource identified by the specified URI, using the specified method. Этот метод не блокирует вызывающий поток.This method does not block the calling thread.

UploadValuesAsync(Uri, String, NameValueCollection, Object) UploadValuesAsync(Uri, String, NameValueCollection, Object) UploadValuesAsync(Uri, String, NameValueCollection, Object) UploadValuesAsync(Uri, String, NameValueCollection, Object)

Выгружает дату в указанной коллекции "имя-значение" в указанный ресурс, определенный с помощью URI, используя указанный метод.Uploads the data in the specified name/value collection to the resource identified by the specified URI, using the specified method. Этот метод не блокирует вызывающий поток и позволяет вызывающей стороне передать объект в метод, вызванный после завершения операции.This method does not block the calling thread, and allows the caller to pass an object to the method that is invoked when the operation completes.

UploadValuesTaskAsync(String, NameValueCollection) UploadValuesTaskAsync(String, NameValueCollection) UploadValuesTaskAsync(String, NameValueCollection) UploadValuesTaskAsync(String, NameValueCollection)

Выгружает указанную коллекцию "имя-значение" в указанный ресурс, определенный с помощью URI, как асинхронная операция с использованием объекта задачи.Uploads the specified name/value collection to the resource identified by the specified URI as an asynchronous operation using a task object.

UploadValuesTaskAsync(String, String, NameValueCollection) UploadValuesTaskAsync(String, String, NameValueCollection) UploadValuesTaskAsync(String, String, NameValueCollection) UploadValuesTaskAsync(String, String, NameValueCollection)

Выгружает указанную коллекцию "имя-значение" в указанный ресурс, определенный с помощью URI, как асинхронная операция с использованием объекта задачи.Uploads the specified name/value collection to the resource identified by the specified URI as an asynchronous operation using a task object.

UploadValuesTaskAsync(Uri, NameValueCollection) UploadValuesTaskAsync(Uri, NameValueCollection) UploadValuesTaskAsync(Uri, NameValueCollection) UploadValuesTaskAsync(Uri, NameValueCollection)

Выгружает указанную коллекцию "имя-значение" в указанный ресурс, определенный с помощью URI, как асинхронная операция с использованием объекта задачи.Uploads the specified name/value collection to the resource identified by the specified URI as an asynchronous operation using a task object.

UploadValuesTaskAsync(Uri, String, NameValueCollection) UploadValuesTaskAsync(Uri, String, NameValueCollection) UploadValuesTaskAsync(Uri, String, NameValueCollection) UploadValuesTaskAsync(Uri, String, NameValueCollection)

Выгружает указанную коллекцию "имя-значение" в указанный ресурс, определенный с помощью URI, как асинхронная операция с использованием объекта задачи.Uploads the specified name/value collection to the resource identified by the specified URI as an asynchronous operation using a task object.

События

Disposed Disposed Disposed Disposed

Происходит при удалении компонента вызовом метода Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)
DownloadDataCompleted DownloadDataCompleted DownloadDataCompleted DownloadDataCompleted

Происходит после завершения асинхронной операции по загрузке данных.Occurs when an asynchronous data download operation completes.

DownloadFileCompleted DownloadFileCompleted DownloadFileCompleted DownloadFileCompleted

Происходит после завершения асинхронной операции по загрузке файла.Occurs when an asynchronous file download operation completes.

DownloadProgressChanged DownloadProgressChanged DownloadProgressChanged DownloadProgressChanged

Происходит при успешной передаче всех данных или их части посредством асинхронной операции загрузки.Occurs when an asynchronous download operation successfully transfers some or all of the data.

DownloadStringCompleted DownloadStringCompleted DownloadStringCompleted DownloadStringCompleted

Происходит после завершения асинхронной операции по загрузке ресурса.Occurs when an asynchronous resource-download operation completes.

OpenReadCompleted OpenReadCompleted OpenReadCompleted OpenReadCompleted

Происходит после завершения асинхронной операции по открытию строки, содержащей ресурс.Occurs when an asynchronous operation to open a stream containing a resource completes.

OpenWriteCompleted OpenWriteCompleted OpenWriteCompleted OpenWriteCompleted

Происходит после завершения асинхронной операции по записи данных в ресурс.Occurs when an asynchronous operation to open a stream to write data to a resource completes.

UploadDataCompleted UploadDataCompleted UploadDataCompleted UploadDataCompleted

Происходит после завершения асинхронной операции по выгрузке данных.Occurs when an asynchronous data-upload operation completes.

UploadFileCompleted UploadFileCompleted UploadFileCompleted UploadFileCompleted

Происходит после завершения асинхронной операции по выгрузке файла.Occurs when an asynchronous file-upload operation completes.

UploadProgressChanged UploadProgressChanged UploadProgressChanged UploadProgressChanged

Происходит при успешной передаче всех данных или их части посредством асинхронной операции выгрузки.Occurs when an asynchronous upload operation successfully transfers some or all of the data.

UploadStringCompleted UploadStringCompleted UploadStringCompleted UploadStringCompleted

Происходит после завершения асинхронной операции по выгрузке строки.Occurs when an asynchronous string-upload operation completes.

UploadValuesCompleted UploadValuesCompleted UploadValuesCompleted UploadValuesCompleted

Происходит после завершения асинхронной операции по выгрузке коллекции "имя-значение".Occurs when an asynchronous upload of a name/value collection completes.

WriteStreamClosed WriteStreamClosed WriteStreamClosed WriteStreamClosed

Происходит после закрытия асинхронной операции по записи данных в ресурс с использованием потока записи.Occurs when an asynchronous operation to write data to a resource using a write stream is closed.

Безопасность

WebPermission
для доступа к запрошенному URI или любому URI, к которому перенаправляется запрос.to access the requested URI or any URI that the request is redirected to. Связанное перечисление: Connect.Associated enumeration: Connect.

Применяется к

Дополнительно