Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

FtpWebRequest.EnableSsl Property

Gets or sets a Boolean that specifies that an SSL connection should be used.

Namespace:  System.Net
Assembly:  System (in System.dll)
public function get EnableSsl () : boolean 
public function set EnableSsl (value : boolean)

Property Value

Type: System.Boolean
true if control and data transmissions are encrypted; otherwise, false. The default value is false.
ExceptionCondition
InvalidOperationException

The connection to the FTP server has already been established.

Caution noteCaution:

Unless the EnableSsl property is true, all data and commands, including your user name and password information, are sent to the server in clear text. Anyone monitoring network traffic can view your credentials and use them to connect to the server. If you are connecting to an FTP server that requires credentials and supports SSL, you should set EnableSsl to true.

The "AUTH TLS" command is sent to the server to request an encrypted session. If the server does not recognize this command, you receive a WebException exception.

The following code example uses an encrypted connection to download the directory listing from an FTP server.

No code example is currently available or this language may not be supported.
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 = dynamic_cast<FtpWebRequest*>(WebRequest::Create(serverUri));
        request->Method = FtpMethods::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(S"ServicePoint connections = {0}.", __box(sp->ConnectionLimit));
        sp->ConnectionLimit = 1;

  	     FtpWebResponse* response = dynamic_cast<FtpWebResponse*> (request->GetResponse());
        Console::WriteLine(S"The content length is {0}", __box(response->ContentLength));
        // The following streams are used to read the data returned from the server.
        Stream* responseStream = 0;
        StreamReader* readStream = 0;
        responseStream = response->GetResponseStream(); 
        readStream = new StreamReader(responseStream, System::Text::Encoding::UTF8);
       // Display the data received from the server.
        Console::WriteLine(readStream->ReadToEnd());
        Console::WriteLine(S"List status: {0}",response->StatusDescription);            
        readStream->Close();
        response->Close();
        Console::WriteLine(S"Banner message: {0}", 
            response->BannerMessage);

        Console::WriteLine(S"Welcome message: {0}", 
            response->WelcomeMessage);

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

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

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.