Freigeben über

BindingCollection.Add Methode

  • Referenz

Definition

Namespace:
Microsoft.Web.Administration
Assembly:
Microsoft.Web.Administration.dll

Fügt der Bindungsauflistung eine HTTP- oder HTTPS-Bindung hinzu.

Überlädt

Add(Binding)

Fügt am Ende der Auflistung eine sichere Bindung hinzu.
Add(String, String)

Fügt der Bindungsauflistung eine Bindung mit dem angegebenen Protokoll und Bindungsinformationen hinzu.
Add(String, Byte[], String)

Fügt der Bindungsauflistung eine sichere Bindung hinzu.
Add(String, Byte[], String, SslFlags)

Add(Binding)

Fügt am Ende der Auflistung eine sichere Bindung hinzu.

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

Parameter

binding
Binding

Das Binding-Objekt, das zur Auflistung hinzugefügt werden soll.

Gibt zurück

Binding

Die Bindung, die der Auflistung hinzugefügt wurde.

Ausnahmen

ArgumentNullException

Der binding-Parameter ist null.

Hinweise

Wenn dem Objekt ein Bindungselement hinzugefügt BindingCollection und mit der Update -Methode aktualisiert wird, wird es in der ApplicationHost.config-Datei gespeichert.

Nachdem eine Bindung hinzugefügt und die ApplicationHost.config Datei aktualisiert wurde, zeigt IIS-Manager die neue Bindung im Dialogfeld Websitebindungen an.

Gilt für:

Add(String, String)

Fügt der Bindungsauflistung eine Bindung mit dem angegebenen Protokoll und Bindungsinformationen hinzu.

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

Parameter

bindingInformation
String

Die Bindungsinformationen für eine Website.

bindingProtocol
String

Das Protokoll, das von der Websitebindung verwendet wird. Der bindingProtocol Parameter muss "http" oder "https" sein.

Gibt zurück

Binding

Die Bindung, die der Auflistung hinzugefügt wurde.

Hinweise

Der bindingInformation Parameter verfügt über drei durch Doppelpunkt getrennte Felder. Das erste Feld ist eine bestimmte IP-Adresse oder ein Sternchen (ein Sternchen gibt alle nicht zugewiesenen IP-Adressen an). Das zweite Feld ist die Portnummer; der Standardwert ist 80. Das dritte Feld ist ein optionaler Hostheader.

Ein Versuch, eine bereits vorhandene Bindung hinzuzufügen, löst einen Fehler aus.

Wenn dem Objekt ein Bindungselement hinzugefügt BindingCollection und mit der Update -Methode aktualisiert wird, wird es in der ApplicationHost.config-Datei gespeichert.

Nachdem eine Bindung hinzugefügt und die ApplicationHost.config Datei aktualisiert wurde, zeigt IIS-Manager die neue Bindung im Dialogfeld Websitebindungen an.

Gilt für:

Add(String, Byte[], String)

Fügt der Bindungsauflistung eine sichere Bindung hinzu.

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

Parameter

bindingInformation
String

Die Bindungsinformationen für eine Website.

certificateHash
Byte[]

Der Zertifikathash für die SSL-Bindung (Secure Sockets Layer). Der Zertifikathash ist der eindeutige Bezeichner für das Zertifikat.

certificateStoreName
String

Der Name des Zertifikatspeichers für die SSL-Bindung.

Gibt zurück

Binding

Die Bindung, die der Auflistung hinzugefügt wurde.

Beispiele

Im folgenden Beispiel wird ein gültiger Zertifikathash und zertifikatspeichername aus einer vorhandenen Websitebindung abgerufen, die das Protokoll "https" verwendet. Im Beispiel wird der Bindungsauflistung dann eine Bindung mit dem abgerufenen Zertifikathash und Zertifikatspeicher hinzugefügt, wobei bindungsinformationen von "*:448:TestingSite" angegeben werden. Schließlich aktualisiert das Beispiel die ApplicationHost.config-Datei, und die neu definierte Bindung wird im Dialogfeld Websitebindungen angezeigt. Wenn die Bindung bereits vorhanden ist, wird die Bindung gelöscht, sodass der Benutzer zwischen dem Hinzufügen und Löschen der Bindung wechseln kann. Dieses Beispiel ist Teil eines größeren Beispiels, das für die [Add-Methode (String, Byte<xref:Microsoft.Web.Administration.BindingCollection-Klasse> ) bereitgestellt wird.

// 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();
}

Hinweise

Diese Methode fügt dem [Add Method (String, Byte<xref:Microsoft.Web.Administration.Binding-Objekt> ) mit dem Protokoll "https" ein [Add Method (String, Byte<xref:Microsoft.Web.Administration.BindingCollection-Objekt> ) hinzu. Der bindingInformation Parameter verfügt über drei durch Doppelpunkt getrennte Felder. Das erste Feld ist eine bestimmte IP-Adresse oder ein Sternchen (ein Sternchen gibt alle nicht zugewiesenen IP-Adressen an). Das zweite Feld ist die Portnummer; der Standardwert ist 80. Das dritte Feld ist ein optionaler Hostheader.

Ein Versuch, eine bereits vorhandene Bindung hinzuzufügen, löst einen Fehler aus.

Wenn ein Bindungselement der [Add-Methode (String, Byte<xref:Microsoft.Web.Administration.BindingCollection-Objekt> ) hinzugefügt und mit der [Add-Methode (String, Byte<xref:Microsoft.Web.Management.Server.ManagementUnit.Update%2A> )-Methode aktualisiert wird, wird es in der ApplicationHost.config-Datei gespeichert.

Nachdem eine Bindung hinzugefügt und die ApplicationHost.config Datei aktualisiert wurde, zeigt IIS-Manager die neue Bindung im Dialogfeld Websitebindungen an.

Gilt für:

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

Parameter

bindingInformation
String
certificateHash
Byte[]
certificateStoreName
String
sslFlags
SslFlags

Gibt zurück

Binding

Gilt für: