FileDialogCustomPlacesCollection.Add Método

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Assembly:: System.Windows.Forms.Primitives.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Adiciona um local personalizado à FileDialogCustomPlacesCollection coleção.

Sobrecargas

Nome	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 um Windows Vista Pasta Conhecida.

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 formulário Windows e chame InitializeDialogAndButton do construtor do formulário ou Load método de tratamento 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 de 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 será 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 Windows Vista conhecidas disponíveis, consulte Known Folder GUIDs for File Dialog Custom Places or the KnownFolders.h file in the Windows SDK.

Confira 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

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 de 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 será na parte superior.

Confira também

FileDialogCustomPlace

Aplica-se a

Comentários

Esta página foi útil?