SiteCollection.Add Méthode

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

Paramètres

Retours

Objet Site qui a été ajouté à l’objet SiteCollection .

Remarques

L’objet Site est ajouté à la collection en mémoire pendant cet appel. Toutefois, pour valider la configuration du site sur le système de configuration, vous devez utiliser la ServerManager classe pour effectuer la mise à jour.

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

Paramètres

Retours

Objet Site qui a été ajouté à l’objet SiteCollection .

Remarques

Les informations de liaison de site sont une chaîne qui contient le protocole, l’adresse IP, le port TCP et l’en-tête de l’hôte. Par exemple, un site Web qui écoute les connexions HTTP sur le port 80 pour toutes les adresses IP sur le système utilise « http:*:80: » pour le bindingInformation paramètre . Notez que l’astérisque (*) est un caractère générique indiquant que le site doit écouter sur toutes les adresses IP. Dans cet exemple, l’en-tête de l’hôte a été omis. L’en-tête d’hôte peut contenir le nom de domaine du site Web et est utilisé lorsque plusieurs sites Web sont liés à la même adresse IP. Par exemple, un site Web qui écoute les connexions HTTP sur le port 80 de l’adresse IP 192.168.1.100 avec le nom de domaine « microsoft.com » utilise « http:192.168.1.100:80:microsoft.com » pour le bindingInformation paramètre .

L’objet Site est ajouté à la collection en mémoire pendant cet appel. Toutefois, pour valider la configuration du site sur le système de configuration, vous devez utiliser la ServerManager classe pour effectuer la mise à jour.

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

Paramètres

Retours

Référence à l’objet nouvellement créé Site .

Exceptions

Exemples

L’exemple suivant crée un site et met à jour le système de configuration.

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.
            }
        }
    }
}

Remarques

Cette méthode crée un Site objet et l’ajoute à l’objet SiteCollection en mémoire. Toutefois, pour valider la configuration du site sur 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 de site par défaut spécifiées dans la SiteDefaults propriété de l’objet ServerManager .

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

Paramètres

Retours

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

Paramètres

Retours