VirtualDirectoryCollection.Add(String, String) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Crea una nuova directory virtuale usando i parametri specificati e lo aggiunge alla raccolta di directory virtuali.
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
Parametri
- path
- String
Percorso della directory virtuale, rispetto all'applicazione che ospiterà la directory virtuale.
- physicalPath
- String
Posizione fisica in cui vengono archiviati i contenuti della directory virtuale.
Restituisce
Riferimento all'oggetto appena creato VirtualDirectory .
Eccezioni
Il percorso è null
, una stringa di lunghezza zero o contiene caratteri restituiti dal InvalidVirtualDirectoryPathCharacters() metodo .
Il percorso specificato dal path
parametro esiste già nella directory virtuale.
Esempio
Nell'esempio seguente viene usato il Add metodo per creare una nuova directory virtuale in un'applicazione.
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();
}
}
}
Commenti
Questo metodo crea un VirtualDirectory oggetto e lo aggiunge alla raccolta di directory virtuali in memoria. Tuttavia, per eseguire il commit della configurazione della directory virtuale nel sistema di configurazione, sarà necessario usare la ServerManager classe per eseguire un aggiornamento. L'istanza restituita da questa chiamata non riflette i valori dell'applicazione predefiniti specificati nella VirtualDirectoryDefaults proprietà dell'oggetto corrente Application .