SiteMapNode.GetExplicitResourceString(String, String, Boolean) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recupera uma cadeia localizada baseada num SiteMapNode atributo a localizar, uma cadeia padrão a devolver se não for encontrado nenhum recurso, e um valor booleano que indica se deve lançar uma exceção caso nenhum recurso seja encontrado.
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 SiteMapNode atributo para localizar.
- defaultValue
- String
O valor padrão a devolver se não for encontrado um recurso correspondente.
- throwIfNotFound
- Boolean
true para lançar um InvalidOperationException, se um recurso explícito for definido para attributeName, defaultValue é null, e um valor localizado não for encontrado; caso contrário, false.
Devoluções
Uma cadeia que representa o atributo localizado.
Exceções
attributeName é null.
Um objeto recurso correspondente não foi encontrado e throwIfNotFound é true.
Observações
O GetExplicitResourceString método é invocado no get acessório da Title propriedade, da Description propriedade e de quaisquer atributos personalizados definidos na Attributes propriedade. O SiteMapProvider objeto pelo qual o SiteMapNode é rastreado deve ter a sua EnableLocalization propriedade definida como true para que o GetExplicitResourceString método devolva uma cadeia localizada. Se o EnableLocalization for definido para false, a localização não é realizada e o GetExplicitResourceString método nunca é chamado.
A Title propriedade, a Description propriedade e quaisquer atributos personalizados definidos na Attributes propriedade invocam primeiro o GetImplicitResourceString método. Se devolver null, o GetExplicitResourceString método é invocado com defaultValue definido para o valor padrão da expressão explícita de recursos (assumindo que um foi definido) e throwIfNotFound definido para true.
Note
A XmlSiteMapProvider classe impõe a restrição de que o SiteMapNode objeto não pode definir tanto expressões implícitas de recursos como expressões explícitas de recursos para atributos. No entanto, uma implementação personalizada de fornecedor pode optar por permitir ambos.
O GetExplicitResourceString método utiliza a NameValueCollection coleção de chaves de recursos com as quais o SiteMapNode objeto foi inicializado. Se uma coleção de chaves de recursos não foi especificada, o GetExplicitResourceString retorna null.