SiteMapNode Konstruktoren

Definition

Initialisiert eine neue Instanz der SiteMapNode-Klasse, und ordnet sie dem angegebenen SiteMapProvider-Objekt zu.Initializes a new instance of the SiteMapNode class and associates it with the specified SiteMapProvider object.

Überlädt

SiteMapNode(SiteMapProvider, String)

Initialisiert eine neue Instanz der SiteMapNode-Klasse, wobei mit dem angegebenen key die vom Knoten dargestellte Seite sowie der den Knoten verwaltende Siteübersichtsanbieter angegeben werden.Initializes a new instance of the SiteMapNode class, using the specified key to identify the page that the node represents and the site map provider that manages the node.

SiteMapNode(SiteMapProvider, String, String)

Initialisiert eine neue Instanz der SiteMapNode-Klasse mithilfe der angegebenen URL, eines key zum Angeben der Seite, die vom Knoten dargestellt wird, sowie des Siteübersichtsanbieters, der den Knoten verwaltet.Initializes a new instance of the SiteMapNode class using the specified URL, a key to identify the page that the node represents, and the site map provider that manages the node.

SiteMapNode(SiteMapProvider, String, String, String)

Initialisiert eine neue Instanz der SiteMapNode-Klasse mithilfe der angegebenen URL, eines key zum Angeben der Seite, die vom Knoten dargestellt wird, eines Titels und des Siteübersichtsanbieters, der den Knoten verwaltet.Initializes a new instance of the SiteMapNode class using the specified URL, a key to identify the page that the node represents, a title, and the site map provider that manages the node.

SiteMapNode(SiteMapProvider, String, String, String, String)

Initialisiert eine neue Instanz der SiteMapNode-Klasse mithilfe der angegebenen URL, eines key zum Angeben der Seite, die vom Knoten dargestellt wird, eines Titels und einer Beschreibung sowie des Siteübersichtsanbieters, der den Knoten verwaltet.Initializes a new instance of the SiteMapNode class using the specified URL, a key to identify the page that the node represents, a title and description, and the site map provider that manages the node.

SiteMapNode(SiteMapProvider, String, String, String, String, IList, NameValueCollection, NameValueCollection, String)

Initialisiert eine neue Instanz der SiteMapNode Klasse mithilfe des angegebenen Siteübersichtsanbieters, der den Knoten, die URL, den Titel, die Beschreibung, die Rolle, die zusätzlichen Attribute sowie die expliziten und impliziten Ressourcenschlüssel für die Lokalisierung verwaltet.Initializes a new instance of the SiteMapNode class using the specified site map provider that manages the node, URL, title, description, roles, additional attributes, and explicit and implicit resource keys for localization.

SiteMapNode(SiteMapProvider, String)

Initialisiert eine neue Instanz der SiteMapNode-Klasse, wobei mit dem angegebenen key die vom Knoten dargestellte Seite sowie der den Knoten verwaltende Siteübersichtsanbieter angegeben werden.Initializes a new instance of the SiteMapNode class, using the specified key to identify the page that the node represents and the site map provider that manages the node.

public:
 SiteMapNode(System::Web::SiteMapProvider ^ provider, System::String ^ key);
public SiteMapNode (System.Web.SiteMapProvider provider, string key);
new System.Web.SiteMapNode : System.Web.SiteMapProvider * string -> System.Web.SiteMapNode
Public Sub New (provider As SiteMapProvider, key As String)

Parameter

provider
SiteMapProvider

Der SiteMapProvider, dem der Knoten zugeordnet ist.The SiteMapProvider with which the node is associated.

key
String

Ein anbieterspezifischer Suchschlüssel.A provider-specific lookup key.

Ausnahmen

SiteMapProvider ist null.SiteMapProvider is null.

- oder --or- key ist null.key is null.

Hinweise

Bei XmlSiteMapProvider der-Klasse, bei der SiteMapProvider es sich um die Standard Implementierung des SiteMapNode.Url Anbieters für ASP.net handelt, wird die-Eigenschaft als Suchschlüssel verwendet. Wenn eine-Klasse für den Knoten bereitgestellt wird, wird für den Knoten eine nach Verfolgungs-ID generiert.The XmlSiteMapProvider class, which is the default SiteMapProvider provider implementation for ASP.NET, uses the SiteMapNode.Url property as a lookup key, if one is provided for the node (if a URL is not provided, a tracking identifier is generated for the node). Daher XmlSiteMapProvider muss jedes SiteMapNode Steuerelement, das eine URL bereitstellt und von verwendet wird, über eine eindeutige URL im Gültigkeitsbereich des Anbieters verfügen.Therefore, any SiteMapNode control that provides a URL and is used by the XmlSiteMapProvider must have a unique URL within the scope of the provider.

SiteMapNode(SiteMapProvider, String, String)

Initialisiert eine neue Instanz der SiteMapNode-Klasse mithilfe der angegebenen URL, eines key zum Angeben der Seite, die vom Knoten dargestellt wird, sowie des Siteübersichtsanbieters, der den Knoten verwaltet.Initializes a new instance of the SiteMapNode class using the specified URL, a key to identify the page that the node represents, and the site map provider that manages the node.

public:
 SiteMapNode(System::Web::SiteMapProvider ^ provider, System::String ^ key, System::String ^ url);
public SiteMapNode (System.Web.SiteMapProvider provider, string key, string url);
new System.Web.SiteMapNode : System.Web.SiteMapProvider * string * string -> System.Web.SiteMapNode
Public Sub New (provider As SiteMapProvider, key As String, url As String)

Parameter

provider
SiteMapProvider

Der SiteMapProvider, dem der Knoten zugeordnet ist.The SiteMapProvider with which the node is associated.

key
String

Ein anbieterspezifischer Suchschlüssel.A provider-specific lookup key.

url
String

Die URL der Seite, die der Knoten innerhalb der Site darstellt.The URL of the page that the node represents within the site.

Ausnahmen

SiteMapProvider ist null.SiteMapProvider is null.

- oder --or- key ist null.key is null.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie der SiteMapNodeCollection -Konstruktor verwendet wird, SiteMapNodeCollection um eine neue Auflistung zu erstellen, und anschließend mithilfe Add der-Methode Elemente hinzuzufügen.The following code example demonstrates how to use the SiteMapNodeCollection constructor to create a new SiteMapNodeCollection collection, and then add elements to it with the Add method.

// The LoadSiteMapData() method loads site navigation
// data from persistent storage into a DataTable.
DataTable siteMap = LoadSiteMapData();

// Create a SiteMapNodeCollection.
SiteMapNodeCollection nodes = new SiteMapNodeCollection();

// Create a SiteMapNode and add it to the collection.
SiteMapNode tempNode;
DataRow row;
int index = 0;

while (index < siteMap.Rows.Count)
{

    row = siteMap.Rows[index];

    // Create a node based on the data in the DataRow.
    tempNode = new SiteMapNode(SiteMap.Provider,
                                row["Key"].ToString(),
                                row["Url"].ToString());

    // Add the node to the collection.
    nodes.Add(tempNode);
    ++index;
}
' The LoadSiteMapData() Function loads site navigation
' data from persistent storage into a DataTable.

Dim siteMapData As DataTable
siteMapData = LoadSiteMapData()

' Create a SiteMapNodeCollection.
Dim nodes As New SiteMapNodeCollection()

' Create a SiteMapNode and add it to the collection.
Dim tempNode As SiteMapNode
Dim row As DataRow
Dim index As Integer
index = 0

While (index < siteMapData.Rows.Count)

    row = siteMapData.Rows(index)

    ' Create a node based on the data in the DataRow.
    tempNode = New SiteMapNode(SiteMap.Provider, row("Key").ToString(), row("Url").ToString())

    ' Add the node to the collection.
    nodes.Add(tempNode)
    index = index + 1
End While

Hinweise

Bei XmlSiteMapProvider der-Klasse, bei der SiteMapProvider es sich um die Standard Implementierung des SiteMapNode.Url Anbieters für ASP.net handelt, wird die-Eigenschaft als Suchschlüssel verwendet. Wenn eine-Klasse für den Knoten bereitgestellt wird, wird für den Knoten eine nach Verfolgungs-ID generiert.The XmlSiteMapProvider class, which is the default SiteMapProvider provider implementation for ASP.NET, uses the SiteMapNode.Url property as a lookup key, if one is provided for the node (if a URL is not provided, a tracking identifier is generated for the node). Daher XmlSiteMapProvider muss jedes SiteMapNode Objekt, das eine URL bereitstellt und von verwendet wird, über eine eindeutige URL im Gültigkeitsbereich des Anbieters verfügen.Therefore, any SiteMapNode object that provides a URL and is used by the XmlSiteMapProvider must have a unique URL within the scope of the provider.

SiteMapNode(SiteMapProvider, String, String, String)

Initialisiert eine neue Instanz der SiteMapNode-Klasse mithilfe der angegebenen URL, eines key zum Angeben der Seite, die vom Knoten dargestellt wird, eines Titels und des Siteübersichtsanbieters, der den Knoten verwaltet.Initializes a new instance of the SiteMapNode class using the specified URL, a key to identify the page that the node represents, a title, and the site map provider that manages the node.

public:
 SiteMapNode(System::Web::SiteMapProvider ^ provider, System::String ^ key, System::String ^ url, System::String ^ title);
public SiteMapNode (System.Web.SiteMapProvider provider, string key, string url, string title);
new System.Web.SiteMapNode : System.Web.SiteMapProvider * string * string * string -> System.Web.SiteMapNode
Public Sub New (provider As SiteMapProvider, key As String, url As String, title As String)

Parameter

provider
SiteMapProvider

Der SiteMapProvider, dem der Knoten zugeordnet ist.The SiteMapProvider with which the node is associated.

key
String

Ein anbieterspezifischer Suchschlüssel.A provider-specific lookup key.

url
String

Die URL der Seite, die der Knoten innerhalb der Site darstellt.The URL of the page that the node represents within the site.

title
String

Eine Bezeichnung für den Knoten, die häufig durch Navigationssteuerelemente angezeigt wird.A label for the node, often displayed by navigation controls.

Ausnahmen

SiteMapProvider ist null.SiteMapProvider is null.

- oder --or- key ist null.key is null.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie der SiteMapNode -Konstruktor verwendet wird, um eine neue SiteMapNode Instanz der-Klasse zu erstellen.The following code example demonstrates how to use the SiteMapNode constructor to create a new instance of the SiteMapNode class. Der Knoten wird mit Werten aus einer Zeile der Microsoft Access-Datenbank initialisiert.The node is initialized with values from a Microsoft Access database row.

Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die BuildSiteMap -Methode bereitgestellt wird.This code example is part of a larger example provided for the BuildSiteMap method.

OleDbCommand^ rootNodeCommand = gcnew OleDbCommand
   ("SELECT nodeid, url, name FROM SiteMap WHERE parentnodeid IS NULL", accessConnection);
OleDbDataReader^ rootNodeReader = rootNodeCommand->ExecuteReader();
if ( rootNodeReader->HasRows )
{
   rootNodeReader->Read();
   rootNodeId = rootNodeReader->GetInt32( 0 );
   
   // Create a SiteMapNode that references the current StaticSiteMapProvider.
   rootNode = gcnew SiteMapNode(this, rootNodeId.ToString(), 
      rootNodeReader->GetString( 1 ),rootNodeReader->GetString( 2 ));
}
else
   return nullptr;
rootNodeReader->Close();

OleDbCommand rootNodeCommand =
    new OleDbCommand("SELECT nodeid, url, name FROM SiteMap WHERE parentnodeid IS NULL",
                     accessConnection);
OleDbDataReader rootNodeReader = rootNodeCommand.ExecuteReader();

if(rootNodeReader.HasRows) {
    rootNodeReader.Read();
    rootNodeId = rootNodeReader.GetInt32(0);
    // Create a SiteMapNode that references the current StaticSiteMapProvider.
    rootNode   = new SiteMapNode(this,
                                 rootNodeId.ToString(),
                                 rootNodeReader.GetString(1),
                                 rootNodeReader.GetString(2));

}
else return null;

rootNodeReader.Close();
Dim rootNodeCommand As New OleDbCommand("SELECT nodeid, url, name FROM SiteMap WHERE parentnodeid IS NULL", accessConnection)
Dim rootNodeReader As OleDbDataReader = rootNodeCommand.ExecuteReader()

If rootNodeReader.HasRows Then
    rootNodeReader.Read()
    rootNodeId = rootNodeReader.GetInt32(0)
    ' Create a SiteMapNode that references the current StaticSiteMapProvider.
    aRootNode = New SiteMapNode(Me, rootNodeId.ToString(), rootNodeReader.GetString(1), rootNodeReader.GetString(2))
Else
    Return Nothing
End If
rootNodeReader.Close()

Hinweise

Bei XmlSiteMapProvider der-Klasse, bei der SiteMapProvider es sich um die Standard Implementierung des SiteMapNode.Url Anbieters für ASP.net handelt, wird die-Eigenschaft als Suchschlüssel verwendet. Wenn eine-Klasse für den Knoten bereitgestellt wird, wird für den Knoten eine nach Verfolgungs-ID generiert.The XmlSiteMapProvider class, which is the default SiteMapProvider provider implementation for ASP.NET, uses the SiteMapNode.Url property as a lookup key, if one is provided for the node (if a URL is not provided, a tracking identifier is generated for the node). Daher XmlSiteMapProvider muss jedes SiteMapNode Objekt, das eine URL bereitstellt und von verwendet wird, über eine eindeutige URL im Gültigkeitsbereich des Anbieters verfügen.Therefore, any SiteMapNode object that provides a URL and is used by the XmlSiteMapProvider must have a unique URL within the scope of the provider.

Wenn kein title angegeben wird, geben Aufrufe Title der-Eigenschaft das String.Empty -Feld zurück.If no title is provided, calls to the Title property return the String.Empty field.

SiteMapNode(SiteMapProvider, String, String, String, String)

Initialisiert eine neue Instanz der SiteMapNode-Klasse mithilfe der angegebenen URL, eines key zum Angeben der Seite, die vom Knoten dargestellt wird, eines Titels und einer Beschreibung sowie des Siteübersichtsanbieters, der den Knoten verwaltet.Initializes a new instance of the SiteMapNode class using the specified URL, a key to identify the page that the node represents, a title and description, and the site map provider that manages the node.

public:
 SiteMapNode(System::Web::SiteMapProvider ^ provider, System::String ^ key, System::String ^ url, System::String ^ title, System::String ^ description);
public SiteMapNode (System.Web.SiteMapProvider provider, string key, string url, string title, string description);
new System.Web.SiteMapNode : System.Web.SiteMapProvider * string * string * string * string -> System.Web.SiteMapNode
Public Sub New (provider As SiteMapProvider, key As String, url As String, title As String, description As String)

Parameter

provider
SiteMapProvider

Der SiteMapProvider, dem der Knoten zugeordnet ist.The SiteMapProvider with which the node is associated.

key
String

Ein anbieterspezifischer Suchschlüssel.A provider-specific lookup key.

url
String

Die URL der Seite, die der Knoten innerhalb der Site darstellt.The URL of the page that the node represents within the site.

title
String

Eine Bezeichnung für den Knoten, die häufig durch Navigationssteuerelemente angezeigt wird.A label for the node, often displayed by navigation controls.

description
String

Eine Beschreibung der Seite, die vom Knoten dargestellt wird.A description of the page that the node represents.

Ausnahmen

SiteMapProvider ist null.SiteMapProvider is null.

- oder --or- key ist null.key is null.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie SiteMapNode den-Konstruktor verwenden SiteMapNode , um ein-Objekt zu erstellen, indem Sie Daten aus einer einfachen Textdatei zum Erstellen einer Site Map im Speicher verwenden.The following code example demonstrates how to use the SiteMapNode constructor to create a SiteMapNode object by parsing data from a simple text file to build a site map in memory.

Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die abstrakte SiteMapProvider -Klasse bereitgestellt wird.This code example is part of a larger example provided for the abstract SiteMapProvider class.

protected virtual void LoadSiteMapFromStore()
{
  string pathToOpen;

  lock (this)
  {
    // If a root node exists, LoadSiteMapFromStore has already
    // been called, and the method can return.
    if (rootNode != null)
    {
      return;
    }
    else
    {
      pathToOpen = HttpContext.Current.Server.MapPath("~" + "\\" + sourceFilename);

      if (File.Exists(pathToOpen))
      {
        // Open the file to read from.
        using (StreamReader sr = File.OpenText(pathToOpen))
        {

          // Clear the state of the collections and rootNode
          rootNode = null;
          siteMapNodes.Clear();
          childParentRelationship.Clear();

          // Parse the file and build the site map
          string s = "";
          string[] nodeValues = null;
          SiteMapNode temp = null;

          while ((s = sr.ReadLine()) != null)
          {

            // Build the various SiteMapNode objects and add
            // them to the ArrayList collections. The format used
            // is: URL,TITLE,DESCRIPTION,PARENTURL

            nodeValues = s.Split(',');

            temp = new SiteMapNode(this,
                HttpRuntime.AppDomainAppVirtualPath + "/" + nodeValues[0],
                HttpRuntime.AppDomainAppVirtualPath + "/" + nodeValues[0],
                nodeValues[1],
                nodeValues[2]);

            // Is this a root node yet?
            if (null == rootNode &&
                string.IsNullOrEmpty(nodeValues[3]))
            {
              rootNode = temp;
            }

          // If not the root node, add the node to the various collections.
            else
            {
              siteMapNodes.Add(new DictionaryEntry(temp.Url, temp));
              // The parent node has already been added to the collection.
              SiteMapNode parentNode =
                       FindSiteMapNode(HttpRuntime.AppDomainAppVirtualPath + "/" + nodeValues[3]);
              if (parentNode != null)
              {
                childParentRelationship.Add(new DictionaryEntry(temp.Url, parentNode));
              }
              else
              {
                throw new Exception("Parent node not found for current node.");
              }
            }
          }
        }
      }
      else
      {
        throw new Exception("File not found");
      }
    }
  }
  return;
}
  Protected Overridable Sub LoadSiteMapFromStore()
    Dim pathToOpen As String
    SyncLock Me
      ' If a root node exists, LoadSiteMapFromStore has already
      ' been called, and the method can return.
      If Not (aRootNode Is Nothing) Then
        Return
      Else
        pathToOpen = HttpContext.Current.Server.MapPath("~" & "\\" & sourceFilename)
        If File.Exists(pathToOpen) Then
          ' Open the file to read from.
          Dim sr As StreamReader = File.OpenText(pathToOpen)
          Try

            ' Clear the state of the collections and aRootNode
            aRootNode = Nothing
            siteMapNodes.Clear()
            childParentRelationship.Clear()

            ' Parse the file and build the site map
            Dim s As String = ""
            Dim nodeValues As String() = Nothing
            Dim temp As SiteMapNode = Nothing

            Do
              s = sr.ReadLine()

              If Not s Is Nothing Then
                ' Build the various SiteMapNode objects and add
                ' them to the ArrayList collections. The format used
                ' is: URL,TITLE,DESCRIPTION,PARENTURL
                nodeValues = s.Split(","c)

                temp = New SiteMapNode(Me, _
                    HttpRuntime.AppDomainAppVirtualPath & "/" & nodeValues(0), _
                    HttpRuntime.AppDomainAppVirtualPath & "/" & nodeValues(0), _
                    nodeValues(1), _
                    nodeValues(2))

                ' Is this a root node yet?
                If aRootNode Is Nothing AndAlso _
                  (nodeValues(3) Is Nothing OrElse _
                   nodeValues(3) = String.Empty) Then
                  aRootNode = temp

                  ' If not the root node, add the node to the various collections.
                Else

                  siteMapNodes.Add(New DictionaryEntry(temp.Url, temp))

                  ' The parent node has already been added to the collection.
                  Dim parentNode As SiteMapNode = _
                      FindSiteMapNode(HttpRuntime.AppDomainAppVirtualPath & "/" & nodeValues(3))

                  If Not (parentNode Is Nothing) Then
                    childParentRelationship.Add(New DictionaryEntry(temp.Url, parentNode))
                  Else
                    Throw New Exception("Parent node not found for current node.")
                  End If
                End If
              End If
            Loop Until s Is Nothing
          Finally
            sr.Close()
          End Try
        Else
          Throw New Exception("File not found")
        End If
      End If
    End SyncLock
    Return
  End Sub
End Class

Hinweise

