SiteMapNode.GetExplicitResourceString(String, String, Boolean) メソッド

  • リファレンス

定義

名前空間:
System.Web
アセンブリ:
System.Web.dll

ローカライズする SiteMapNode 属性、リソースが見つからない場合に返す既定の文字列、およびリソースが見つからない場合に例外をスローするかどうかを示すブール値に基づいて、ローカライズされた文字列を取得します。

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 属性。

defaultValue
String

一致するリソースが見つからない場合に返す既定値。

throwIfNotFound
Boolean

attributeName にリソースが明示的に定義されており、defaultValue が true で、ローカライズされた値が見つからない場合に InvalidOperationException をスローする場合は null。それ以外の場合は false。

戻り値

String

ローカライズされた属性を表す文字列。

例外

ArgumentNullException

attributeName が nullです。

InvalidOperationException

一致するリソース オブジェクトが見つからず、throwIfNotFound が true です。

注釈

メソッドはGetExplicitResourceString、 プロパティ、プロパティ、Descriptionおよび プロパティでget定義されているカスタム属性のアクセサーTitleでAttributes呼び出されます。 SiteMapProviderメソッドがローカライズされた文字列をSiteMapNode返すには、 が追跡されるオブジェクトの GetExplicitResourceString プロパティが にtrue設定されている必要がありますEnableLocalization。 EnableLocalizationが にfalse設定されている場合、ローカリゼーションは実行されず、GetExplicitResourceStringメソッドは呼び出されません。

Titleプロパティ、Descriptionプロパティ、および プロパティで定義されているカスタム属性は、最初に Attributes メソッドをGetImplicitResourceString呼び出します。 が返 nullされた場合、 GetExplicitResourceString メソッドは、明示的なリソース式から既定値の値に設定して呼び出 defaultValue され (定義されていると仮定して)、 throwIfNotFound に true設定されます。

注意

クラスは XmlSiteMapProvider 、オブジェクトが属性の SiteMapNode 暗黙的なリソース式と明示的なリソース式の両方を定義できないという制限を課します。 ただし、カスタム プロバイダーの実装では、両方を許可することを選択できます。

メソッドは GetExplicitResourceString 、オブジェクトが NameValueCollection 初期化されたリソース キーのコレクションを SiteMapNode 使用します。 リソース キーのコレクションが指定されていない場合、 は を GetExplicitResourceString 返します null。

適用対象

こちらもご覧ください