FileDialogCustomPlacesCollection.Add Método

Definição

Adiciona um local personalizado à FileDialogCustomPlacesCollection coleção.

Sobrecargas

Name Description
Add(Guid)

Adiciona um local personalizado à FileDialogCustomPlacesCollection coleção.

Add(String)

Adiciona um local personalizado à FileDialogCustomPlacesCollection coleção.

Add(Guid)

Origem:
FileDialogCustomPlacesCollection.cs
Origem:
FileDialogCustomPlacesCollection.cs
Origem:
FileDialogCustomPlacesCollection.cs
Origem:
FileDialogCustomPlacesCollection.cs
Origem:
FileDialogCustomPlacesCollection.cs

Adiciona um local personalizado à FileDialogCustomPlacesCollection coleção.

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

Um Guid que representa uma Windows Vista Pasta Conhecida.

Exemplos

O exemplo de código seguinte demonstra como usar o Add método. Para executar este exemplo, cole o seguinte código num formulário Windows e chame InitializeDialogAndButton do construtor do formulário ou do método de gestão de eventos Load.

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

Observações

A pasta é adicionada a locais personalizados apenas para um determinado FileDialog caso e não é uma alteração a nível de sistema ou aplicação.

As pastas estão posicionadas nos locais personalizados pela ordem em que são adicionadas ao FileDialogarquivo . A última adicionada ficará no topo. Se adicionar um local personalizado à coleção que não existe no computador que executa a aplicação, o local personalizado não será mostrado. Os GUIDs são indiferentes a maiúsculas minúsculas. Para uma lista das pastas Windows Vista conhecidas disponíveis, veja Known Folder GUIDs para File Dialog Custom Places ou o ficheiro KnownFolders.h no SDK Windows.

Ver também

Aplica-se a

Add(String)

Origem:
FileDialogCustomPlacesCollection.cs
Origem:
FileDialogCustomPlacesCollection.cs
Origem:
FileDialogCustomPlacesCollection.cs
Origem:
FileDialogCustomPlacesCollection.cs
Origem:
FileDialogCustomPlacesCollection.cs

Adiciona um local personalizado à FileDialogCustomPlacesCollection coleção.

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

Um caminho de pasta para o local personalizado.

Exemplos

O exemplo de código seguinte demonstra como usar o Add método. Para executar este exemplo, cole o seguinte código num formulário Windows e chame InitializeDialogAndButton do construtor do formulário ou do método de gestão de eventos Load.

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

Observações

A pasta é adicionada a locais personalizados apenas para um determinado FileDialog caso e não é uma alteração a nível de sistema ou aplicação.

As pastas estão posicionadas nos locais personalizados pela ordem em que são adicionadas ao FileDialogarquivo . A última adicionada ficará no topo.

Ver também

Aplica-se a