FtpWebRequest.EnableSsl Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u een op of stelt u een Boolean die aangeeft dat een SSL-verbinding moet worden gebruikt.
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 BooleanWaarde van eigenschap
true indien controle en gegevensoverdrachten worden versleuteld; anders, false. De standaardwaarde is false.
Uitzonderingen
De verbinding met de FTP-server is al tot stand gebracht.
Voorbeelden
In het volgende codevoorbeeld wordt een versleutelde verbinding gebruikt om de mapvermelding van een FTP-server te downloaden.
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;
}
Opmerkingen
Caution
Tenzij de EnableSsl eigenschap is true, worden alle gegevens en opdrachten, inclusief uw gebruikersnaam en wachtwoordgegevens, in duidelijke tekst naar de server verzonden. Iedereen die netwerkverkeer bewaakt, kan uw referenties bekijken en gebruiken om verbinding te maken met de server. Als u verbinding maakt met een FTP-server waarvoor referenties zijn vereist en SSL ondersteunt, moet u instellen EnableSsl op true.
De "AUTH TLS" opdracht wordt naar de server verzonden om een versleutelde sessie aan te vragen. Als de server deze opdracht niet herkent, ontvangt u een WebException uitzondering.