Bagikan melalui


SiteMapNode.GetExplicitResourceString(String, String, Boolean) Metode

Definisi

Mengambil string yang dilokalkan berdasarkan SiteMapNode atribut untuk dilokalkan, string default untuk dikembalikan jika tidak ada sumber daya yang ditemukan, dan nilai Boolean yang menunjukkan apakah akan melemparkan pengecualian jika tidak ada sumber daya yang ditemukan.

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

Parameter

attributeName
String

Atribut SiteMapNode untuk melokalisasi.

defaultValue
String

Nilai default yang akan dikembalikan jika sumber daya yang cocok tidak ditemukan.

throwIfNotFound
Boolean

true untuk melempar InvalidOperationException, jika sumber daya eksplisit didefinisikan untuk attributeName, defaultValue adalah null, dan nilai yang dilokalkan tidak ditemukan; jika tidak, false.

Mengembalikan

String yang mewakili atribut yang dilokalkan.

Pengecualian

attributeName adalah null.

Objek sumber daya yang cocok tidak ditemukan dan throwIfNotFound adalah true.

Keterangan

Metode GetExplicitResourceString ini dipanggil dalam get aksesor Title properti, Description properti, dan atribut kustom apa pun yang ditentukan dalam Attributes properti . Objek SiteMapProvider tempat SiteMapNode dilacak harus memiliki properti yang EnableLocalization diatur ke true untuk GetExplicitResourceString metode untuk mengembalikan string yang dilokalkan. EnableLocalization Jika diatur ke false, pelokalan tidak dilakukan dan GetExplicitResourceString metode tidak pernah dipanggil.

Properti Title , Description properti, dan atribut kustom apa pun yang ditentukan dalam Attributes properti terlebih dahulu memanggil GetImplicitResourceString metode . Jika mengembalikan null, GetExplicitResourceString metode dipanggil dengan defaultValue diatur ke nilai default dari ekspresi sumber daya eksplisit (dengan asumsi yang ditentukan) dan throwIfNotFound diatur ke true.

Nota

Kelas XmlSiteMapProvider memberlakukan pembatasan bahwa SiteMapNode objek tidak dapat menentukan ekspresi sumber daya implisit dan ekspresi sumber daya eksplisit untuk atribut. Namun, implementasi penyedia kustom dapat memilih untuk mengizinkan keduanya.

Metode ini GetExplicitResourceString menggunakan NameValueCollection kumpulan kunci sumber daya yang diinisialisasi SiteMapNode objek. Jika kumpulan kunci sumber daya tidak ditentukan, mengembalikan GetExplicitResourceStringnull.

Berlaku untuk

Lihat juga