SiteCollection.Add 方法

參考

定義

命名空間:: Microsoft.Web.Administration

組件:: Microsoft.Web.Administration.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

將新的網站新增至網站集合。

多載

Add(String, String, Int32)	使用指定的網站名稱、路徑和系結埠，將新的網站新增至網站集合。
Add(String, String, String, Byte[])	使用指定的網站名稱、系結資訊、實體檔案路徑和憑證雜湊，將新的網站新增至網站集合。
Add(String, String, String, String)	使用指定的參數建立新的網站，並將它新增至網站集合。
Add(String, String, String, Byte[], String)
Add(String, String, String, Byte[], String, SslFlags)

Add(String, String, Int32)

使用指定的網站名稱、路徑和系結埠，將新的網站新增至網站集合。

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

參數

name: String

新網站的名稱。

physicalPath: String

新網站的實體檔案路徑。

port: Int32

新網站的接聽埠。

傳回

Site

Site已加入至 SiteCollection 物件的物件。

備註

物件 Site 會在呼叫期間新增至記憶體中的集合。不過，若要將月臺設定認可至組態系統，您必須使用 ServerManager 類別來執行更新。

適用於

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

使用指定的網站名稱、系結資訊、實體檔案路徑和憑證雜湊，將新的網站新增至網站集合。

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

參數

name: String

新網站的名稱。

bindingInformation: String

新網站的系結資訊。

physicalPath: String

新網站的實體檔案路徑。

certificateHash: Byte[]

新月臺應用於安全通訊端層 (SSL) 的憑證雜湊。

傳回

Site

Site已加入至 SiteCollection 物件的物件。

備註

月臺系結資訊是包含通訊協定、IP 位址、TCP 埠和主機標頭的字串。例如，接聽埠 80 上所有 IP 位址之 HTTP 連線的網站會針對 bindingInformation 參數使用「HTTP：*：80：」。請注意，星號 (*) 是萬用字元，表示網站應該接聽所有 IP 位址。在此範例中，省略主機標頭。主機標頭可以包含網站的功能變數名稱，並在多個網站系結至相同的 IP 位址時使用。例如，在 IP 位址 192.168.1.1.100 的埠 80 上接聽 HTTP 連線的網站，其功能變數名稱為「microsoft.com」會使用 bindingInformation 「HTTP：192.168.1.100：80：microsoft.com」。

物件 Site 會在呼叫期間新增至記憶體中的集合。不過，若要將月臺設定認可至組態系統，您必須使用 ServerManager 類別來執行更新。

適用於

Add(String, String, String, String)

使用指定的參數建立新的網站，並將它新增至網站集合。

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

參數

name: String

要指派給網站的名稱 (例如「預設網站」) 。

bindingProtocol: String

新月臺應該使用的通訊協定逗號分隔清單。

bindingInformation: String

以冒號分隔的資料集，表示月臺接聽程式應該系結的 IP 位址、埠和主機標頭。

physicalPath: String

此網站提供存取權之內容的實體位置。

傳回

Site

新建立 Site 物件的參考。

例外狀況

FormatException

name傳遞至方法的參數為 null 或為長度為零的字串。

範例

下列範例會建立月臺並更新組態系統。

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

備註

這個方法會 Site 建立物件，並將它新增至 SiteCollection 記憶體中的物件。不過，若要將月臺設定認可至組態系統，您必須使用 ServerManager 類別來執行更新。從這個呼叫傳回的 ServerManager 實例不會反映物件屬性中指定的 SiteDefaults 預設月臺值。

適用於

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

參數

name: String

bindingInformation: String

physicalPath: String

certificateHash: Byte[]

certificateStore: String

傳回

Site

適用於

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

參數

name: String

bindingInformation: String

physicalPath: String

certificateHash: Byte[]

certificateStore: String

sslFlags: SslFlags

傳回

Site

適用於

共用方式為

SiteCollection.Add 方法

定義

多載

Add(String, String, Int32)

參數

傳回

備註

適用於

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

參數

傳回

備註

適用於

Add(String, String, String, String)

參數

傳回

例外狀況

範例

備註

適用於

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

參數

傳回

適用於

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

參數

傳回

適用於

其他資源