BindingCollection.Add メソッド

定義

名前空間:

Microsoft.Web.Administration

アセンブリ:

Microsoft.Web.Administration.dll

バインド コレクションに HTTP または HTTPS バインドを追加します。

オーバーロード

Add(Binding)	セキュリティで保護されたバインディングをコレクションの末尾に追加します。
Add(String, String)	指定したプロトコルとバインド情報を持つバインディングをバインド コレクションに追加します。
Add(String, Byte[], String)	バインド コレクションにセキュリティで保護されたバインドを追加します。
Add(String, Byte[], String, SslFlags)

Add(Binding)

セキュリティで保護されたバインディングをコレクションの末尾に追加します。

public:
 Microsoft::Web::Administration::Binding ^ Add(Microsoft::Web::Administration::Binding ^ binding);

public Microsoft.Web.Administration.Binding Add (Microsoft.Web.Administration.Binding binding);

override this.Add : Microsoft.Web.Administration.Binding -> Microsoft.Web.Administration.Binding

パラメーター

binding

Binding

コレクションに追加する Binding オブジェクト。

戻り値

Binding

コレクションに追加されたバインディング。

例外

ArgumentNullException

binding パラメーターが null です。

注釈

バインド要素が オブジェクトに BindingCollection 追加され、 メソッドで Update 更新されると、ApplicationHost.config ファイルに格納されます。

バインドが追加され、ApplicationHost.config ファイルが更新されると、IIS マネージャーによって [ サイト バインド ] ダイアログ ボックスに新しいバインドが表示されます。

Add(String, String)

指定したプロトコルとバインド情報を持つバインディングをバインド コレクションに追加します。

public:
 Microsoft::Web::Administration::Binding ^ Add(System::String ^ bindingInformation, System::String ^ bindingProtocol);

public Microsoft.Web.Administration.Binding Add (string bindingInformation, string bindingProtocol);

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

Public Function Add (bindingInformation As String, bindingProtocol As String) As Binding

パラメーター

bindingInformation

String

Web サイトのバインド情報。

bindingProtocol

String

サイト バインドで使用されるプロトコル。 パラメーターは bindingProtocol 、"http" または "https" である必要があります。

戻り値

Binding

コレクションに追加されたバインディング。

注釈

パラメーターには bindingInformation 、コロンで区切られた 3 つのフィールドがあります。 最初のフィールドは、特定の IP アドレスまたはアスタリスクです (アスタリスクは、割り当てられていないすべての IP アドレスを指定します)。 2 番目のフィールドはポート番号です。既定値は 80 です。 3 番目のフィールドはオプションのホスト ヘッダーです。

既に存在するバインドを追加しようとすると、エラーが発生します。

バインド要素が オブジェクトに BindingCollection 追加され、 メソッドで Update 更新されると、ApplicationHost.config ファイルに格納されます。

バインドが追加され、ApplicationHost.config ファイルが更新されると、IIS マネージャーによって [ サイト バインド ] ダイアログ ボックスに新しいバインドが表示されます。

Add(String, Byte[], String)

バインド コレクションにセキュリティで保護されたバインドを追加します。

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

public Microsoft.Web.Administration.Binding Add (string bindingInformation, byte[] certificateHash, string certificateStoreName);

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

Public Function Add (bindingInformation As String, certificateHash As Byte(), certificateStoreName As String) As Binding

パラメーター

bindingInformation

String

Web サイトのバインド情報。

certificateHash

Byte[]

Secure Sockets Layer (SSL) バインディングの証明書ハッシュ。 証明書ハッシュは、証明書の一意の識別子です。

certificateStoreName

String

SSL バインディングの証明書ストアの名前。

戻り値

Binding

コレクションに追加されたバインディング。

例

次の例では、"https" プロトコルを使用する既存のサイト バインドから有効な証明書ハッシュと証明書ストア名を取得します。 次に、取得した証明書ハッシュと証明書ストアを使用してバインド コレクションにバインドを追加し、"*:448:TestingSite" のバインド情報を指定します。 最後に、ApplicationHost.config ファイルを更新し、新しく定義されたバインドが [ サイト バインド ] ダイアログ ボックスに表示されます。 バインドが既に存在する場合は、バインドが削除されるため、ユーザーはバインドの追加と削除を切り替えることができます。 この例は、[Add メソッド (String, Byte<xref:Microsoft.Web.Administration.BindingCollection> クラス) に用意されている大きな例の一部です。

// Adding a duplicate binding throws an error.
if (siteToModify != null)
{
    newbindinginformation = "*:448:TestingSite";
    try
    {
        // Add this binding. It does not already exist. 
        siteToModify.Bindings.Add(newbindinginformation, newcertificateHash, newcertificateStoreName);
    }
    catch
    {
        // Remove this binding. It already exists.
        foreach (Microsoft.Web.Administration.Binding binding in siteToModify.Bindings)
        {
            if (binding.BindingInformation == newbindinginformation)
            {
                bindingIndex = siteToModify.Bindings.IndexOf(binding);
            }
        }
        if (bindingIndex != -1)
        {
            siteToModify.Bindings.RemoveAt(bindingIndex);
        }
    }
    // Update information and save in Administration.config file.
    ManagementUnit.Update();
}

注釈

このメソッドは、"https" プロトコルを持つ [Add メソッド (String, Byte<xref:Microsoft.Web.Administration.Binding> オブジェクト) を [Add Method (String, Byte<xref:Microsoft.Web.Administration.BindingCollection> オブジェクト) に追加します。 パラメーターには bindingInformation 、コロンで区切られた 3 つのフィールドがあります。 最初のフィールドは、特定の IP アドレスまたはアスタリスクです (アスタリスクは、割り当てられていないすべての IP アドレスを指定します)。 2 番目のフィールドはポート番号です。既定値は 80 です。 3 番目のフィールドはオプションのホスト ヘッダーです。

既に存在するバインドを追加しようとすると、エラーが発生します。

バインド要素が [Add Method (String, Byte<xref:Microsoft.Web.Administration.BindingCollection> オブジェクト) に追加され、[Add メソッド (String, Byte<xref:Microsoft.Web.Management.Server.ManagementUnit.Update%2A> メソッド) で更新されると、ApplicationHost.config ファイルに格納されます。

バインドが追加され、ApplicationHost.config ファイルが更新されると、IIS マネージャーによって [ サイト バインド ] ダイアログ ボックスに新しいバインドが表示されます。

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

public:
 Microsoft::Web::Administration::Binding ^ Add(System::String ^ bindingInformation, cli::array <System::Byte> ^ certificateHash, System::String ^ certificateStoreName, Microsoft::Web::Administration::SslFlags sslFlags);

public Microsoft.Web.Administration.Binding Add (string bindingInformation, byte[] certificateHash, string certificateStoreName, Microsoft.Web.Administration.SslFlags sslFlags);

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

パラメーター

bindingInformation

String

certificateHash

Byte[]

certificateStoreName

String

sslFlags

SslFlags

戻り値

Binding