SiteMapNode.GetExplicitResourceString(String, String, Boolean) Metoda

Definice

Obor názvů:

System.Web

Sestavení:

System.Web.dll

Načte lokalizovaný řetězec založený na atributu SiteMapNode pro lokalizaci, výchozí řetězec, který se vrátí, pokud se nenajde žádný prostředek, a logická hodnota označující, zda se má vyvolat výjimka, pokud se nenajde žá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 pro lokalizaci.

defaultValue

String

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

throwIfNotFound

Boolean

true vyvolání InvalidOperationException, pokud je definován explicitní prostředek pro attributeName, defaultValue je nulla lokalizovaná hodnota nebyla nalezena; falsev 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říslušenství Title vlastnosti, Description vlastnost a všechny vlastní atributy, které jsou definovány ve Attributes vlastnosti. Objekt SiteMapProvider , podle kterého SiteMapNode je sledován, musí mít jeho EnableLocalization vlastnost nastavena na true metodu GetExplicitResourceString vrátit lokalizovaný řetězec. Pokud je nastavena EnableLocalization na false, lokalizace se neprovádí 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 metoda je vyvolána s nastavenou defaultValue na hodnotu výchozí hodnoty z explicitního výrazu prostředku (za předpokladu, že byla definována) a throwIfNotFound nastavena na true.

Poznámka:

Třída XmlSiteMapProvider omezuje, že SiteMapNode objekt nemůže definovat implicitní výrazy prostředků i explicitní výrazy prostředků pro atributy. Vlastní implementace zprostředkovatele se ale může rozhodnout, že obě možnosti povolí.

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í se hodnota null.

Viz také

• EnableLocalization
• GetImplicitResourceString(String)