SiteMapProviderCollection Classe

Definição

Espaço de Nomes:
System.Web
Assemblagem:
System.Web.dll

Usado pela SiteMap classe para acompanhar o conjunto de SiteMapProvider objetos disponíveis durante SiteMap a inicialização do mapa do site. Esta classe não pode ser herdada.

public ref class SiteMapProviderCollection sealed : System::Configuration::Provider::ProviderCollection
public sealed class SiteMapProviderCollection : System.Configuration.Provider.ProviderCollection
type SiteMapProviderCollection = class
    inherit ProviderCollection
Public NotInheritable Class SiteMapProviderCollection
Inherits ProviderCollection
Herança
Object
ProviderCollection
SiteMapProviderCollection

Exemplos

O exemplo de código seguinte demonstra como recuperar o SiteMapProviderCollection objeto do SiteMap objeto e iterar através dele.

Se tiver mais do que apenas o fornecedor padrão configurado para o seu site, verá cada fornecedor que aparece na lista. Por exemplo, se estiver a usar a amostra AccessSiteMapProvider encontrada na SiteMapProvider visão geral da classe, verá o seguinte resultado.

XmlSiteMapProvider   System.Web.XmlSiteMapProvider
AccessSiteMapProvider   Samples.AspNet.Controls.AccessSiteMapProvider

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

<SCRIPT runat="server">
private void Page_Load(object sender, System.EventArgs e)
{
    // Navigate the SiteMap built by the default SiteMapProvider.
    Response.Write(SiteMap.RootNode.ToString() + "<BR>");

    Response.Write(SiteMap.RootNode.Url + "<BR>");
    Response.Write(SiteMap.RootNode.Title + "<BR>");

    foreach (SiteMapNode sitemapnode in SiteMap.RootNode.ChildNodes)
    {
        // Iterate through the ChildNodes SiteMapNodesCollection
        // maintained by the RootNode.
        Response.Write(sitemapnode.Url + "<BR>" );
    }

    IEnumerator providers = SiteMap.Providers.GetEnumerator();
    while (providers.MoveNext())
    {
        Response.Write(providers.Current);
        Response.Write("&nbsp;&nbsp;&nbsp;");
        Response.Write("<BR>");
    }
}
</SCRIPT>

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

<SCRIPT runat="server">
Private Sub Page_Load(Sender As Object, E As EventArgs)

    ' Navigate the SiteMap built by the default SiteMapProvider.
    Response.Write(SiteMap.RootNode.ToString() & "<BR>")

    Response.Write(SiteMap.RootNode.Url & "<BR>")
    Response.Write(SiteMap.RootNode.Title & "<BR>")

    Dim sitemapnode As SiteMapNode
    For Each sitemapnode In SiteMap.RootNode.ChildNodes
        ' Iterate through the ChildNodes SiteMapNodesCollection
        ' maintained by the RootNode.
        Response.Write(sitemapnode.Url & "<BR>" )
    Next

    Dim providers As IDictionaryEnumerator = SiteMap.Providers.GetEnumerator()
    While (providers.MoveNext())
        Response.Write(providers.Current)
        Response.Write("&nbsp;&nbsp;&nbsp;")
        Response.Write("<BR>")
    End While
End Sub ' Page_Load

</SCRIPT>

Observações

A SiteMapProviderCollection classe é uma coleção fortemente tipada Hashtable de SiteMapProvider objetos. Além dos dois métodos de adição, Add(ProviderBase) e , a Add(SiteMapProvider) classe suporta o SiteMapProviderCollection método para adicionar um array de tipo AddArraySiteMapProvider.

É SiteMapProviderCollection usado pela SiteMap classe para acompanhar o conjunto de SiteMapProvider objetos disponíveis durante SiteMap a inicialização do mapa do site. No entanto, a presença de a SiteMapProvider na coleção do fornecedor não significa necessariamente que seja usada por um SiteMap objeto, apenas que está disponível para uso.

Quando a SiteMapProvider é armazenado em , SiteMapProviderCollectiona Name propriedade é usada como chave.

Construtores

Name Description
SiteMapProviderCollection()

Inicializa uma nova instância da SiteMapProviderCollection classe.

Propriedades

Name Description
Count

Obtém o número de prestadores na coleção.

(Herdado de ProviderCollection)
IsSynchronized

Recebe um valor que indica se o acesso à coleção está sincronizado (thread safe).

(Herdado de ProviderCollection)
Item[String]

Obtém um SiteMapProvider objeto com um nome específico da coleção do fornecedor.
SyncRoot

Fica com o objeto atual.

(Herdado de ProviderCollection)

Métodos

Name Description
Add(ProviderBase)

Adiciona a SiteMapProvider à coleção do fornecedor usando a Name propriedade como chave.
Add(SiteMapProvider)

Adiciona um SiteMapProvider objeto à coleção do fornecedor usando a Name propriedade como chave.
AddArray(SiteMapProvider[])

Adiciona um array de SiteMapProvider objetos à coleção de fornecedores usando as Name propriedades como chaves.
Clear()

Remove todos os itens da coleção.

(Herdado de ProviderCollection)
CopyTo(ProviderBase[], Int32)

Copia o conteúdo da coleção para o array dado a partir do índice especificado.

(Herdado de ProviderCollection)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetEnumerator()

Devolve um objeto que implementa a IEnumerator interface para iterar pela coleção.

(Herdado de ProviderCollection)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
Remove(String)

Remove um prestador da coleção.

(Herdado de ProviderCollection)
SetReadOnly()

Define a coleção para apenas leitura.

(Herdado de ProviderCollection)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Implementações de Interface Explícita

Name Description
ICollection.CopyTo(Array, Int32)

Copia os elementos de para ProviderCollection um array, começando num índice particular do array.

(Herdado de ProviderCollection)

Métodos da Extensão

Name Description
AsParallel(IEnumerable)

Permite a paralelização de uma consulta.
AsQueryable(IEnumerable)

Converte um IEnumerable para um IQueryable.
Cast<TResult>(IEnumerable)

Conjura os elementos de an IEnumerable para o tipo especificado.
OfType<TResult>(IEnumerable)

Filtra os elementos de um IEnumerable com base num tipo especificado.

Aplica-se a

Ver também