Bei XmlSiteMapProvider der-Klasse, bei der SiteMapProvider es sich um die Standard Implementierung des SiteMapNode.Url Anbieters für ASP.net handelt, wird die-Eigenschaft als Suchschlüssel verwendet. Wenn eine-Klasse für den Knoten bereitgestellt wird, wird für den Knoten eine nach Verfolgungs-ID generiert.The XmlSiteMapProvider class, which is the default SiteMapProvider provider implementation for ASP.NET, uses the SiteMapNode.Url property as a lookup key, if one is provided for the node (if a URL is not provided, a tracking identifier is generated for the node). Daher XmlSiteMapProvider muss jedes SiteMapNode Objekt, das eine URL bereitstellt und von verwendet wird, über eine eindeutige URL im Gültigkeitsbereich des Anbieters verfügen.Therefore, any SiteMapNode object that provides a URL and is used by the XmlSiteMapProvider must have a unique URL within the scope of the provider.

Wenn weder title noch description angegeben wird, geben Aufrufe der Title - Description Eigenschaft oder der String.Empty -Eigenschaft ein-Feld zurück.If no title or description is provided, calls to the Title or Description properties return an String.Empty field.

Siehe auch

SiteMapNode(SiteMapProvider, String, String, String, String, IList, NameValueCollection, NameValueCollection, String)

Initialisiert eine neue Instanz der SiteMapNode Klasse mithilfe des angegebenen Siteübersichtsanbieters, der den Knoten, die URL, den Titel, die Beschreibung, die Rolle, die zusätzlichen Attribute sowie die expliziten und impliziten Ressourcenschlüssel für die Lokalisierung verwaltet.Initializes a new instance of the SiteMapNode class using the specified site map provider that manages the node, URL, title, description, roles, additional attributes, and explicit and implicit resource keys for localization.

public:
 SiteMapNode(System::Web::SiteMapProvider ^ provider, System::String ^ key, System::String ^ url, System::String ^ title, System::String ^ description, System::Collections::IList ^ roles, System::Collections::Specialized::NameValueCollection ^ attributes, System::Collections::Specialized::NameValueCollection ^ explicitResourceKeys, System::String ^ implicitResourceKey);
public SiteMapNode (System.Web.SiteMapProvider provider, string key, string url, string title, string description, System.Collections.IList roles, System.Collections.Specialized.NameValueCollection attributes, System.Collections.Specialized.NameValueCollection explicitResourceKeys, string implicitResourceKey);
new System.Web.SiteMapNode : System.Web.SiteMapProvider * string * string * string * string * System.Collections.IList * System.Collections.Specialized.NameValueCollection * System.Collections.Specialized.NameValueCollection * string -> System.Web.SiteMapNode
Public Sub New (provider As SiteMapProvider, key As String, url As String, title As String, description As String, roles As IList, attributes As NameValueCollection, explicitResourceKeys As NameValueCollection, implicitResourceKey As String)

Parameter

provider
SiteMapProvider

Der SiteMapProvider, dem der Knoten zugeordnet ist.The SiteMapProvider with which the node is associated.

key
String

Ein anbieterspezifischer Suchschlüssel.A provider-specific lookup key.

url
String

Die URL der Seite, die der Knoten innerhalb der Site darstellt.The URL of the page that the node represents within the site.

title
String

Eine Bezeichnung für den Knoten, die häufig durch Navigationssteuerelemente angezeigt wird.A label for the node, often displayed by navigation controls.

description
String

Eine Beschreibung der Seite, die vom Knoten dargestellt wird.A description of the page that the node represents.

roles
IList

Eine IList von Rollen, für die die Anzeige der Seite zulässig ist, die vom SiteMapNode dargestellt wird.An IList of roles that are allowed to view the page represented by the SiteMapNode.

attributes
NameValueCollection

Eine NameValueCollection von zusätzlichen Attributen, mit denen der SiteMapNode initialisier wird.A NameValueCollection of additional attributes used to initialize the SiteMapNode.

explicitResourceKeys
NameValueCollection

Eine NameValueCollection von expliziten Ressourcenschlüsseln, die für die Lokalisierung verwendet werden.A NameValueCollection of explicit resource keys used for localization.

implicitResourceKey
String

Ein impliziter Ressourcenschlüssel, der für die Lokalisierung verwendet wird.An implicit resource key used for localization.

Ausnahmen

SiteMapProvider ist null.SiteMapProvider is null.

- oder --or- key ist null.key is null.

Hinweise

