FileDialog.CustomPlaces Property

Definition

Gets the custom places collection for this FileDialog instance.

[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.FileDialogCustomPlacesCollection CustomPlaces { get; }

Property Value

The custom places collection for this FileDialog instance.

Attributes

Examples

The following code example demonstrates how to use the CustomPlaces collection. To run this example, paste the following code into a Windows Form and call InitializeDialogAndButton from the form's constructor or Load event-handling method.

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();
}

Remarks

On Windows XP, this property does not have any effect.

Applies to

Product Versions
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9