Mavzu: Xml hujjat hosil qilish. Xml hujjatlarini qo'shish

Jadval 31.1. XML hujjatlarining asosiy elementlari

	Element	Tavsif
1	<с>	Tavsif Kodni shrift yordamida matnni formatlaydi. Ushbu elementdan boshqa matnga kiritilgan alohida kod so'zlar uchun foydalaning
2		Kod shrifti yordamida matnni formatlaydi. Ushbu elementdan boshqa matnga kiritilmagan bir nechta kod satrlari uchun foydalaning
3		Matnni buyumning tavsifi sifatida belgilaydi. Ro'yxatdagi yoki elementlarining bolasi sifatida ishlatiladi
4		Maqsaddan foydalanish misoli sifatida matnni belgilaydi
5		Maqsadni tashlashi mumkin bo'lgan istisno holatini bildiradi
6		XML hujjatlarini tashqi fayldan oladi
7		Ro'yxat elementini ifodalaydi. ning bolasi sifatida ishlatilgan va va bolalari bo'lishi mumkin
8		Ro'yxatni belgilaydi. va farzandlari bo'lishi mumkin
9		Jadvallar ro'yxatining sarlavha qatorini aks ettiradi. ning bolasi sifatida ishlatilgan va va bolalari bo'lishi mumkin
10		Matnni alohida xatboshilarga ajratish uchun ishlatiladi
11		Maqsadli parametrni tavsiflaydi
12		Metod parametriga havolani belgilaydi
13		Maqsad uchun zarur bo'lgan ruxsatnomalarni belgilaydi
14		Maqsad haqida qo'shimcha ma'lumotlarni o'z ichiga oladi
15		Maqsadning qaytish qiymatini tavsiflaydi; usullar bilan ishlatiladi
16		kabi element tanasida ishlatiladigan boshqa maqsadga havolani belgilaydi
17		Odatda boshqa elementlardan tashqarida yoki kabi element oxirida ishlatilgan boshqa maqsadga havolani belgilaydi
18		Maqsad haqida qisqacha ma'lumotni o'z ichiga oladi
19		Matnni element ta'rifi sifatida belgilaydi. Ro'yxatdagi yoki elementlarining bolasi sifatida ishlatiladi
20		Umumiy maqsadning tip parametrini tavsiflaydi
21		Tur parametriga havolani belgilaydi
22		Maqsadning qaytish qiymatini tavsiflaydi; usullar bilan ishlatiladi

Matnni formatlash elementlari

Jadvalda keltirilgan ko'plab narsalar. 31.1 matnni boshqa elementlar ichida formatlash uchun mo'ljallangan. Masalan,

elementi tarkibida ko'rsatiladigan matnni ko'rsatadigan boshqa elementlarning kombinatsiyasi bo'lishi mumkin. Matnni formatlash elementlari - , , va ularga tegishli

,
va elementlari. elementi bu ro'yxatga kiritilishi mumkin bo'lgan alohida holat, chunki u matnning asosiy qismiga kiritilishi mumkin, garchi odatda oxirida paydo bo'ladi.

<раrа>

Matnni paragraflarga bo'lish uchun
elementi ishlatiladi:

///

/// <раrа>1-xatboshining qisqacha tavsifi.

/// <раrа>2- xatboshining qisqacha tavsifi.


///

<с> и

va elementlari ham kod shrifti bilan formatlash uchun ishlatiladi, odatda Courier kabi bir qatorli shrift. Ularning orasidagi farq shundaki, elementi "matndagi kodni" ifodalaydi; jumla ichida topilgan kodli so'zlar va kod qismlarini matndan tashqarida formatlash uchun ishlatiladi. va elementlaridan quyidagicha foydalanish mumkin:

///

/// <раrа>

/// Ushbu qisqacha tavsif qiziqarli xususiyatlarga ega bo'lgan sinfiga qaratilgan.

/// misol uchun:

///

///

/// MyPoet poet = new My Poet ("Homer") ;

