SiteMapNode.GetExplicitResourceString(String, String, Boolean) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Recupera una cadena adaptada basándose en un atributo SiteMapNode que hay que adaptar, una cadena predeterminada que se devolverá si no se encuentra ningún recurso, y un valor booleano que indica si se deberá producir una excepción en caso de no encontrarse ningún recurso.
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
Atributo SiteMapNode que hay que adaptar.
- defaultValue
- String
Valor predeterminado que se devolverá si no se encuentra un recurso coincidente.
- throwIfNotFound
- Boolean
Es true para producir una InvalidOperationException, si se ha definido un recurso explícito para attributeName, si defaultValue es null y si no se ha encontrado un valor adaptado; de lo contrario, es false.
Devoluciones
Cadena que representa el atributo adaptado.
Excepciones
attributeName es null.
No se ha encontrado un objeto de recurso coincidente y throwIfNotFound es true.
Comentarios
El GetExplicitResourceString método se invoca en el get descriptor de acceso de la Title propiedad, la Description propiedad y los atributos personalizados definidos en la Attributes propiedad . El SiteMapProvider objeto por el que se realiza el SiteMapNode seguimiento debe tener su EnableLocalization propiedad establecida true en para que el GetExplicitResourceString método devuelva una cadena localizada. Si se establece falseen EnableLocalization , la localización no se realiza y nunca se llama al GetExplicitResourceString método .
La Title propiedad, la Description propiedad y los atributos personalizados definidos en la Attributes propiedad invocan primero el GetImplicitResourceString método . Si devuelve null, el GetExplicitResourceString método se invoca con defaultValue establecido en el valor del valor predeterminado de la expresión de recurso explícita (suponiendo que se definió uno) y throwIfNotFound establecido en true.
Nota
La XmlSiteMapProvider clase impone la restricción de que el SiteMapNode objeto no puede definir expresiones de recursos implícitas y expresiones de recursos explícitas para atributos. Sin embargo, una implementación de proveedor personalizada puede optar por permitir ambas.
El GetExplicitResourceString método usa la NameValueCollection colección de claves de recursos con la que se inicializó el SiteMapNode objeto. Si no se especificó una colección de claves de recursos, devuelve GetExplicitResourceString null.