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 窗体中，并从窗体的构造函数或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 窗体中，并从窗体的构造函数或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