SiteCollection.Add メソッド

リファレンス

定義

名前空間:: Microsoft.Web.Administration

アセンブリ:: Microsoft.Web.Administration.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

サイトコレクションに新しい Web サイトを追加します。

オーバーロード

Add(String, String, Int32)	指定したサイト名、パス、バインドポートを使用して、新しい Web サイトをサイトコレクションに追加します。
Add(String, String, String, Byte[])	指定したサイト名、バインド情報、物理ファイルパス、および証明書ハッシュを使用して、新しい Web サイトをサイトコレクションに追加します。
Add(String, String, String, String)	指定したパラメーターを使用して新しいサイトを作成し、サイトコレクションに追加します。
Add(String, String, String, Byte[], String)
Add(String, String, String, Byte[], String, SslFlags)

Add(String, String, Int32)

指定したサイト名、パス、バインドポートを使用して、新しい Web サイトをサイトコレクションに追加します。

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

新しい Web サイトの名前。

physicalPath: String

新しい Web サイトの物理ファイルパス。

port: Int32

新しい Web サイトのリッスンポート。

戻り値

Site

SiteオブジェクトにSiteCollection追加されたオブジェクト。

注釈

オブジェクトは Site 、この呼び出し中にメモリ内のコレクションに追加されます。ただし、サイト構成を構成システムにコミットするには、クラスを使用 ServerManager して更新を実行する必要があります。

適用対象

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

指定したサイト名、バインド情報、物理ファイルパス、および証明書ハッシュを使用して、新しい Web サイトをサイトコレクションに追加します。

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

新しい Web サイトの名前。

bindingInformation: String

新しい Web サイトのバインド情報。

physicalPath: String

新しい Web サイトの物理ファイルパス。

certificateHash: Byte[]

新しいサイトが Secure Sockets Layer (SSL) に使用する必要がある証明書ハッシュ。

戻り値

Site

SiteオブジェクトにSiteCollection追加されたオブジェクト。

注釈

サイトバインド情報は、プロトコル、IP アドレス、TCP ポート、およびホストヘッダーを含む文字列です。たとえば、システム上のすべての IP アドレスについてポート 80 で HTTP 接続をリッスンしている Web サイトでは、パラメーターに "http:*:80:" が bindingInformation 使用されます。アスタリスク (*) は、サイトがすべての IP アドレスでリッスンする必要があることを示すワイルドカード文字であることに注意してください。この例では、ホストヘッダーを省略しました。ホストヘッダーには Web サイトのドメイン名を含めることができます。これは、複数の Web サイトが同じ IP アドレスにバインドされている場合に使用されます。たとえば、ドメイン名が "microsoft.com" の IP アドレス 192.168.1.100 のポート 80 で HTTP 接続をリッスンしている Web サイトでは、パラメーターに "http:192.168.1.100:80:microsoft.com" を bindingInformation 使用します。

適用対象

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

サイトに割り当てる名前 ("既定の Web サイト" など)。

bindingProtocol: String

新しいサイトで使用するプロトコルのコンマ区切りの一覧。

bindingInformation: String

サイトリスナーをバインドする必要がある IP アドレス、ポート、ホストヘッダーを示す、コロン区切りのデータセット。

physicalPath: String

このサイトがアクセスできるコンテンツの物理的な場所。

戻り値

Site

新しく作成 Site されたオブジェクトへの参照。

例外

FormatException

nameメソッドに渡されるパラメーターは、null長さ 0 の文字列またはです。

例

次の例では、サイトを作成し、構成システムを更新します。

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 して更新を実行する必要があります。この呼び出しから返されるインスタンスには、オブジェクトのプロパティで SiteDefaults 指定された既定のサイト値は ServerManager 反映されません。

適用対象

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)

パラメーター

戻り値

適用対象

その他のリソース