FtpWebRequest.EnableSsl Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta una struttura Boolean che specifica che deve essere usata una connessione SSL.
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
Valore della proprietà
true
se le trasmissioni di controllo e dati sono crittografate; in caso contrario false
. Il valore predefinito è false
.
Eccezioni
La connessione al server FTP è gia stata stabilita.
Esempio
Nell'esempio di codice seguente viene usata una connessione crittografata per scaricare l'elenco di directory da un server FTP.
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 = 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 = dynamic_cast<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 = nullptr;
StreamReader^ readStream = nullptr;
responseStream = response->GetResponseStream();
readStream = gcnew StreamReader( responseStream,System::Text::Encoding::UTF8 );
// Display the data received from the server.
Console::WriteLine( readStream->ReadToEnd() );
Console::WriteLine( "List status: {0}", response->StatusDescription );
readStream->Close();
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;
}
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;
}
Commenti
Attenzione
A meno che la EnableSsl proprietà non sia true
, tutti i dati e i comandi, inclusi il nome utente e le informazioni sulla password, vengono inviati al server in testo chiaro. Chiunque monitora il traffico di rete può visualizzare le credenziali e usarle per connettersi al server. Se ci si connette a un server FTP che richiede credenziali e supporta SSL, è necessario impostare EnableSsl su true
.
Il "AUTH TLS"
comando viene inviato al server per richiedere una sessione crittografata. Se il server non riconosce questo comando, viene visualizzata un'eccezione WebException .