SiteMapDataSource.SiteMapProvider SiteMapDataSource.SiteMapProvider SiteMapDataSource.SiteMapProvider SiteMapDataSource.SiteMapProvider Property

Definizione

Ottiene o imposta il nome del provider della mappa del sito a cui viene associata l'origine dati.Gets or sets the name of the site map provider that the data source binds to.

public:
 virtual property System::String ^ SiteMapProvider { System::String ^ get(); void set(System::String ^ value); };
public virtual string SiteMapProvider { get; set; }
member this.SiteMapProvider : string with get, set
Public Overridable Property SiteMapProvider As String

Valore della proprietà

Nome del provider della mappa del sito a cui viene associato il controllo SiteMapDataSource.The name of the site map provider that the SiteMapDataSource binds to. Per impostazione predefinita, il valore è Empty e per il sito viene utilizzato il provider della mappa del sito predefinito.By default, the value is Empty, and the default site map provider for the site is used.

Esempi

Nell'esempio di codice seguente viene illustrato come associare in modo TreeView dichiarativo un controllo ai dati della mappa del SiteMapProvider sito forniti da un oggetto diverso dal provider predefinito.The following code example demonstrates how to declaratively bind a TreeView control to site map data that is provided by an SiteMapProvider object other than the default provider. Il file Web. config rende disponibile un SiteMapProvider oggetto personalizzato per il SiteMapDataSource controllo:The Web.config file makes a custom SiteMapProvider object available to the SiteMapDataSource control:

<system.web>      
  <siteMap>  
    <providers>  
      <add name="AsciiTextProvider"  
        description="SiteMap provider which reads in .sitemap text files."  
        type="Samples.AspNet.CS.SimpleTextSiteMapProvider"  
      siteMapFile="test.txt"/>  
    </providers>  
  </siteMap>  
</system.web>  

Il codice per la SimpleTextSiteMapProvider classe a cui fa riferimento il file Web. config di esempio è reperibile nella panoramica della SiteMapProvider classe.The code for the SimpleTextSiteMapProvider class that this Web.config file example references can be found in the SiteMapProvider class overview. Se si usa l'Visual Basic esempio, lo spazio dei nomi termina con "VB" invece di "CS".If you use the Visual Basic example, the namespace ends in "VB" instead of "CS". È anche possibile trovare il contenuto di esempio per il file della mappa del sito "text. SiteMapProvider txt" nella panoramica della classe.You can also find sample content for the "text.txt" site map file in the SiteMapProvider class overview.

Nota

Non è il provider predefinito per il sito, che in questo caso rimane l' XmlSiteMapProvider oggetto. AsciiTextProviderThe AsciiTextProvider is not the default provider for the site, which (in this case) remains the XmlSiteMapProvider object. La SiteMapProvider proprietà TreeView del controllo è impostata sul nome di un provider della mappa del sito personalizzato e viene associato ai dati corrispondenti della mappa del sito. SiteMapDataSourceThe SiteMapProvider property of the SiteMapDataSource control is set to the name of a custom site map provider, and the TreeView binds to the corresponding site map data.

<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="form1" runat="server">
            <asp:SiteMapDataSource
                id="SiteMapDataSource1"
                runat="server"
                SiteMapProvider="AsciiTextProvider" />

            <asp:TreeView
                id="TreeView1"
                runat="server"
                DataSourceID="SiteMapDataSource1">
            </asp:TreeView>

        </form>
    </body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="form1" runat="server">
            <asp:SiteMapDataSource
                id="SiteMapDataSource1"
                runat="server"
                SiteMapProvider="AsciiTextProvider" />

            <asp:TreeView
                id="TreeView1"
                runat="server"
                DataSourceID="SiteMapDataSource1">
            </asp:TreeView>

        </form>
    </body>
</html>

Commenti

Il valore della SiteMapProvider proprietà viene archiviato nello stato di visualizzazione.The value of the SiteMapProvider property is stored in view state.

Si applica a

Vedi anche