SiteMapNode.GetExplicitResourceString(String, String, Boolean) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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.