SiteMapNode.GetExplicitResourceString(String, String, Boolean) Metoda

Definice

Obor názvů:

System.Web

Sestavení:

System.Web.dll

Načte lokalizovaný řetězec na základě atributu SiteMapNode , který se má lokalizovat, výchozí řetězec, který se vrátí, pokud není nalezen žádný prostředek, a logickou hodnotu označující, zda se má vyvolat výjimka, pokud není nalezen žádný prostředek.

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

Atribut SiteMapNode , který se má lokalizovat.

defaultValue

String

Výchozí hodnota, která se má vrátit, pokud se nenajde odpovídající prostředek.

throwIfNotFound

Boolean

truek vyvolání InvalidOperationException, pokud je pro attributeNamedefaultValue definovaný explicitní prostředek , je nulla lokalizovaná hodnota se nenašlafalse. V opačném případě .

Návraty

String

Řetězec představující lokalizovaný atribut.

Výjimky

ArgumentNullException

attributeName je null.

InvalidOperationException

Odpovídající objekt prostředku nebyl nalezen a throwIfNotFound je true.

Poznámky

Metoda GetExplicitResourceString je vyvolána v get přístupové objektu Title vlastnosti, Description vlastnosti a všech vlastních atributů, které jsou definovány ve Attributes vlastnosti . Objekt SiteMapProvider , podle kterého SiteMapNode je sledován musí mít jeho EnableLocalization vlastnost nastavena na , trueGetExplicitResourceString aby metoda vrátila lokalizovaný řetězec. Pokud je nastavena EnableLocalization na false, lokalizace se neprovede a GetExplicitResourceString metoda se nikdy nevolá.

Vlastnost Title , Description vlastnost a všechny vlastní atributy, které jsou definovány ve Attributes vlastnosti nejprve vyvolat metodu GetImplicitResourceString . Pokud vrátí null, GetExplicitResourceString vyvolá se metoda s defaultValue nastavenou na hodnotu výchozí hodnoty z výrazu explicitního prostředku (za předpokladu, že je definovaný) a throwIfNotFound nastavená na true.

Poznámka

Třída XmlSiteMapProvider zavádí omezení, že SiteMapNode objekt nemůže definovat implicitní výrazy prostředků i explicitní výrazy prostředků pro atributy. Vlastní implementace zprostředkovatele však může povolit obojí.

Metoda GetExplicitResourceString používá kolekci NameValueCollection klíčů prostředků, se kterými SiteMapNode byl objekt inicializován. Pokud nebyla zadána kolekce klíčů prostředků, GetExplicitResourceString vrátí příkaz null.

Viz také

• EnableLocalization
• GetImplicitResourceString(String)