FileDialogCustomPlacesCollection.Add Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.Primitives.dll

Fügt der FileDialogCustomPlacesCollection-Auflistung einen benutzerdefinierten Speicherort hinzu.

Überlädt

Add(Guid)	Fügt der FileDialogCustomPlacesCollection-Auflistung einen benutzerdefinierten Speicherort hinzu.
Add(String)	Fügt der FileDialogCustomPlacesCollection-Auflistung einen benutzerdefinierten Speicherort hinzu.

Add(Guid)

Fügt der FileDialogCustomPlacesCollection-Auflistung einen benutzerdefinierten Speicherort hinzu.

public:
 void Add(Guid knownFolderGuid);

public void Add (Guid knownFolderGuid);

override this.Add : Guid -> unit

Public Sub Add (knownFolderGuid As Guid)

Parameter

knownFolderGuid

Guid

Eine Guid , die einen bekannten Windows Vista-Ordner darstellt.

Beispiele

Das folgende Codebeispiel zeigt, wie Sie die Add-Methode verwenden. Fügen Sie zum Ausführen dieses Beispiels den folgenden Code in eine Windows Form ein, und rufen Sie InitializeDialogAndButton den Konstruktor oder Load die Ereignisbehandlungsmethode des Formulars auf.

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

Hinweise

Der Ordner wird benutzerdefinierten Stellen nur für eine bestimmte FileDialog Stelle hinzugefügt und ist keine system- oder anwendungsweite Änderung.

Die Ordner werden an den benutzerdefinierten Stellen in der Reihenfolge positioniert, in der sie dem FileDialoghinzugefügt werden. Die zuletzt hinzugefügte wird ganz oben angezeigt. Wenn Sie der Sammlung einen benutzerdefinierten Ort hinzufügen, der auf dem Computer, auf dem die Anwendung ausgeführt wird, nicht vorhanden ist, wird der benutzerdefinierte Ort nicht angezeigt. BEI GUIDs wird die Groß-/Kleinschreibung nicht beachtet. Eine Liste der verfügbaren bekannten Windows Vista-Ordner finden Sie unter Bekannte Ordner-GUIDs für benutzerdefinierte Speicherorte im Dateidialogdialog oder in der Datei KnownFolders.h im Windows SDK.

Weitere Informationen

• FileDialogCustomPlace
• Bekannte Ordner-Guids für benutzerdefinierte Speicherorte im Dateidialogfeld

Add(String)

Fügt der FileDialogCustomPlacesCollection-Auflistung einen benutzerdefinierten Speicherort hinzu.

public:
 void Add(System::String ^ path);

public void Add (string? path);

override this.Add : string -> unit

Public Sub Add (path As String)

Parameter

path

String

Ein Ordnerpfad zum benutzerdefinierten Speicherort.

Beispiele

Das folgende Codebeispiel zeigt, wie Sie die Add-Methode verwenden. Fügen Sie zum Ausführen dieses Beispiels den folgenden Code in eine Windows Form ein, und rufen Sie InitializeDialogAndButton den Konstruktor oder Load die Ereignisbehandlungsmethode des Formulars auf.

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

Hinweise

Der Ordner wird benutzerdefinierten Stellen nur für eine bestimmte FileDialog Stelle hinzugefügt und ist keine system- oder anwendungsweite Änderung.

Die Ordner werden an den benutzerdefinierten Stellen in der Reihenfolge positioniert, in der sie dem FileDialoghinzugefügt werden. Die zuletzt hinzugefügte wird ganz oben angezeigt.

Weitere Informationen

• FileDialogCustomPlace