FtpWebRequest.EnableSsl プロパティ

.NET Framework クラス ライブラリ リファレンス

FtpWebRequest.EnableSsl プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

SSL 接続を使用する必要があるかどうかを指定する Boolean を取得または設定します。

名前空間: System.Net
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Property EnableSsl As
 Boolean

Visual Basic (使用法)

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)

プロパティ値
制御およびデータの伝送が暗号化されている場合は true。それ以外の場合は false。既定値は false です。

例外

例外の種類	条件
InvalidOperationException	FTP サーバーへの接続が既に確立されています。

解説

注意
EnableSsl プロパティが true でない限り、ユーザー名とパスワードの情報を含め、すべてのデータとコマンドはクリア テキストでサーバーに送信されます。ネットワーク トラフィックを監視すると、だれでも資格情報を表示したり、それらを使用してサーバーに接続したりできます。SSL (Secure Sockets Layer) をサポートしている、資格情報が必要な FTP サーバーに接続する場合は、EnableSsl を true に設定する必要があります。

"AUTH TLS" コマンドがサーバーに送信され、暗号化セッションを要求します。サーバーがこのコマンドを認識しない場合は、WebException 例外が発生します。

使用例

暗号化接続を使用して 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;
}
 

プラットフォーム

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

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
FtpWebRequest クラス
FtpWebRequest メンバ
System.Net 名前空間
FtpWebResponse
FtpStatusCode 列挙体
WebRequestMethods.Ftp
WebRequest
WebResponse
WebClient