Condividi tramite


SiteMapNode.GetExplicitResourceString(String, String, Boolean) Metodo

Definizione

Recupera una stringa localizzata in base a un attributo SiteMapNode da localizzare, una stringa predefinita da restituire se non è disponibile alcuna risorsa e un valore booleano che indica se generare un'eccezione nel caso in cui non venga rilevata alcuna risorsa.

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

Parametri

attributeName
String

Attributo SiteMapNode da localizzare.

defaultValue
String

Valore predefinito da restituire se non viene trovata nessuna risorsa corrispondente.

throwIfNotFound
Boolean

true per generare un'eccezione InvalidOperationException se una risorsa è esplicitamente definita per il parametro attributeName, se il parametro defaultValue è null e se non è disponibile alcun valore localizzato; in caso contrario, false.

Restituisce

String

Stringa che rappresenta l'attributo localizzato.

Eccezioni

attributeName è null.

Non è stato trovato alcun oggetto risorsa corrispondente e l'elemento throwIfNotFound è true.

Commenti

Il GetExplicitResourceString metodo viene richiamato nella get funzione di accesso della Title proprietà, della Description proprietà e degli attributi personalizzati definiti nella Attributes proprietà. L'oggetto SiteMapProvider in base al quale viene SiteMapNode monitorato deve avere la relativa EnableLocalization proprietà impostata su true per il GetExplicitResourceString metodo per restituire una stringa localizzata. Se l'oggetto EnableLocalization è impostato su false, la localizzazione non viene eseguita e il GetExplicitResourceString metodo non viene mai chiamato.

La Title proprietà, la Description proprietà e tutti gli attributi personalizzati definiti nella Attributes proprietà richiamano prima il GetImplicitResourceString metodo. Se restituisce null, il GetExplicitResourceString metodo viene richiamato con defaultValue impostato sul valore predefinito dell'espressione di risorsa esplicita (presupponendo che sia stato definito) e throwIfNotFound impostato su true.

Nota

La XmlSiteMapProvider classe impone la restrizione che l'oggetto SiteMapNode non può definire sia espressioni di risorsa implicite che espressioni di risorse esplicite per gli attributi. Tuttavia, un'implementazione del provider personalizzato può scegliere di consentire entrambi.

Il GetExplicitResourceString metodo usa la raccolta di chiavi di risorsa con cui l'oggetto NameValueCollection SiteMapNode è stato inizializzato. Se non è stata specificata una raccolta di chiavi di risorsa, restituisce GetExplicitResourceString null.

Si applica a

Vedi anche