Partilhar via


SiteMapNode.GetExplicitResourceString(String, String, Boolean) Método

Definição

Recuperará uma cadeia de caracteres localizada com base em um atributo SiteMapNode a ser localizado, uma cadeia de caracteres padrão a ser retornada se nenhum recurso for localizado e um valor booliano que indica se uma exceção será gerada se nenhum recurso for localizado.

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

Parâmetros

attributeName
String

O atributo SiteMapNode a ser localizado.

defaultValue
String

O valor padrão a ser retornado se um recurso de correspondência não for encontrado.

throwIfNotFound
Boolean

true para gerar um InvalidOperationException, se um recurso explícito for definido para attributeName, defaultValue será null e um valor localizado não for encontrado; caso contrário, false.

Retornos

String

Uma cadeia de caracteres que representa o atributo localizado.

Exceções

attributeName é null.

Um objeto de recurso de correspondência não foi localizado e throwIfNotFound é true.

Comentários

O GetExplicitResourceString método é invocado no get acessador da Title propriedade, na Description propriedade e em todos os atributos personalizados definidos na Attributes propriedade. O SiteMapProvider objeto pelo qual o SiteMapNode é rastreado deve ter sua EnableLocalization propriedade definida para true que o GetExplicitResourceString método retorne uma cadeia de caracteres localizada. Se estiver EnableLocalization definido como false, a localização não será executada e o GetExplicitResourceString método nunca será chamado.

A Title propriedade, a propriedade e todos os Description atributos personalizados definidos na Attributes propriedade invocam primeiro o GetImplicitResourceString método. Se ele retornar null, o GetExplicitResourceString método será invocado com defaultValue definido como o valor do valor padrão da expressão de recurso explícita (supondo que um foi definido) e throwIfNotFound definido como true.

Observação

A XmlSiteMapProvider classe impõe a restrição de que o SiteMapNode objeto não pode definir expressões de recurso implícitas e expressões de recurso explícitas para atributos. No entanto, uma implementação de provedor personalizado pode optar por permitir ambos.

O GetExplicitResourceString método usa a NameValueCollection coleção de chaves de recurso com as quais o SiteMapNode objeto foi inicializado. Se uma coleção de chaves de recurso não tiver sido especificada, retornará GetExplicitResourceString null.

Aplica-se a

Confira também