FtpWebRequest.EnableSsl Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recebe ou define uma Boolean que especifica que deve ser usada uma ligação SSL.
public:
property bool EnableSsl { bool get(); void set(bool value); };public bool EnableSsl { get; set; }member this.EnableSsl : bool with get, setPublic Property EnableSsl As BooleanValor de Propriedade
true se as transmissões de controlo e dados estiverem encriptadas; caso contrário, false. O valor predefinido é false.
Exceções
A ligação ao servidor FTP já foi estabelecida.
Exemplos
O exemplo de código seguinte utiliza uma ligação encriptada para descarregar a listagem de diretórios a partir 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;
}
Observações
Atenção
A menos que a EnableSsl propriedade seja true, todos os dados e comandos, incluindo o seu nome de utilizador e palavra-passe, são enviados ao servidor em texto claro. Qualquer pessoa que monitorize o tráfego da rede pode ver as suas credenciais e usá-las para se ligar ao servidor. Se estiver a ligar-se a um servidor FTP que requer credenciais e suporta SSL, deve definir EnableSsl para true.
O "AUTH TLS" comando é enviado ao servidor para solicitar uma sessão encriptada. Se o servidor não reconhecer este comando, recebe uma WebException exceção.
