SiteMapNode.GetExplicitResourceString(String, String, Boolean) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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 -> stringProtected Function GetExplicitResourceString (attributeName As String, defaultValue As String, throwIfNotFound As Boolean) As StringParametry
- 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.
