Initialize Méthode (String, NameValueCollection)
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

SiteMapProvider.Initialize, méthode (String, NameValueCollection)

 

Initialise l'implémentation de SiteMapProvider, y compris toutes les ressources nécessaires pour charger des données de plan de site à partir d'un stockage persistant.

Espace de noms:   System.Web
Assembly:  System.Web (dans System.Web.dll)

public override void Initialize(
	string name,
	NameValueCollection attributes
)

Paramètres

name

Name du fournisseur à initialiser.

attributes

NameValueCollection qui peut contenir des attributs supplémentaires contribuant à initialiser le fournisseur.Ces attributs sont lus à partir de la configuration du fournisseur de plan de site dans le fichier Web.config.

La méthode Initialize ne construit pas réellement de plan de site ; elle prépare seulement l'état de l'objet SiteMapProvider à cette fin.L'implémentation par défaut initialise la propriété SecurityTrimmingEnabled pour le fournisseur de plan de site depuis la configuration de la navigation au sein du site.

Les classes qui dérivent du SiteMapProvider peuvent substituer la méthode Initialize pour initialiser tout état et toute ressource nécessaires pour charger des données de plan de site à partir d'un stockage persistant.Par exemple, si votre classe dérivée utilise des fichiers pour stocker des données de plan de site, toute initialisation de fichier peut s'effectuer dans la méthode Initialize.Si la classe dérivée utilise un autre type de magasin de données, notamment une base de données relationnelle, vous pouvez initialiser une connexion de base de données.

Les attributs supplémentaires, tels que des noms de fichiers ou des chaînes de connexion, sont lus par le système de configuration ASP.NET et sont passés à la méthode Initialize avec son paramètre NameValueCollection.

Remarques à l'attention des héritiers :

Lorsque vous substituez la méthode Initialize dans une classe dérivée, veillez à appeler en premier lieu la méthode Initialize pour la classe de base avant d'exécuter vos propres initialisations.

L'exemple de code suivant montre comment substituer la méthode Initialize pour préparer une connexion de base de données Microsoft Access.

La chaîne de connexion pour l'objet OleDbConnection est passée dans le paramètre NameValueCollection de la méthode Initialize.Dans ce cas, la chaîne de connexion est fournie par la section spécifique au fournisseur du fichier Web.config.Ici, accessSiteMapConnectionString contient une chaîne de connexion à une base de données Microsoft Access qui héberge les données de plan de site.

<siteMap defaultProvider="AccessSiteMapProvider">
  <providers>
     <add
       name="AccessSiteMapProvider"
       type="Samples.AspNet.AccessSiteMapProvider,Samples.AspNet"
       accessSiteMapConnectionString="PROVIDER=MICROSOFT.JET.OLEDB.4.0;DATA SOURCE=\\SomeUNCShare\\sitemap.mdb"/>
  </providers> 
 </siteMap>

Cet exemple de code fait partie d'un exemple plus complet fourni pour la classe SiteMapProvider.

// Initialize is used to initialize the properties and any state that the
// AccessProvider holds, but is not used to build the site map.
// The site map is built when the BuildSiteMap method is called.
public override void Initialize(string name, NameValueCollection attributes) {
    if (IsInitialized)
        return;

    base.Initialize(name, attributes);

    // Create and test the connection to the Microsoft Access database.

    // Retrieve the Value of the Access connection string from the
    // attributes NameValueCollection.
    string connectionString = attributes[AccessConnectionStringName];

    if (null == connectionString || connectionString.Length == 0)
        throw new Exception ("The connection string was not found.");
    else
        accessConnection = new OleDbConnection(connectionString);

    initialized = true;
}

.NET Framework
Disponible depuis 2.0
Retour au début
Afficher:
© 2016 Microsoft