Udostępnij za pośrednictwem


SiteMapNode.GetExplicitResourceString(String, String, Boolean) Metoda

Definicja

Pobiera zlokalizowany ciąg na SiteMapNode podstawie atrybutu do lokalizowania, ciąg domyślny do zwrócenia, jeśli nie znaleziono zasobu, i wartość logiczna wskazująca, czy zgłosić wyjątek, jeśli nie znaleziono zasobu.

protected:
 System::String ^ GetExplicitResourceString(System::String ^ attributeName, System::String ^ defaultValue, bool throwIfNotFound);
protected string GetExplicitResourceString (string attributeName, string defaultValue, bool throwIfNotFound);
member this.GetExplicitResourceString : string * string * bool -> string
Protected Function GetExplicitResourceString (attributeName As String, defaultValue As String, throwIfNotFound As Boolean) As String

Parametry

attributeName
String

Atrybut SiteMapNode do lokalizowania.

defaultValue
String

Wartość domyślna, która ma być zwracana, jeśli nie znaleziono pasującego zasobu.

throwIfNotFound
Boolean

true w celu zgłoszenia InvalidOperationExceptionwartości , jeśli jawny zasób jest zdefiniowany dla attributeNameelementu , defaultValue to null, a zlokalizowana wartość nie zostanie znaleziona; w przeciwnym razie false.

Zwraca

Ciąg reprezentujący zlokalizowany atrybut.

Wyjątki

attributeName to null.

Nie można odnaleźć pasującego obiektu zasobu i throwIfNotFound ma wartość true.

Uwagi

Metoda GetExplicitResourceString jest wywoływana w get metodzie dostępu Title do właściwości, Description właściwości i wszelkich atrybutów niestandardowych zdefiniowanych we Attributes właściwości . Obiekt SiteMapProvider , za pomocą którego SiteMapNode jest śledzony, musi mieć właściwość EnableLocalization ustawioną na trueGetExplicitResourceString , aby metoda zwróciła zlokalizowany ciąg. EnableLocalization Jeśli parametr ma wartość false, lokalizacja nie jest wykonywana, a metoda nigdy nie jest wywoływanaGetExplicitResourceString.

Właściwość Title , Description właściwość i wszystkie atrybuty niestandardowe zdefiniowane we Attributes właściwości najpierw wywołują metodę GetImplicitResourceString . Jeśli zwraca nullwartość , GetExplicitResourceString metoda jest wywoływana z ustawioną wartością defaultValue domyślną z jawnego wyrażenia zasobu (przy założeniu, że została zdefiniowana) i throwIfNotFound ustawiona na truewartość .

Uwaga

Klasa XmlSiteMapProvider nakłada ograniczenie, którego SiteMapNode obiekt nie może definiować zarówno niejawnych wyrażeń zasobów, jak i jawnych wyrażeń zasobów dla atrybutów. Jednak implementacja dostawcy niestandardowego może wybrać opcję zezwalania na oba te elementy.

Metoda GetExplicitResourceString używa NameValueCollection kolekcji kluczy zasobów, za pomocą których SiteMapNode zainicjowano obiekt. Jeśli nie określono kolekcji kluczy zasobów, GetExplicitResourceString funkcja zwraca wartość null.

Dotyczy

Zobacz też