Bei XmlSiteMapProvider der-Klasse, bei der SiteMapProvider es sich um die Standard Implementierung des SiteMapNode.Url Anbieters für ASP.net handelt, wird die-Eigenschaft als Suchschlüssel verwendet. Wenn eine-Klasse für den Knoten bereitgestellt wird, wird für den Knoten eine nach Verfolgungs-ID generiert.The XmlSiteMapProvider class, which is the default SiteMapProvider provider implementation for ASP.NET, uses the SiteMapNode.Url property as a lookup key, if one is provided for the node (if a URL is not provided, a tracking identifier is generated for the node). Daher XmlSiteMapProvider muss jedes SiteMapNode Objekt, das eine URL bereitstellt und von verwendet wird, über eine eindeutige URL im Gültigkeitsbereich des Anbieters verfügen.Therefore, any SiteMapNode object that provides a URL and is used by the XmlSiteMapProvider must have a unique URL within the scope of the provider.

Die NameValueCollection Auflistung von Attributen, mit SiteMapNode der der erstellt wird, ist über Attributes die-Eigenschaft verfügbar und erleichtert das Anwenden zusätzlicher Attribute auf einen Site Übersichts Knoten und das Erweitern der Funktionen, ohne eine benutzerdefinierte Klasse zu ableiten. gehen Sie so vor.The NameValueCollection collection of attributes that the SiteMapNode is created with is available through the Attributes property, and makes it easy to apply additional attributes to a site map node and extend its capabilities without deriving a custom class to do so.

Stellen Sie IList eine Auflistung von Rollen bereit, um einen Satz von Rollen bereitzustellen, die den SecurityTrimmingEnabled Knoten anzeigen truekönnen, wenn die-Eigenschaft zurückgibt.Supply an IList collection of roles to provide a set of roles that can view the node when the SecurityTrimmingEnabled property returns true. Weitere Informationen finden Sie unter SecurityTrimmingEnabled.For more information, see SecurityTrimmingEnabled.

Der XmlSiteMapProvider Anbieter verwendet die SiteMapNode.Url -Eigenschaft als Suchschlüssel.The XmlSiteMapProvider provider uses the SiteMapNode.Url property as a lookup key. Daher muss jeder SiteMapNode , der XmlSiteMapProvider von verwendet wird, innerhalb des Bereichs des Anbieters über eine eindeutige URL verfügen.Therefore, any SiteMapNode that is used by the XmlSiteMapProvider must have a unique URL within the scope of the provider.

Wenn weder title noch description angegeben wird, geben Aufrufe der Title - Description Eigenschaft oder der String.Empty -Eigenschaft ein-Feld zurück.If no title or description is provided, calls to the Title or Description properties return an String.Empty field.

Legen Sie zum programmgesteuerten Angeben von Ressourcen für die Lokalisierung entweder den implicitResourceKey Wert von auf einen eindeutigen Namen fest, mit dem lokalisierte Ressourcen für den Knoten identifiziert werden, NameValueCollection oder legen name/value Sie eine Auflistung von Paaren fest explicitResourceKeys , in denen name die Knoten Eigenschaft oder das benutzerdefinierte Attribut, das lokalisiert value werden soll und Lokalisierungs Werte für die Knoten Eigenschaft oder das benutzerdefinierte Attribut enthält.To programmatically specify resources for localization, either set the value of implicitResourceKey to a unique name that will be used to identify localized resources for the node or set explicitResourceKeys to a NameValueCollection collection of name/value pairs where name is the node property or custom attribute to localize and value contains localization values for the node property or custom attribute. Die lokalisierten Werte können dann in den entsprechenden RESX-Dateien festgelegt werden.The localized values can then be set in the appropriate .resx files. Weitere TitleInformationen zum Lokalisieren von, Descriptionund benutzerdefinierten Eigenschaften eines SiteMapNode -Objekts finden Sie unter Gewusst wie: Lokalisieren von Site Map-Daten.For more information about how to localize the Title, Description, and any custom properties of a SiteMapNode object, see How to: Localize Site-Map Data. Die Syntax Anforderungen der explicitResourceKeys Auflistung finden NameValueCollectionSie unter.For the syntax requirements of the explicitResourceKeys collection, see NameValueCollection.

Siehe auch

Gilt für: