SiteCollection.Add Metodo

Riferimento

Definizione

Spazio dei nomi:: Microsoft.Web.Administration

Assembly:: Microsoft.Web.Administration.dll

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.

Aggiunge un nuovo sito Web alla raccolta siti.

Overload

Add(String, String, Int32)	Aggiunge un nuovo sito Web alla raccolta siti usando il nome del sito, il percorso e la porta di associazione specificati.
Add(String, String, String, Byte[])	Aggiunge un nuovo sito Web alla raccolta siti usando il nome del sito specificato, le informazioni di associazione, il percorso del file fisico e l'hash del certificato.
Add(String, String, String, String)	Crea un nuovo sito usando i parametri specificati e lo aggiunge alla raccolta siti.
Add(String, String, String, Byte[], String)
Add(String, String, String, Byte[], String, SslFlags)

Add(String, String, Int32)

Aggiunge un nuovo sito Web alla raccolta siti usando il nome del sito, il percorso e la porta di associazione specificati.

public:
 Microsoft::Web::Administration::Site ^ Add(System::String ^ name, System::String ^ physicalPath, int port);

public Microsoft.Web.Administration.Site Add (string name, string physicalPath, int port);

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

Public Function Add (name As String, physicalPath As String, port As Integer) As Site

Parametri

name: String

Nome del nuovo sito Web.

physicalPath: String

Percorso del file fisico del nuovo sito Web.

port: Int32

Porta di ascolto del nuovo sito Web.

Restituisce

Site

Oggetto Site aggiunto all'oggetto SiteCollection .

Commenti

L'oggetto Site viene aggiunto alla raccolta in memoria durante questa chiamata. Tuttavia, per eseguire il commit della configurazione del sito nel sistema di configurazione, sarà necessario usare la ServerManager classe per eseguire l'aggiornamento.

Si applica a

Add(String, String, String, Byte[])

Aggiunge un nuovo sito Web alla raccolta siti usando il nome del sito specificato, le informazioni di associazione, il percorso del file fisico e l'hash del certificato.

public:
 Microsoft::Web::Administration::Site ^ Add(System::String ^ name, System::String ^ bindingInformation, System::String ^ physicalPath, cli::array <System::Byte> ^ certificateHash);

public Microsoft.Web.Administration.Site Add (string name, string bindingInformation, string physicalPath, byte[] certificateHash);

override this.Add : string * string * string * byte[] -> Microsoft.Web.Administration.Site

Public Function Add (name As String, bindingInformation As String, physicalPath As String, certificateHash As Byte()) As Site

Parametri

name: String

Nome del nuovo sito Web.

bindingInformation: String

Informazioni di associazione per il nuovo sito Web.

physicalPath: String

Percorso del file fisico del nuovo sito Web.

certificateHash: Byte[]

Hash del certificato che il nuovo sito deve usare per Secure Sockets Layer (SSL).

Restituisce

Site

Oggetto Site aggiunto all'oggetto SiteCollection .

Commenti

Le informazioni sull'associazione del sito sono una stringa contenente il protocollo, l'indirizzo IP, la porta TCP e l'intestazione host. Ad esempio, un sito Web in ascolto delle connessioni HTTP sulla porta 80 per tutti gli indirizzi IP del sistema userebbe "http:*:80:" per il bindingInformation parametro. Si noti che l'asterisco (*) è un carattere jolly che indica che il sito deve essere in ascolto su tutti gli indirizzi IP. In questo esempio l'intestazione host è stata omessa. L'intestazione host può contenere il nome di dominio del sito Web e viene usato quando più siti Web sono associati allo stesso indirizzo IP. Ad esempio, un sito Web in ascolto delle connessioni HTTP sulla porta 80 dell'indirizzo IP 192.168.1.100 con un nome di dominio "microsoft.com" userebbe "http:192.168.1.100:80:microsoft.com" per il bindingInformation parametro.

Si applica a

Add(String, String, String, String)

Crea un nuovo sito usando i parametri specificati e lo aggiunge alla raccolta siti.

public:
 Microsoft::Web::Administration::Site ^ Add(System::String ^ name, System::String ^ bindingProtocol, System::String ^ bindingInformation, System::String ^ physicalPath);

public Microsoft.Web.Administration.Site Add (string name, string bindingProtocol, string bindingInformation, string physicalPath);

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

Public Function Add (name As String, bindingProtocol As String, bindingInformation As String, physicalPath As String) As Site

Parametri

name: String

Nome da assegnare al sito, ad esempio "Sito Web predefinito").

bindingProtocol: String

Elenco delimitato da virgole dei protocolli che il nuovo sito deve usare.

bindingInformation: String

Set delimitato da punti di dati che indica l'indirizzo IP, la porta e le intestazioni host a cui deve essere associato il listener del sito.

physicalPath: String

Posizione fisica del contenuto a cui verrà fornito l'accesso a questo sito.

Restituisce

Site

Riferimento all'oggetto appena creato Site .

Eccezioni

FormatException

Il name parametro passato al metodo è o è null una stringa di lunghezza zero.

Esempio

Nell'esempio seguente viene creato un sito e viene aggiornato il sistema di configurazione.

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

namespace AdministrationSnippets
{
    class MicrosoftWebAdministrationSite
    {// Creates an site named HRWeb
        public void CreateSite()
        {
            CreateSiteByName("HRWeb");
        }

        // Creates a new site with the specified name
        public void CreateSiteByName(string name)
        {
            string path = @"C:\inetpub\" + name + "site";

            // Validate the site name
            char[] invalid = SiteCollection.InvalidSiteNameCharacters();
            if (name.IndexOfAny(invalid) > -1)
            {
                Console.WriteLine("Invalid site name: {0}", name);
            }

            // Create the content directory if it doesn't exist.
            if (!System.IO.Directory.Exists(path))
            {
                System.IO.Directory.CreateDirectory(path);
            }

            // Create a new site using the new directory and update the config
            ServerManager manager = new ServerManager();
            try
            {   // Add this site.
                Site hrSite = manager.Sites.Add(name, "http", "*:9090:", path);
                // The site will need to be started manually.
                hrSite.ServerAutoStart = false;
                manager.CommitChanges();
                Console.WriteLine("Site " + name + " added to ApplicationHost.config file.");
            }
            catch
            {
                // A site with this binding already exists. Do not attempt
                // to add a duplicate site.
            }
        }
    }
}

Commenti

Questo metodo crea un Site oggetto e lo aggiunge all'oggetto SiteCollection in memoria. Tuttavia, per eseguire il commit della configurazione del sito nel sistema di configurazione, sarà necessario usare la ServerManager classe per eseguire un aggiornamento. L'istanza restituita da questa chiamata non riflette i valori predefiniti del sito specificati nella SiteDefaults proprietà dell'oggetto ServerManager .

Si applica a

Add(String, String, String, Byte[], String)

public:
 Microsoft::Web::Administration::Site ^ Add(System::String ^ name, System::String ^ bindingInformation, System::String ^ physicalPath, cli::array <System::Byte> ^ certificateHash, System::String ^ certificateStore);

public Microsoft.Web.Administration.Site Add (string name, string bindingInformation, string physicalPath, byte[] certificateHash, string certificateStore);

override this.Add : string * string * string * byte[] * string -> Microsoft.Web.Administration.Site

Public Function Add (name As String, bindingInformation As String, physicalPath As String, certificateHash As Byte(), certificateStore As String) As Site

Parametri

name: String

bindingInformation: String

physicalPath: String

certificateHash: Byte[]

certificateStore: String

Restituisce

Site

Si applica a

Add(String, String, String, Byte[], String, SslFlags)

public:
 Microsoft::Web::Administration::Site ^ Add(System::String ^ name, System::String ^ bindingInformation, System::String ^ physicalPath, cli::array <System::Byte> ^ certificateHash, System::String ^ certificateStore, Microsoft::Web::Administration::SslFlags sslFlags);

public Microsoft.Web.Administration.Site Add (string name, string bindingInformation, string physicalPath, byte[] certificateHash, string certificateStore, Microsoft.Web.Administration.SslFlags sslFlags);

override this.Add : string * string * string * byte[] * string * Microsoft.Web.Administration.SslFlags -> Microsoft.Web.Administration.Site

Parametri

name: String

bindingInformation: String

physicalPath: String

certificateHash: Byte[]

certificateStore: String

sslFlags: SslFlags

Restituisce

Site

Si applica a

Condividi tramite

SiteCollection.Add Metodo

Definizione

Overload

Add(String, String, Int32)

Parametri

Restituisce

Commenti

Si applica a

Add(String, String, String, Byte[])

Parametri

Restituisce

Commenti

Si applica a

Add(String, String, String, String)

Parametri

Restituisce

Eccezioni

Esempio

Commenti

Si applica a

Add(String, String, String, Byte[], String)

Parametri

Restituisce

Si applica a

Add(String, String, String, Byte[], String, SslFlags)

Parametri

Restituisce

Si applica a

Risorse aggiuntive