SiteMapDataSource.SiteMapProvider Property

Definition

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

Property Value

String

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.

Examples

Nell'esempio di codice seguente viene illustrato come associare in modo dichiarativo un controllo TreeView ai dati della mappa del sito forniti da un oggetto SiteMapProvider 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 oggetto SiteMapProvider personalizzato per il controllo SiteMapDataSource: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 classe SimpleTextSiteMapProvider cui fa riferimento questo esempio di file Web. config si trova nella panoramica della classe SiteMapProvider.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. txt" nella panoramica della classe SiteMapProvider.You can also find sample content for the "text.txt" site map file in the SiteMapProvider class overview.

Note

Il AsciiTextProvider non è il provider predefinito per il sito, che in questo caso rimane l'oggetto XmlSiteMapProvider.The AsciiTextProvider is not the default provider for the site, which (in this case) remains the XmlSiteMapProvider object. La proprietà SiteMapProvider del controllo SiteMapDataSource è impostata sul nome di un provider della mappa del sito personalizzato e il TreeView viene associato ai dati corrispondenti della mappa del sito.The 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>

Remarks

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

Applies to

See also