Biblioteca de clases de .NET Framework
FtpWebRequest.EnableSsl (Propiedad)

Nota: esta propiedad es nueva en la versión 2.0 de .NET Framework.

Obtiene o establece un valor Boolean que especifica que se debe utilizar una conexión SSL.

Espacio de nombres: System.Net
Ensamblado: System (en system.dll)

Sintaxis

Visual Basic (Declaración)
Public Property EnableSsl As Boolean
Visual Basic (Uso)
Dim instance As FtpWebRequest
Dim value As Boolean

value = instance.EnableSsl

instance.EnableSsl = value
C#
public bool EnableSsl { get; set; }
C++
public:
property bool EnableSsl {
    bool get ();
    void set (bool value);
}
J#
/** @property */
public boolean get_EnableSsl ()

/** @property */
public void set_EnableSsl (boolean value)
JScript
public function get EnableSsl () : boolean

public function set EnableSsl (value : boolean)

Valor de propiedad

Es true si las transmisiones de datos y de control están cifradas; de lo contrario, es false. El valor predeterminado es false.
Excepciones

Tipo de excepciónCondición

InvalidOperationException

La conexión al servidor FTP ya ha sido establecida.

Comentarios

Nota de precauciónPrecaución

A menos que la propiedad EnableSsl sea true, todos los datos y comandos, incluidos su nombre de usuario y contraseña, se envían al servidor como texto no cifrado. Cualquier usuario que supervise el tráfico de red podrá ver sus credenciales y utilizarlas para conectarse al servidor. Si se está conectando a un servidor FTP que requiere credenciales y admite SSL, establezca EnableSsl en true.

El comando "AUTH TLS" se envía al servidor para solicitar una sesión cifrada. Si el servidor no reconoce este comando, se obtiene una excepción WebException.

Ejemplo

En el ejemplo de código siguiente se utiliza una conexión cifrada para descargar la lista de directorios de un servidor FTP.

C#
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;
}
 
Plataformas

Windows 98, Windows 2000 SP4, Windows Millennium, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition

.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.

Información de versión

.NET Framework

Compatible con: 2.0
Vea también

Etiquetas :


Page view tracker