FileDialogCustomPlacesCollection.Add 方法

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.Primitives.dll

將自訂位置加入至 FileDialogCustomPlacesCollection 集合。

多載

Add(Guid)	將自訂位置加入至 FileDialogCustomPlacesCollection 集合。
Add(String)	將自訂位置加入至 FileDialogCustomPlacesCollection 集合。

Add(Guid)

將自訂位置加入至 FileDialogCustomPlacesCollection 集合。

public:
 void Add(Guid knownFolderGuid);

public void Add (Guid knownFolderGuid);

override this.Add : Guid -> unit

Public Sub Add (knownFolderGuid As Guid)

參數

knownFolderGuid

Guid

， Guid 表示 Windows Vista 已知資料夾。

範例

下列程式碼範例會示範如何使用 Add 方法。 若要執行此範例，請將下列程式碼貼到 Windows Form 中，並從表單的建構函式或 Load 事件處理方法呼叫 InitializeDialogAndButton 。

private OpenFileDialog openFileDialog1;
private Button button1;

private void InitializeDialogAndButton()
{
    this.openFileDialog1 = new System.Windows.Forms.OpenFileDialog();
    this.button1 = new System.Windows.Forms.Button();
    this.button1.Location = new System.Drawing.Point(53, 37);
    this.button1.AutoSize = true;
    this.button1.Text = "Show dialog with custom places.";
    this.button1.UseVisualStyleBackColor = true;
    this.button1.Click += new System.EventHandler(this.button1_Click);
    this.Controls.Add(this.button1);
}

private void button1_Click(object sender, EventArgs e)
{
    // Add Pictures custom place using GUID.
    openFileDialog1.CustomPlaces.Add("33E28130-4E1E-4676-835A-98395C3BC3BB");

    // Add Links custom place using GUID
    openFileDialog1.CustomPlaces.Add(
        new FileDialogCustomPlace(
        new Guid("BFB9D5E0-C6A9-404C-B2B2-AE6DB6AF4968")));

    // Add Windows custom place using file path.
    openFileDialog1.CustomPlaces.Add(@"c:\Windows");

    openFileDialog1.ShowDialog();
}

Private openFileDialog1 As OpenFileDialog
Private WithEvents button1 As Button

Private Sub InitializeDialogAndButton() 
    Me.openFileDialog1 = New System.Windows.Forms.OpenFileDialog()
    Me.button1 = New System.Windows.Forms.Button()
    Me.button1.Location = New System.Drawing.Point(53, 37)
    Me.button1.AutoSize = True
    Me.button1.Text = "Show dialog with custom places."
    Me.button1.UseVisualStyleBackColor = True

    Me.Controls.Add(Me.button1)

End Sub


Private Sub button1_Click(ByVal sender As Object, ByVal e As EventArgs) _
    Handles button1.Click

    ' Add Pictures custom place using GUID.
    openFileDialog1.CustomPlaces.Add("33E28130-4E1E-4676-835A-98395C3BC3BB")

    ' Add Links custom place using GUID
    openFileDialog1.CustomPlaces.Add(New FileDialogCustomPlace _
        (New Guid("BFB9D5E0-C6A9-404C-B2B2-AE6DB6AF4968")))

    ' Add Windows custom place using file path.
    openFileDialog1.CustomPlaces.Add("c:\Windows")

    openFileDialog1.ShowDialog()

End Sub

備註

資料夾只會新增至特定位置 FileDialog ，而不是系統或應用程式範圍的變更。

資料夾會依新增至 FileDialog 的順序，放置在自訂位置中。 最後一個新增的會位於頂端。 如果您將自訂位置新增至不存在於執行應用程式之電腦上的集合中，將不會顯示自訂位置。 GUID 不區分大小寫。 如需可用 Windows Vista 已知資料夾的清單，請參閱 Windows SDK 中 檔案對話方塊自訂位置的已知資料夾 GUID 或 KnownFolders.h 檔案。

另請參閱

• FileDialogCustomPlace
• 檔案對話方塊自訂位置的已知資料夾 GUID

Add(String)

將自訂位置加入至 FileDialogCustomPlacesCollection 集合。

public:
 void Add(System::String ^ path);

public void Add (string? path);

override this.Add : string -> unit

Public Sub Add (path As String)

參數

path

String

自訂位置的資料夾路徑。

範例

下列程式碼範例會示範如何使用 Add 方法。 若要執行此範例，請將下列程式碼貼到 Windows Form 中，並從表單的建構函式或 Load 事件處理方法呼叫 InitializeDialogAndButton 。

private OpenFileDialog openFileDialog1;
private Button button1;

private void InitializeDialogAndButton()
{
    this.openFileDialog1 = new System.Windows.Forms.OpenFileDialog();
    this.button1 = new System.Windows.Forms.Button();
    this.button1.Location = new System.Drawing.Point(53, 37);
    this.button1.AutoSize = true;
    this.button1.Text = "Show dialog with custom places.";
    this.button1.UseVisualStyleBackColor = true;
    this.button1.Click += new System.EventHandler(this.button1_Click);
    this.Controls.Add(this.button1);
}

private void button1_Click(object sender, EventArgs e)
{
    // Add Pictures custom place using GUID.
    openFileDialog1.CustomPlaces.Add("33E28130-4E1E-4676-835A-98395C3BC3BB");

    // Add Links custom place using GUID
    openFileDialog1.CustomPlaces.Add(
        new FileDialogCustomPlace(
        new Guid("BFB9D5E0-C6A9-404C-B2B2-AE6DB6AF4968")));

    // Add Windows custom place using file path.
    openFileDialog1.CustomPlaces.Add(@"c:\Windows");

    openFileDialog1.ShowDialog();
}

Private openFileDialog1 As OpenFileDialog
Private WithEvents button1 As Button

Private Sub InitializeDialogAndButton() 
    Me.openFileDialog1 = New System.Windows.Forms.OpenFileDialog()
    Me.button1 = New System.Windows.Forms.Button()
    Me.button1.Location = New System.Drawing.Point(53, 37)
    Me.button1.AutoSize = True
    Me.button1.Text = "Show dialog with custom places."
    Me.button1.UseVisualStyleBackColor = True

    Me.Controls.Add(Me.button1)

End Sub


Private Sub button1_Click(ByVal sender As Object, ByVal e As EventArgs) _
    Handles button1.Click

    ' Add Pictures custom place using GUID.
    openFileDialog1.CustomPlaces.Add("33E28130-4E1E-4676-835A-98395C3BC3BB")

    ' Add Links custom place using GUID
    openFileDialog1.CustomPlaces.Add(New FileDialogCustomPlace _
        (New Guid("BFB9D5E0-C6A9-404C-B2B2-AE6DB6AF4968")))

    ' Add Windows custom place using file path.
    openFileDialog1.CustomPlaces.Add("c:\Windows")

    openFileDialog1.ShowDialog()

End Sub

備註

資料夾只會新增至特定位置 FileDialog ，而不是系統或應用程式範圍的變更。

資料夾會依新增至 FileDialog 的順序，放置在自訂位置中。 最後一個新增的會位於頂端。

另請參閱

• FileDialogCustomPlace