SiteMapNode.GetExplicitResourceString(String, String, Boolean) 메서드

정의

지역화할 SiteMapNode 특성, 리소스가 없는 경우 반환할 기본 문자열 및 리소스가 없는 경우 예외를 throw할지 여부를 나타내는 부울 값을 기반으로 지역화된 문자열을 검색합니다.Retrieves a localized string based on a SiteMapNode attribute to localize, a default string to return if no resource is found, and a Boolean value indicating whether to throw an exception if no resource is found.

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

매개 변수

attributeName
String

지역화할 SiteMapNode 특성입니다.The SiteMapNode attribute to localize.

defaultValue
String

일치하는 리소스가 없는 경우 반환할 기본값입니다.The default value to return if a matching resource is not found.

throwIfNotFound
Boolean

true에 대해 명시적 리소스가 정의되어 있고 InvalidOperationExceptionattributeName이고 지역화된 값이 없는 경우 defaultValue을 throw하려면 null이고, 그렇지 않으면 false입니다.true to throw an InvalidOperationException, if an explicit resource is defined for attributeName, defaultValue is null, and a localized value is not found; otherwise, false.

반환

String

지역화된 특성을 나타내는 문자열입니다.A string representing the localized attribute.

예외

attributeNamenull입니다.attributeName is null.

일치하는 리소스 개체를 찾을 수 없고 throwIfNotFoundtrue인 경우A matching resource object was not found and throwIfNotFound is true.

설명

GetExplicitResourceString 메서드가 호출 되는 get 의 접근자는 Title 속성인을 Description 속성과에 정의 된 모든 사용자 지정 특성은 Attributes 속성.The GetExplicitResourceString method is invoked in the get accessor of the Title property, the Description property, and any custom attributes that are defined in the Attributes property. 합니다 SiteMapProvider 개체를 SiteMapNode 추적 됩니다 있어야 해당 EnableLocalization 속성이로 설정 true 에 대 한는 GetExplicitResourceString 지역화 된 문자열을 반환 하는 방법.The SiteMapProvider object by which the SiteMapNode is tracked must have its EnableLocalization property set to true for the GetExplicitResourceString method to return a localized string. 경우는 EnableLocalization 로 설정 된 false, 지역화 수행 되지 않습니다 및 GetExplicitResourceString 메서드 호출 되지 않습니다.If the EnableLocalization is set to false, localization is not performed and the GetExplicitResourceString method is never called.

Title 속성을 Description 속성과에 정의 된 모든 사용자 지정 특성을 Attributes 속성 먼저 호출를 GetImplicitResourceString 메서드.The Title property, the Description property, and any custom attributes that are defined in the Attributes property first invoke the GetImplicitResourceString method. 반환 하는 경우 nullGetExplicitResourceString 메서드가 호출 됩니다 defaultValue (정의 된 것으로 가정) 명시적 리소스 식이에서 기본값의 값으로 설정 하 고 throwIfNotFoundtrue합니다.If it returns null, the GetExplicitResourceString method is invoked with defaultValue set to the value of the default value from the explicit resource expression (assuming one was defined) and throwIfNotFound set to true.

참고

XmlSiteMapProvider 클래스에 제한을 적용 하는 SiteMapNode 개체는 암시적 리소스 식 및 특성에 대 한 명시적인 리소스 식을 정의할 수 없습니다.The XmlSiteMapProvider class imposes the restriction that the SiteMapNode object cannot define both implicit resource expressions and explicit resource expressions for attributes. 그러나 사용자 지정 공급자 구현 모두를 허용 하도록 선택할 수 있습니다.However, a custom provider implementation can choose to allow both.

합니다 GetExplicitResourceString 메서드를 NameValueCollection 컬렉션 리소스의 키를 SiteMapNode 개체를 초기화 합니다.The GetExplicitResourceString method uses the NameValueCollection collection of resource keys that the SiteMapNode object was initialized with. 리소스 키의 컬렉션을 지정 하지 않은 경우는 GetExplicitResourceString 반환 null합니다.If a collection of resource keys was not specified, the GetExplicitResourceString returns null.

적용 대상

추가 정보