Aracılığıyla paylaş


XML kod parçacıklarını oluşturma

XML düzenleyicisi, yeni XML kod parçacıkları oluşturmak için kullanılabilir. Düzenleyici, yeni XML kod parçacıkları oluşturmaya yönelik ortak bir kod parçacığı olan "Kod Parçacığı" adlı bir XML parçacığı içerir.

Yeni bir XML kod parçacığı oluşturmak için

Yeni bir XML kod parçacığı oluşturmak için yeni bir XML dosyası oluşturun ve Kod Parçacığı Ekle özelliğini kullanın.

  1. Dosya menüsünde Yeni'ye ve ardından Dosya'ya tıklayın.

  2. XML Dosyası'nın ardından Aç'a tıklayın.

  3. Düzenleyici bölmesine sağ tıklayın ve Kod Parçacığı Ekle'yi seçin.

  4. Listeden Kod Parçacığı'nı seçin ve Enter tuşuna basın.

  5. Yeni kod parçacığında herhangi bir değişiklik yapın.

  6. Dosya menüsünden XMLFile.xml Dosyasını Kaydet'i seçin.

    Dosyayı Farklı Kaydet iletişim kutusu görüntülenir.

  7. Yeni kod parçacığının adını girin ve Kayıt türü açılan penceresinde Kod Parçacığı Dosyaları'nı seçin.

  8. Dosya konumunu Belgelerim\Visual Studio 2005\Code Snippets\XML\Xml Kod Parçacıklarım klasörü olarak değiştirmek için Kaydet açılan listesini kullanın ve ardından Kaydet'e basın.

Kod parçacığı açıklaması

Bu bölümde ortak kod parçacığındaki bazı önemli öğeler açıklanmaktadır. XML kod parçacıkları tarafından kullanılan şema öğeleri hakkında daha fazla bilgi için bkz . Kod parçacıkları şema başvurusu.

SnippetType öğesi

Düzenleyici iki kod parçacığı türünü destekler:

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

Tür, Expansion Kod Parçacığı Ekle komutunu çağırdığınızda kod parçacığının görünüp görünmeyeceğini belirler. Türü, SurroundsWith Surrounds With komutunu çağırdığınızda kod parçacığının görünüp görünmeyeceğini belirler.

Kod öğesi

öğesi, Code kod parçacığı çağrıldığında eklenecek XML metnini tanımlar.

Not

XML kod parçacığı metni bir <![CDATA[...]]> bölüm içine alınmalıdır.

Aşağıdaki, Code ortak kod parçacığı tarafından oluşturulan öğedir.

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

Code öğesi üç değişken içerir.

  • $name$ kullanıcı tanımlı değişkendir. Varsayılan olarak "name" olan düzenlenebilir bir değere sahip olan bir name öğe oluşturur. Kullanıcı tanımlı değişkenler öğesi kullanılarak Literal tanımlanır.

  • $selected$ önceden tanımlanmış bir değişkendir. Kod parçacığını çağırmadan önce XML düzenleyicisinde seçilen metni temsil eder. Bu değişkenin yerleşimi, seçilen metnin bu seçimi çevreleyen kod parçacığında nerede görüneceğini belirler.

  • $end$ önceden tanımlanmış bir değişkendir. Kullanıcı kod parçacığı alanlarını düzenlemeyi tamamlamak için Enter tuşuna bastığında, bu değişken şapka işaretinin (^) nereye taşındığını belirler.

    Yukarıdaki Code öğe aşağıdaki XML metnini ekler:

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

name öğesinin değeri düzenlenebilir bir bölge olarak işaretlenir.

Değişmez değer öğesi

Literal öğesi, dosyaya eklendikten sonra özelleştirilebilen değiştirme metnini tanımlamak için kullanılır. Örneğin, değişmez dizeler, sayısal değerler ve bazı değişken adları değişmez değer olarak bildirilebilir. XML kod parçacığınızda istediğiniz sayıda değişmez değer tanımlayabilir ve kod parçacığının içinden bunlara birden çok kez başvurabilirsiniz. Aşağıda, varsayılan değeri "name" olan bir $name$ değişkeni tanımlayan bir öğe örneği Literal verilmiştir.

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

Değişmez değerler işlevlere de başvurabilir. XML düzenleyicisi LookupPrefix adlı bir işlev içerir. LookupPrefix işlevi, bu kod parçacığının çağrıldığı XML belgesindeki konumdan verilen ad alanı URI'sini arar ve varsa söz konusu ad alanı için tanımlanan ad alanı ön ekini döndürür ve bu ad alanında iki nokta üst üste (:) içerir. Aşağıda LookupPrefix işlevini kullanan bir Literal öğe örneği verilmiştir.

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

$prefix$ değişkeni daha sonra XML kod parçacığınızın başka bir yerinde kullanılabilir.