BindingCollection.Add Méthode

Référence

Définition

Espace de noms:: Microsoft.Web.Administration

Assembly:: Microsoft.Web.Administration.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Ajoute une liaison HTTP ou HTTPS à la collection de liaisons.

Surcharges

Add(Binding)	Ajoute une liaison sécurisée à la fin de la collection.
Add(String, String)	Ajoute une liaison avec le protocole et les informations de liaison spécifiés à la collection de liaisons.
Add(String, Byte[], String)	Ajoute une liaison sécurisée à la collection de liaisons.
Add(String, Byte[], String, SslFlags)

Add(Binding)

Ajoute une liaison sécurisée à la fin de la collection.

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

Paramètres

binding: Binding

Objet Binding à ajouter à la collection.

Retours

Binding

Liaison qui a été ajoutée à la collection.

Exceptions

ArgumentNullException

Le paramètre binding a la valeur null.

Remarques

Lorsqu’un élément de liaison est ajouté à l’objet BindingCollection et mis à jour avec la Update méthode , il est stocké dans le fichier ApplicationHost.config.

Une fois qu’une liaison a été ajoutée et que le fichier ApplicationHost.config a été mis à jour, le Gestionnaire des services Internet affiche la nouvelle liaison dans la boîte de dialogue Liaisons de site .

S’applique à

Add(String, String)

Ajoute une liaison avec le protocole et les informations de liaison spécifiés à la collection de liaisons.

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

Paramètres

bindingInformation: String

Informations de liaison pour un site Web.

bindingProtocol: String

Protocole utilisé par la liaison de site. Le bindingProtocol paramètre doit être « http » ou « https ».

Retours

Binding

Liaison qui a été ajoutée à la collection.

Remarques

Le bindingInformation paramètre comporte trois champs délimités par deux-points. Le premier champ est une adresse IP spécifique ou un astérisque (un astérisque spécifie toutes les adresses IP non attribuées). Le deuxième champ est le numéro de port ; la valeur par défaut est 80. Le troisième champ est un en-tête d’hôte facultatif.

Une tentative d’ajout d’une liaison qui existe déjà génère une erreur.

Lorsqu’un élément de liaison est ajouté à l’objet BindingCollection et mis à jour avec la Update méthode , il est stocké dans le fichier ApplicationHost.config.

S’applique à

Add(String, Byte[], String)

Ajoute une liaison sécurisée à la collection de liaisons.

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

Paramètres

bindingInformation: String

Informations de liaison pour un site Web.

certificateHash: Byte[]

Hachage de certificat pour la liaison SSL (Secure Sockets Layer). Le hachage du certificat est l’identificateur unique du certificat.

certificateStoreName: String

Nom du magasin de certificats pour la liaison SSL.

Retours

Binding

Liaison qui a été ajoutée à la collection.

Exemples

L’exemple suivant récupère un hachage de certificat et un nom de magasin de certificats valides à partir d’une liaison de site existante qui utilise le protocole « https ». L’exemple ajoute ensuite une liaison à la collection de liaisons avec le hachage de certificat et le magasin de certificats récupérés, en spécifiant les informations de liaison « *:448:TestingSite ». Enfin, l’exemple met à jour le fichier ApplicationHost.config et la liaison nouvellement définie s’affiche dans la boîte de dialogue Liaisons de site . Si la liaison existe déjà, la liaison est supprimée, ce qui permet à l’utilisateur de basculer entre l’ajout et la suppression de la liaison. Cet exemple fait partie d’un exemple plus grand fourni pour la classe [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();
}

Remarques

Cette méthode ajoute un objet [Add Method (String, Byte<xref:Microsoft.Web.Administration.Binding> avec le protocole « https » à l’objet [Add Method (String, Byte<xref:Microsoft.Web.Administration.BindingCollection> . Le bindingInformation paramètre comporte trois champs délimités par deux-points. Le premier champ est une adresse IP spécifique ou un astérisque (un astérisque spécifie toutes les adresses IP non attribuées). Le deuxième champ est le numéro de port ; la valeur par défaut est 80. Le troisième champ est un en-tête d’hôte facultatif.

Une tentative d’ajout d’une liaison qui existe déjà génère une erreur.

Lorsqu’un élément de liaison est ajouté à l’objet [Add Method (String, Byte<xref:Microsoft.Web.Administration.BindingCollection> et mis à jour avec la méthode [Add Method (String, Byte<xref:Microsoft.Web.Management.Server.ManagementUnit.Update%2A> ), il est stocké dans le fichier ApplicationHost.config.

S’applique à

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

Paramètres

bindingInformation: String

certificateHash: Byte[]

certificateStoreName: String

sslFlags: SslFlags

Retours

Binding

S’applique à

Partager via

BindingCollection.Add Méthode

Définition

Surcharges

Add(Binding)

Paramètres

Retours

Exceptions

Remarques

S’applique à

Add(String, String)

Paramètres

Retours

Remarques

S’applique à

Add(String, Byte[], String)

Paramètres

Retours

Exemples

Remarques

S’applique à

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

Paramètres

Retours

S’applique à

Ressources supplémentaires