Membuat cuplikan XML

Editor XML dapat digunakan untuk membuat cuplikan XML baru. Editor ini disertai cuplikan XML, bernama "Cuplikan", yang merupakan cuplikan boilerplate untuk membuat cuplikan XML baru.

Untuk membuat cuplikan XML baru

Untuk membuat cuplikan kode XML baru, buat file XML baru dan gunakan fitur Sisipkan Cuplikan.

  1. Pada menu File, klik Baru, lalu klik File.

  2. Klik File XML, lalu klik Buka.

  3. Klik kanan di panel editor, lalu pilih Sisipkan Cuplikan.

  4. Pilih Cuplikan dari daftar, lalu tekan Enter.

  5. Lakukan perubahan apa pun pada cuplikan baru.

  6. Dari menu File, pilih Simpan XMLFile.xml.

    Kotak dialog Simpan File Sebagai ditampilkan.

  7. Masukkan nama cuplikan baru, lalu pilih File Cuplikan dari jendela drop-down Simpan sebagai jenis.

  8. Gunakan daftar drop-down Simpan di untuk mengubah lokasi file ke folder My Documents\Visual Studio 2005\Code Snippets\XML\My XML Snippets, lalu tekan Simpan.

Deskripsi cuplikan

Bagian ini menjelaskan beberapa elemen kunci dalam cuplikan boilerplate. Untuk informasi selengkapnya tentang elemen skema yang digunakan oleh cuplikan XML, lihat Referensi skema cuplikan kode.

Elemen SnippetType

Editor ini mendukung dua jenis cuplikan:

<SnippetTypes>
  <SnippetType>SurroundsWith</SnippetType>
  <SnippetType>Expansion</SnippetType>
</SnippetTypes>

Jenis Expansion menentukan apakah cuplikan muncul saat Anda memanggil perintah Sisipkan Cuplikan. Jenis SurroundsWith menentukan apakah cuplikan muncul saat Anda memanggil perintah Kelilingi Dengan.

Elemen kode

Elemen Code menentukan teks XML yang akan disisipkan saat cuplikan dipanggil.

Catatan

Teks cuplikan XML harus diapit dalam bagian <![CDATA[...]]>.

Berikut elemen Code yang dibuat oleh cuplikan boilerplate.

<Code Language="XML">
  <![CDATA[<test>
  <name>$name$</name>
  $selected$ $end$</test>]]>
</Code>

Elemen Code mencakup tiga variabel.

  • $name$ adalah variabel yang ditentukan pengguna. Variabel ini membuat elemen name, yang memiliki nilai yang dapat diedit dengan nilai default "name". Variabel yang ditentukan pengguna ditetapkan menggunakan elemen Literal.

  • $selected$ adalah variabel yang telah ditentukan sebelumnya. Variabel ini mewakili teks yang dipilih di editor XML sebelum memanggil cuplikan. Penempatan variabel ini menentukan di mana teks yang dipilih akan muncul dalam cuplikan kode yang mengelilingi pilihan tersebut.

  • $end$ adalah variabel yang telah ditentukan sebelumnya. Ketika pengguna menekan Enter untuk menyelesaikan pengeditan bidang cuplikan kode, variabel ini akan menentukan ke mana tanda sisipan (^) dipindahkan.

    Elemen Code di atas menyisipkan teks XML berikut:

<test>
  <name>name</name>
</test>

Nilai elemen nama ditandai sebagai wilayah yang dapat diedit.

Elemen harfiah

Elemen Literal digunakan untuk mengidentifikasi teks pengganti yang dapat disesuaikan setelah disisipkan ke dalam file. Misalnya, string harfiah, nilai numerik, dan beberapa nama variabel dapat dinyatakan sebagai harfiah. Anda dapat menentukan sejumlah elemen harfiah dalam cuplikan XML dan merujuknya beberapa kali dari dalam cuplikan. Berikut contoh elemen Literal yang menentukan variabel $name$, dengan nilai default berupa "name".

<Literal>
  <ID>name</ID>
  <Default>name</Default>
</Literal

Elemen literal juga dapat merujuk ke fungsi. Editor XML disertai fungsi bernama LookupPrefix. Fungsi LookupPrefix mencari URI kumpulan nama XML tertentu dari lokasi dalam dokumen XML tempat cuplikan ini dipanggil dan mengembalikan awalan kumpulan nama XML yang ditentukan untuk kumpulan nama XML tersebut, jika ada, serta menyisipkan titik dua (:) pada nama tersebut. Berikut contoh elemen Literal yang menggunakan fungsi LookupPrefix.

<Literal Editable="false">
   <ID>prefix</ID>
   <Function>LookupPrefix("namespaceURI")</Function>
</Literal>

Variabel $prefix$ kemudian dapat digunakan di tempat lain dalam cuplikan XML Anda.

Konten terkait

  • Last updated on