FileDialogCustomPlacesCollection.Add Método

Definição

Adiciona um local personalizado para a coleção FileDialogCustomPlacesCollection.

Sobrecargas

Add(Guid)

Adiciona um local personalizado para a coleção FileDialogCustomPlacesCollection.

Add(String)

Adiciona um local personalizado para a coleção FileDialogCustomPlacesCollection.

Add(Guid)

Adiciona um local personalizado para a coleção 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

Um Guid que representa uma Pasta Conhecida do Windows Vista.

Exemplos

O exemplo de código a seguir demonstra como usar o Add método . Para executar este exemplo, cole o código a seguir em um Windows Form e chame InitializeDialogAndButton do construtor do formulário ou Load do método de manipulação de eventos.

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

Comentários

A pasta é adicionada a locais personalizados apenas para um determinado FileDialog e não é uma alteração em todo o sistema ou aplicativo.

As pastas são posicionadas nos locais personalizados na ordem em que são adicionadas ao FileDialog. O último adicionado estará na parte superior. Se você adicionar um local personalizado à coleção que não existe no computador que executa o aplicativo, o local personalizado não será mostrado. GuiDs não diferenciam maiúsculas de minúsculas. Para obter uma lista das Pastas Conhecidas do Windows Vista disponíveis, consulte GUIDs de pasta conhecidas para locais personalizados da caixa de diálogo de arquivos ou o arquivo KnownFolders.h no SDK do Windows.

Confira também

Aplica-se a

Add(String)

Adiciona um local personalizado para a coleção 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

Um caminho de pasta para o local personalizado.

Exemplos

O exemplo de código a seguir demonstra como usar o Add método . Para executar este exemplo, cole o código a seguir em um Windows Form e chame InitializeDialogAndButton do construtor do formulário ou Load do método de manipulação de eventos.

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

Comentários

A pasta é adicionada a locais personalizados apenas para um determinado FileDialog e não é uma alteração em todo o sistema ou aplicativo.

As pastas são posicionadas nos locais personalizados na ordem em que são adicionadas ao FileDialog. O último adicionado estará na parte superior.

Confira também

Aplica-se a