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 SiteMapNode attributo per localizzare, una stringa predefinita da restituire se non viene trovata alcuna risorsa e un valore booleano che indica se generare un'eccezione se non viene trovata 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 una risorsa corrispondente.
- throwIfNotFound
- Boolean
true per generare un InvalidOperationExceptionoggetto , se viene definita una risorsa esplicita per attributeName, defaultValue è nulle non viene trovato un valore localizzato; in caso contrario, false.
Restituisce
Stringa che rappresenta l'attributo localizzato.
Eccezioni
attributeName è null.
Non è stato trovato un oggetto risorsa corrispondente e 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 rilevato deve SiteMapNode avere la relativa EnableLocalization proprietà impostata su true affinché il GetExplicitResourceString metodo restituisca una stringa localizzata.
EnableLocalization Se è 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 innanzitutto il GetImplicitResourceString metodo . Se restituisce null, il GetExplicitResourceString metodo viene richiamato con defaultValue impostato sul valore del valore predefinito dell'espressione di risorsa esplicita (presupponendo che ne sia stato definito uno) e throwIfNotFound impostato su true.
Annotazioni
La XmlSiteMapProvider classe impone la restrizione che l'oggetto SiteMapNode non può definire espressioni di risorsa implicite ed espressioni di risorse esplicite per gli attributi. Tuttavia, un'implementazione del provider personalizzato può scegliere di consentire entrambi.
Il GetExplicitResourceString metodo usa la NameValueCollection raccolta di chiavi di risorsa con cui l'oggetto SiteMapNode è stato inizializzato. Se non è stata specificata una raccolta di chiavi di risorsa, restituisce GetExplicitResourceStringnull.
