SiteMapNode.GetExplicitResourceString(String, String, Boolean) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 -> stringProtected Function GetExplicitResourceString (attributeName As String, defaultValue As String, throwIfNotFound As Boolean) As StringParametri
- 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
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.