VirtualDirectoryCollection.Add(String, String) Methode

Referenz

Definition

Namespace:: Microsoft.Web.Administration

Assembly:: Microsoft.Web.Administration.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Erstellt mithilfe der angegebenen Parameter ein neues virtuelles Verzeichnis und fügt es der Sammlung des virtuellen Verzeichnisses hinzu.

public:
 Microsoft::Web::Administration::VirtualDirectory ^ Add(System::String ^ path, System::String ^ physicalPath);

public Microsoft.Web.Administration.VirtualDirectory Add (string path, string physicalPath);

override this.Add : string * string -> Microsoft.Web.Administration.VirtualDirectory

Public Function Add (path As String, physicalPath As String) As VirtualDirectory

Parameter

path: String

Der Pfad zum virtuellen Verzeichnis relativ zur Anwendung, die das virtuelle Verzeichnis hosten soll.

physicalPath: String

Der physische Speicherort, an dem der Inhalt des virtuellen Verzeichnisses gespeichert wird.

Gibt zurück

VirtualDirectory

Ein Verweis auf das neu erstellte VirtualDirectory Objekt.

Ausnahmen

FormatException

Der Pfad ist null, eine Zeichenfolge der Länge null, oder enthält Zeichen, die von der InvalidVirtualDirectoryPathCharacters() -Methode zurückgegeben werden.

InvalidOperationException

Der durch den path -Parameter angegebene Pfad ist bereits im virtuellen Verzeichnis vorhanden.

Beispiele

Im folgenden Beispiel wird die Add -Methode verwendet, um ein neues virtuelles Verzeichnis in einer Anwendung zu erstellen.

using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.Web.Administration;
using Microsoft.Web.Management;

namespace AdministrationSnippets
{
    class AdministrationVirtualDirectoryCollectionItem2
    {
        public void VirtualDirectoryAddGet()
        {
            ServerManager manager = new ServerManager();
            Site defaultSite = manager.Sites["Default Web Site"];

            ApplicationPool blogPool = manager.ApplicationPools.Add("PhotoApplicationPool");
            Application app = defaultSite.Applications.Add("/photo", @"C:\inetpub\wwwroot\photo");
            app.VirtualDirectories.Add("/family", @"C:\photos\family");
            manager.CommitChanges();

        }
    }
}

Hinweise

Diese Methode erstellt ein VirtualDirectory Objekt und fügt es der Sammlung des virtuellen Verzeichnisses im Arbeitsspeicher hinzu. Um die Konfiguration des virtuellen Verzeichnisses jedoch in das Konfigurationssystem zu commiten, müssen Sie die ServerManager -Klasse verwenden, um ein Update durchzuführen. Die von diesem Aufruf zurückgegebene Instanz spiegelt nicht die Standardwerte der Anwendung wider, die in der VirtualDirectoryDefaults Eigenschaft des aktuellen Application Objekts angegeben sind.

Gilt für:

Freigeben über