Partilhar via

FtpWebRequest.EnableSsl Propriedade

Definição

Namespace:
System.Net
Assemblies:
netstandard.dll, System.Net.Requests.dll
Assembly:
System.Net.Requests.dll
Assembly:
System.dll
Assembly:
netstandard.dll
Origem:
FtpWebRequest.cs
Origem:
FtpWebRequest.cs
Origem:
FtpWebRequest.cs
Origem:
FtpWebRequest.cs

Obtém ou define um Boolean que especifica se uma conexão SSL deve ser usada.

public:
 property bool EnableSsl { bool get(); void set(bool value); };
public bool EnableSsl { get; set; }
member this.EnableSsl : bool with get, set
Public Property EnableSsl As Boolean

Valor da propriedade

Boolean

true se as transmissões de controle e de dados forem criptografadas; caso contrário, false. O valor padrão é false.

Exceções

InvalidOperationException

A conexão com o servidor FTP já foi estabelecida.

Exemplos

O exemplo de código a seguir usa uma conexão criptografada para baixar a listagem de diretórios de um servidor FTP.

public static bool ListFilesOnServerSsl(Uri serverUri)
{
    // The serverUri should start with the ftp:// scheme.
    if (serverUri.Scheme != Uri.UriSchemeFtp)
    {
        return false;
    }
    // Get the object used to communicate with the server.
    FtpWebRequest request = (FtpWebRequest)WebRequest.Create(serverUri);
    request.Method = WebRequestMethods.Ftp.ListDirectory;
    request.EnableSsl = true;

    // Get the ServicePoint object used for this request, and limit it to one connection.
    // In a real-world application you might use the default number of connections (2),
    // or select a value that works best for your application.

    ServicePoint sp = request.ServicePoint;
    Console.WriteLine("ServicePoint connections = {0}.", sp.ConnectionLimit);
    sp.ConnectionLimit = 1;

    FtpWebResponse response = (FtpWebResponse) request.GetResponse();
     Console.WriteLine("The content length is {0}", response.ContentLength);
    // The following streams are used to read the data returned from the server.
    Stream responseStream = null;
    StreamReader readStream = null;
    try
    {
        responseStream = response.GetResponseStream();
        readStream = new StreamReader(responseStream, System.Text.Encoding.UTF8);

        if (readStream != null)
        {
            // Display the data received from the server.
            Console.WriteLine(readStream.ReadToEnd());
        }
        Console.WriteLine("List status: {0}",response.StatusDescription);
    }
    finally
    {
        if (readStream != null)
        {
            readStream.Close();
        }
        if (response != null)
        {
            response.Close();
        }
    }

    Console.WriteLine("Banner message: {0}",
        response.BannerMessage);

    Console.WriteLine("Welcome message: {0}",
        response.WelcomeMessage);

    Console.WriteLine("Exit message: {0}",
        response.ExitMessage);
    return true;
}

Comentários

Cuidado

A menos que a EnableSsl propriedade seja true, todos os dados e comandos, incluindo suas informações de nome de usuário e senha, são enviados ao servidor em texto não criptografado. Qualquer pessoa que monitore o tráfego de rede pode exibir suas credenciais e usá-las para se conectar ao servidor. Se você estiver se conectando a um servidor FTP que requer credenciais e dá suporte a SSL, defina EnableSsl como true.

O "AUTH TLS" comando é enviado ao servidor para solicitar uma sessão criptografada. Se o servidor não reconhecer esse comando, você receberá uma WebException exceção.

Aplica-se a

Confira também