FileDialogCustomPlacesCollection.Add Método

  • Referencia

Definición

Espacio de nombres:
System.Windows.Forms
Ensamblado:
System.Windows.Forms.dll
Ensamblado:
System.Windows.Forms.Primitives.dll

Agrega una ubicación personalizada a la colección FileDialogCustomPlacesCollection.

Sobrecargas

Add(Guid)

Agrega una ubicación personalizada a la colección FileDialogCustomPlacesCollection.
Add(String)

Agrega una ubicación personalizada a la colección FileDialogCustomPlacesCollection.

Add(Guid)

Agrega una ubicación personalizada a la colección FileDialogCustomPlacesCollection.

public:
 void Add(Guid knownFolderGuid);
public void Add (Guid knownFolderGuid);
override this.Add : Guid -> unit
Public Sub Add (knownFolderGuid As Guid)

Parámetros

knownFolderGuid
Guid

que Guid representa una carpeta conocida de Windows Vista.

Ejemplos

En el ejemplo de código siguiente se muestra cómo utilizar el método Add. Para ejecutar este ejemplo, pegue el código siguiente en un formulario Windows Forms y llame InitializeDialogAndButton desde el constructor o Load el método de control de eventos del formulario.

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

Comentarios

La carpeta se agrega a lugares personalizados solo para un determinado FileDialog y no es un cambio en todo el sistema o aplicación.

Las carpetas se colocan en los lugares personalizados en el orden en que se agregan a .FileDialog El último agregado estará en la parte superior. Si agrega un lugar personalizado a la colección que no existe en el equipo que ejecuta la aplicación, no se mostrará el lugar personalizado. Los GUID no distinguen mayúsculas de minúsculas. Para obtener una lista de las carpetas conocidas de Windows Vista disponibles, vea GUID de carpetas conocidas para lugares personalizados de cuadro de diálogo de archivos o el archivo KnownFolders.h en Windows SDK.

Consulte también

Se aplica a

Add(String)

Agrega una ubicación personalizada a la colección FileDialogCustomPlacesCollection.

public:
 void Add(System::String ^ path);
public void Add (string path);
public void Add (string? path);
override this.Add : string -> unit
Public Sub Add (path As String)

Parámetros

path
String

Ruta de acceso de una carpeta a la ubicación personalizada.

Ejemplos

En el ejemplo de código siguiente se muestra cómo utilizar el método Add. Para ejecutar este ejemplo, pegue el código siguiente en un formulario Windows Forms y llame InitializeDialogAndButton desde el constructor o Load el método de control de eventos del formulario.

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

Comentarios

La carpeta se agrega a lugares personalizados solo para un determinado FileDialog y no es un cambio en todo el sistema o aplicación.

Las carpetas se colocan en los lugares personalizados en el orden en que se agregan a .FileDialog El último agregado estará en la parte superior.

Consulte también

Se aplica a