/// роеt.AddMuse("Thalia");

/// poet.WriteMeAnEpic() ;

///

///

, ,
и

Ushbu to'rt element ham loyihadagi XML hujjatlaridagi boshqa yozuvlarga yoki tashqi MSDN yozuvlariga murojaat qilish uchun ishlatiladi. Odatda, ularning har biri ko'prik sifatida paydo bo'lib, hujjatlar brauzerlariga boshqa yozuvlarga o'tishga imkon beradi.

va elementlari o'zlarining maqsadlarini cref atributidan foydalangan holda belgilaydilar va maqsad har qanday sinfning biron bir turi yoki a'zosi bo'lishi mumkin, loyihada yoki boshqa joyda.
va elementlari joriy maqsad parametriga murojaat qilish uchun name atributidan foydalanadi:

///

/// <раrа>

/// Ushbu usul musiqani tanlash uchun
dan foydalanadi.

/// Qo'shimcha ma'lumot olish uchun ga qarang.///


///

///

///

elementi C # kalit so'zlarini boshqa atribut langword orqali havola qilish uchun ayniqsa foydali bo'lishi mumkin.

///

/// Qo'shimcha ma'lumot olish uchun ga qarang.

///

Ushbu yondashuvning afzalligi shundaki, tilga xos kalit so'zni ko'rsatish boshqa tillar uchun, masalan, Visual Basic uchun hujjatlarni tayyorlashga imkon beradi. C # dagi null kalit so'z Visual Basic-dagi Nothing kalit so'ziga tengdir, shuning uchun XML hujjatlarini formatlash uchun ishlatiladigan vositaga bunday nuanslar ma'lum bo'lgan taqdirda ikkala til ham xizmat qilishi mumkin.

E'tibor bering, elementlar odatda nom, cref yoki langword atributlari bilan hosil qilinadigan ko'rsatiladigan matnni o'z ichiga olmaydi. Matnning takrorlanishiga yo'l qo'ymaslik uchun ushbu holatni yodda tutish kerak - masalan:

/// Ushbu usul muzni tanlash uchun
museName dan foydalanadi.

Ehtimol, ushbu misolda museName so'zi takrorlanadi.

va tegishli elementlar

elementi matnni formatlashning eng murakkab elementidir, chunki u har xil usullarda ishlatilishi mumkin. Ushbu element quyidagi qiymatlardan birini qabul qila oladigan tip atributiga ega:

□ bullet - o'qlangan ro'yxatni formatlaydi;

□ number - raqamlangan ro'yxatni formatlaydi;

□ table - jadvalni formatlaydi.

Odatda, elementida bitta bolasi va bir nechta bolalari mavjud. Ularning har biri va elementlarini o'z ichiga olishi mumkin. Muayyan asosiy elementni tanlash ro'yxat turiga va ro'yxatlar tanlangan vosita tomonidan qanday formatlanishiga bog'liq bo'ladi. Masalan, elementi jadval ko'rinishidagi ro'yxatlarda ko'rinishi mumkin yoki bo'lmasligi mumkin, elementi faqat jadvalda mantiqiy bo'ladi. Belgilangan ro'yxatlar uchun siz quyidagilarga o'xshash koddan foydalanishingiz mumkin:

///

/// <раrа>

/// Этот метод использует
для выбора музы.

///

/// <раrа>

/// Попробуйте следующие музы:

///

///

/// Muse name

/// Muse's favorite pizza

///

///

/// Calliope

/// Ham & MushroonK/description>

///

///

/// Clio

/// Four Seasons

///

///

/// Erato

/// Meat Feast

///

///

///


///

Ushbu elementlar tomonidan amalga oshiriladigan aniq formatlash har xil bo'lishi mumkinligi sababli, biroz tajriba qilish yaxshidir. Ushbu elementlar tomonidan qilingan har qanday harakatlar ularni e'tiborsiz qoldiradigan ob'ekt brauzerida ko'rinmasligini biling