VirtualDirectoryCollection.Add(String, String) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Crée un répertoire virtuel à l’aide des paramètres spécifiés et l’ajoute à la collection de répertoires virtuels.
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
Paramètres
- path
- String
Chemin d’accès au répertoire virtuel, relatif à l’application qui hébergera le répertoire virtuel.
- physicalPath
- String
Emplacement physique où le contenu du répertoire virtuel est stocké.
Retours
Référence à l’objet nouvellement créé VirtualDirectory .
Exceptions
Le chemin est null
, une chaîne de longueur nulle ou contient des caractères retournés par la InvalidVirtualDirectoryPathCharacters() méthode .
Le chemin spécifié par le path
paramètre existe déjà dans le répertoire virtuel.
Exemples
L’exemple suivant utilise la Add méthode pour créer un répertoire virtuel dans une application.
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();
}
}
}
Remarques
Cette méthode crée un VirtualDirectory objet et l’ajoute à la collection de répertoires virtuels en mémoire. Toutefois, pour valider la configuration du répertoire virtuel dans le système de configuration, vous devez utiliser la ServerManager classe pour effectuer une mise à jour. L’instance retournée à partir de cet appel ne reflète pas les valeurs d’application par défaut spécifiées dans la VirtualDirectoryDefaults propriété de l’objet actuel Application .