SiteMapNode.GetExplicitResourceString(String, String, Boolean) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 -> stringProtected Function GetExplicitResourceString (attributeName As String, defaultValue As String, throwIfNotFound As Boolean) As StringParâ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
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.