FileDialog.InitialDirectory プロパティ

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

FileDialog.InitialDirectory プロパティ

ファイル ダイアログ ボックスに表示される起動ディレクトリを取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Property InitialDirectory As
 String

Visual Basic (使用法)

Dim instance As FileDialog
Dim value As String

value = instance.InitialDirectory

instance.InitialDirectory = value

C#

public string InitialDirectory { get;
 set; }

C++

public:
property String^ InitialDirectory {
    String^ get ();
    void set (String^ value);
}

J#

/** @property */
public String get_InitialDirectory ()

/** @property */
public void set_InitialDirectory (String value)

JScript

public function get InitialDirectory
 () : String

public function set InitialDirectory
 (value : String)

プロパティ値
ファイル ダイアログ ボックスに表示される起動ディレクトリ。既定値は空の文字列 ("") です。

解説

InitialDirectory プロパティは、通常、次の情報のうちいずれかを使用して設定されます。

• プログラムで前に使用されていたパス。多くの場合、前回アクセスしたディレクトリまたは前回のファイル操作から取得されます。

• アプリケーション設定、Registry、またはアプリケーション内の文字列リソースなど、永続的情報源から読み込まれたパス。

• Program Files、My Documents、マイ ミュージックなど、標準的な Windows のシステム パスまたはユーザー パス。

• 起動ディレクトリなど、現在のアプリケーションに関連するパス。

動的パスの作成方法の詳細については、FileDialog クラスのトピックの概要を参照してください。

使用例

FileDialog の OpenFileDialog 実装を使用し、ダイアログ ボックスの作成、そのプロパティの設定、およびダイアログ ボックスの表示を実行するコード例を次に示します。この例では、InitialDirectory プロパティを使用して、ダイアログ ボックスで最初に表示するディレクトリを設定しています。この例では、フォームに Button が配置されており、System.IO 名前空間が追加されている必要があります。

Visual Basic

Private Sub button1_Click(sender As
 Object, e As System.EventArgs)
    Dim myStream As Stream
    Dim openFileDialog1 As New
 OpenFileDialog()
       
    openFileDialog1.InitialDirectory = "c:\"
    openFileDialog1.Filter = "txt files (*.txt)|*.txt|All files
 (*.*)|*.*"
    openFileDialog1.FilterIndex = 2
    openFileDialog1.RestoreDirectory = True
       
    If openFileDialog1.ShowDialog() = DialogResult.OK Then
        myStream = openFileDialog1.OpenFile()
        If Not (myStream Is
 Nothing) Then
            ' Insert code to read the stream here.
            myStream.Close()
        End If
    End If
End Sub

C#

private void button1_Click(object sender, System.EventArgs
 e)
{
    Stream myStream;
    OpenFileDialog openFileDialog1 = new OpenFileDialog();

    openFileDialog1.InitialDirectory = "c:\\" ;
    openFileDialog1.Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*"
 ;
    openFileDialog1.FilterIndex = 2 ;
    openFileDialog1.RestoreDirectory = true ;

    if(openFileDialog1.ShowDialog() == DialogResult.OK)
    {
        if((myStream = openFileDialog1.OpenFile())!= null)
        {
            // Insert code to read the stream here.
            myStream.Close();
        }
    }
}

C++

private:
   void button1_Click( Object^ /*sender*/, System::EventArgs^
 /*e*/ )
   {
      Stream^ myStream;
      OpenFileDialog^ openFileDialog1 = gcnew OpenFileDialog;

      openFileDialog1->InitialDirectory = "c:\\";
      openFileDialog1->Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*";
      openFileDialog1->FilterIndex = 2;
      openFileDialog1->RestoreDirectory = true;

      if ( openFileDialog1->ShowDialog() == ::DialogResult::OK
 )
      {
         if ( (myStream = openFileDialog1->OpenFile()) != nullptr
 )
         {
            // Insert code to read the stream here.
            myStream->Close();
         }
      }
   }

J#

protected void button1_Click(Object sender,
 System.EventArgs e)
{
    Stream myStream;
    OpenFileDialog openFileDialog1 = new OpenFileDialog();
    openFileDialog1.set_InitialDirectory("c:\\");
    openFileDialog1.set_Filter(
        "txt files (*.txt)|*.txt|All files (*.*)|*.*");
    openFileDialog1.set_FilterIndex(2);
    openFileDialog1.set_RestoreDirectory(true);
    if (openFileDialog1.ShowDialog().Equals(get_DialogResult().OK))
 {
        if ((myStream = openFileDialog1.OpenFile()) != null)
 {
            // Insert code to read the stream here.
            myStream.Close();
        }
    }
} //button1_Click

.NET Framework のセキュリティ

• FileIOPermission  (初期ディレクトリを設定するために必要なアクセス許可)PermissionState.Unrestricted (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, 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、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
FileDialog クラス
FileDialog メンバ
System.Windows.Forms 名前空間
RestoreDirectory
Registry
Application クラス
System.Environment
System.IO.Path