FtpWebRequest.Proxy Свойство

Определение

Возвращает или задает прокси-сервер, используемый для связи с FTP-сервером.Gets or sets the proxy used to communicate with the FTP server.

public:
 virtual property System::Net::IWebProxy ^ Proxy { System::Net::IWebProxy ^ get(); void set(System::Net::IWebProxy ^ value); };
public override System.Net.IWebProxy Proxy { get; set; }
member this.Proxy : System.Net.IWebProxy with get, set
Public Overrides Property Proxy As IWebProxy

Значение свойства

Экземпляр IWebProxy, ответственный за связь с FTP-сервером.An IWebProxy instance responsible for communicating with the FTP server. В .NET Core его значение — null.On .NET Core, its value is null.

Исключения

Значением этого свойства не может быть null.This property cannot be set to null.

Для этого свойства задано новое значение для уже выполняющегося запроса.A new value was specified for this property for a request that is already in progress.

Примеры

В следующем примере кода показано это значение свойства.The following code example displays this property value.

IWebProxy^ proxy = request->Proxy;
if ( proxy )
{
   Console::WriteLine( "Proxy: {0}", proxy->GetProxy( request->RequestUri ) );
}
else
{
   Console::WriteLine( "Proxy: (none)" );
}

Console::WriteLine( "ConnectionGroup: {0}", request->ConnectionGroupName == nullptr ? "none" : request->ConnectionGroupName );
IWebProxy proxy = request.Proxy;
if (proxy != null)
{
    Console.WriteLine("Proxy: {0}", proxy.GetProxy(request.RequestUri));
} 
else
{
    Console.WriteLine("Proxy: (none)");
}

Console.WriteLine("ConnectionGroup: {0}",
    request.ConnectionGroupName == null ? "none" : request.ConnectionGroupName
);

Комментарии

На .NET FrameworkOn .NET Framework

Свойство Proxy определяет экземпляр IWebProxy, который взаимодействует с FTP-сервером.The Proxy property identifies the IWebProxy instance that communicates with the FTP server. Прокси-сервер задается системой с помощью файлов конфигурации и параметров локальной сети Internet Explorer.The proxy is set by the system by using configuration files and the Internet Explorer Local Area Network settings. Чтобы указать, что прокси-сервер использовать не нужно, присвойте Proxy экземпляру прокси-сервера, возвращаемому методом GlobalProxySelection.GetEmptyWebProxy.To specify that no proxy should be used, set Proxy to the proxy instance returned by the GlobalProxySelection.GetEmptyWebProxy method. Дополнительные сведения об автоматическом обнаружении прокси-сервера см. в разделе Автоматическое обнаружение прокси-сервера.For more information about automatic proxy detection, see Automatic Proxy Detection.

Необходимо задать Proxy перед записью данных в поток запроса или получения ответа.You must set Proxy before writing data to the request's stream or getting the response. Изменение Proxy после вызова метода GetRequestStream, BeginGetRequestStream, GetResponseили BeginGetResponse вызывает исключение InvalidOperationException.Changing Proxy after calling the GetRequestStream, BeginGetRequestStream, GetResponse, or BeginGetResponse method causes an InvalidOperationException exception.

Класс FtpWebRequest поддерживает прокси-серверы клиента брандмауэра HTTP и ISA.The FtpWebRequest class supports HTTP and ISA Firewall Client proxies.

Если указанный прокси-сервер является прокси-сервером HTTP, поддерживаются только команды DownloadFile, ListDirectoryи ListDirectoryDetails.If the specified proxy is an HTTP proxy, only the DownloadFile, ListDirectory, and ListDirectoryDetails commands are supported.

В .NET CoreOn .NET Core

Свойство FtpWebRequest.Proxy не поддерживается.The FtpWebRequest.Proxy property is not supported. Установка свойства не оказывает никакого влияния.Setting the property has no effect. Получение значения свойства возвращает null.Getting the property value returns null.

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

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