Compartir a través de


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

Definición

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 -> string
Protected Function GetExplicitResourceString (attributeName As String, defaultValue As String, throwIfNotFound As Boolean) As String

Pará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

String

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.

Se aplica a

Consulte también