参照設定に追加して使用する

本製品は、コンポーネントをフォームに貼り付けて使用する方法のほかに、プロジェクトの参照設定に本製品のアセンブリを追加する方法でも使用できます。後者は、以下のような形式のプロジェクトで本製品を使用する場合の方法です。

WPFアプリケーション
ASP.NET Webサイト
コンソールアプリケーション
WCFサービスアプリケーション

参照設定に追加して使用する場合、licenses.licxファイルの作成は自動的に行われませんので、開発者が手動で行う必要があります。作成の手順については「licenses.licxファイルを手動で作成する」をご覧ください。

参照設定にアセンブリを追加する方法で、Windowsフォームアプリケーションを作成する手順は以下のとおりです。Windowsフォームアプリケーションの場合、コンポーネントをフォームに貼り付けて使用する方法の方が簡単に作成できますが、比較のため同じアプリケーションを作成します。

Visual Studioを起動します。
［ファイル］メニューから［新しいプロジェクト］を選択します。
［新しいプロジェクト］ダイアログ上で、任意の言語（［Visual Basic］または［Visual C#］）を選択し、次に「Windows フォームアプリケーション」を選択します｡プロジェクト名を指定し、［OK］ボタンをクリックします。

［プロジェクト］メニューから［参照の追加］を選択します。
［参照の追加］ダイアログの［.NET］タブ上で、以下のコンポーネントを選択し、[OK] ボタンをクリックします。

コンポーネント名	バージョン	ランタイム	パス
PowerTCP FTP	4.x.x.x	v4.0.30319	＜本製品のインストールフォルダ＞\Bin\v4.x.x.x\Dart.FTP.dll

「4.x.x.x」の数字はアセンブリのバージョン番号です。製品のリリース時期によって変化します。
「パス」の内容は本製品をインストールしたフォルダによって変化します。
デフォルトの＜本製品のインストールフォルダ＞は、「Secure FTP for .NET 4.0J」の場合は「C:\Program Files (x86)\SecureFtp4」、「Secure iNetSuite for .NET 4.0J」の場合は「C:\Program Files (x86)\iNetSuite4」になります。

「licenses.licxファイルを手動で作成する」の手順で、プロジェクトにlicenses.licxファイルを追加します。
Form1クラスのコードを表示し、Ftpコンポーネントのインスタンスを生成するコード（後述）を記述します。

ツールボックスからフォーム上に、標準のButtonコントロールをドラッグ＆ドロップします。

フォーム上のButtonコントロールをダブルクリックすると、Clickイベントのイベントハンドラが追加されるので、その中にFTPサーバーとの通信を行うコードを記述します。

Form1クラスのコードは、最終的に以下のようになります。

Visual Basic	コードのコピー
Public Class Form1 ' Ftpコンポーネントのインスタンスを生成します。 Dim Ftp1 As New Dart.Ftp.Ftp() Private Sub Button1_Click(sender As System.Object, e As System.EventArgs) Handles Button1.Click ' 接続するFTPサーバー名、ユーザー名、パスワードを設定します。 Ftp1.Session.RemoteEndPoint.HostNameOrAddress = "MyFtpServer" Ftp1.Session.Username = "myUsername" Ftp1.Session.Password = "myPassword" Dim dir As String Try ' FTPサーバーに接続し、ログインします。 Ftp1.Connect() Ftp1.Authenticate() ' カレントディレクトリを返すGetDirectoryメソッドを実行します。 dir = Ftp1.GetDirectory() Catch MessageBox.Show("Error") Exit Sub End Try ' メッセージボックスにカレントディレクトリを表示します。 MessageBox.Show(dir) ' FTPサーバーとの接続を閉じます。 Ftp1.Close() End Sub End Class

Visual Basic

コードのコピー

Public Class Form1
     ' Ftpコンポーネントのインスタンスを生成します。
     Dim Ftp1 As New Dart.Ftp.Ftp()

     Private Sub Button1_Click(sender As System.Object, e As System.EventArgs) Handles Button1.Click
         ' 接続するFTPサーバー名、ユーザー名、パスワードを設定します。
         Ftp1.Session.RemoteEndPoint.HostNameOrAddress = "MyFtpServer"
         Ftp1.Session.Username = "myUsername"
         Ftp1.Session.Password = "myPassword"

         Dim dir As String
         Try
             ' FTPサーバーに接続し、ログインします。
             Ftp1.Connect()
             Ftp1.Authenticate()
        
             ' カレントディレクトリを返すGetDirectoryメソッドを実行します。
             dir = Ftp1.GetDirectory()
         Catch
             MessageBox.Show("Error")
             Exit Sub
         End Try

         ' メッセージボックスにカレントディレクトリを表示します。
         MessageBox.Show(dir)
         ' FTPサーバーとの接続を閉じます。
         Ftp1.Close()
     End Sub
End Class

C#	コードのコピー
public partial class Form1 : Form { // Ftpコンポーネントのインスタンスを生成します。 Dart.Ftp.Ftp ftp1 = new Dart.Ftp.Ftp(); public Form1() { InitializeComponent(); } private void button1_Click(object sender, EventArgs e) { // 接続するFTPサーバー名、ユーザー名、パスワードを設定します。 ftp1.Session.RemoteEndPoint.HostNameOrAddress = "myFtpServer"; ftp1.Session.Username = "myUsername"; ftp1.Session.Password = "myPassword"; string dir; try { // FTPサーバーに接続し、ログインします。 ftp1.Connect(); ftp1.Authenticate(); // カレントディレクトリを返すGetDirectoryメソッドを実行します。 dir = ftp1.GetDirectory(); } catch { MessageBox.Show("Error"); return; } // メッセージボックスにカレントディレクトリを表示します。 MessageBox.Show(dir); // FTPサーバーとの接続を閉じます。 ftp1.Close(); } }

コードのコピー

public partial class Form1 : Form
{
     // Ftpコンポーネントのインスタンスを生成します。
     Dart.Ftp.Ftp ftp1 = new Dart.Ftp.Ftp();

     public Form1()
     {
         InitializeComponent();
     }

     private void button1_Click(object sender, EventArgs e)
     {
         // 接続するFTPサーバー名、ユーザー名、パスワードを設定します。
         ftp1.Session.RemoteEndPoint.HostNameOrAddress = "myFtpServer";
         ftp1.Session.Username = "myUsername";
         ftp1.Session.Password = "myPassword";

         string dir;
         try
         {
             // FTPサーバーに接続し、ログインします。
             ftp1.Connect();
             ftp1.Authenticate();

             // カレントディレクトリを返すGetDirectoryメソッドを実行します。
             dir = ftp1.GetDirectory();
         }
         catch
         {
             MessageBox.Show("Error");
             return;
         }

         // メッセージボックスにカレントディレクトリを表示します。
         MessageBox.Show(dir);
        // FTPサーバーとの接続を閉じます。
         ftp1.Close();
     }
}

［デバッグ］メニューの［デバッグ開始］を選択すると、アプリケーションがビルドされ、実行されます。
フォーム上のボタンをクリックすると、FTPサーバーのカレントディレクトリがメッセージボックスに表示されます。