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

網站的系結資訊。

bindingProtocol

String

月臺系結使用的通訊協定。 參數 bindingProtocol 必須是 「HTTP」 或 「HTTPs」。

傳回

Binding

已加入至集合的系結。

備註

參數 bindingInformation 有三個以冒號分隔的欄位。 第一個欄位是特定 IP 位址或星號， (星號指定所有未指派的 IP 位址) 。 第二個欄位是埠號碼;預設值為 80。 第三個欄位是選擇性的主機標頭。

嘗試新增已經存在的系結將會引發錯誤。

當繫結項目新增至 物件並使用 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

網站的系結資訊。

certificateHash

Byte[]

安全通訊端層 (SSL) 系結的憑證雜湊。 憑證雜湊是憑證的唯一識別碼。

certificateStoreName

String

SSL 系結的憑證存放區名稱。

傳回

Binding

已加入至集合的系結。

範例

下列範例會從使用 「HTTPs」 通訊協定的現有網站系結擷取有效的憑證雜湊和憑證存放區名稱。 此範例接著會使用擷取的憑證雜湊和憑證存放區，將系結新增至系結集合，並指定 「*：448：TestingSite」 的系結資訊。 最後，此範例會更新ApplicationHost.config檔案，而新定義的系結會出現在 [ 站 台系結] 對話方塊中。 如果系結已經存在，則會刪除系結，讓使用者在新增和刪除系結之間切換。 這個範例是 [Add Method (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();
}

備註

這個方法會將 [Add Method (String， Byte < xref：Microsoft.Web.Administration.Binding > 物件與 「HTTPs」 通訊協定新增至 [Add 方法 (String， Byte < xref：Microsoft.Web.Administration.BindingCollection > 物件。 參數 bindingInformation 有三個以冒號分隔的欄位。 第一個欄位是特定 IP 位址或星號， (星號指定所有未指派的 IP 位址) 。 第二個欄位是埠號碼;預設值為 80。 第三個欄位是選擇性的主機標頭。

嘗試新增已經存在的系結將會引發錯誤。

當繫結項目新增至 [Add 方法 (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