Tworzenie fragmentów kodu XML

Edytor XML może służyć do tworzenia nowych fragmentów kodu XML. Edytor zawiera fragment kodu XML o nazwie "Fragment kodu", czyli standardowy fragment kodu do tworzenia nowych fragmentów kodu XML.

Aby utworzyć nowy fragment kodu XML

Aby utworzyć nowy fragment kodu XML, utwórz nowy plik XML i użyj funkcji Wstaw fragment kodu .

  1. W menu Plik kliknij pozycję Nowy, a następnie kliknij pozycję Plik.

  2. Kliknij pozycję Plik XML, a następnie kliknij przycisk Otwórz.

  3. Kliknij prawym przyciskiem myszy w okienku edytora i wybierz polecenie Wstaw fragment kodu.

  4. Wybierz pozycję Fragment kodu z listy i naciśnij klawisz Enter.

  5. Wprowadź zmiany w nowym fragmencie kodu.

  6. W menu Plik wybierz pozycję Zapisz plik XMLFile.xml.

    Zostanie wyświetlone okno dialogowe Zapisz plik jako .

  7. Wprowadź nazwę nowego fragmentu kodu i wybierz pozycję Pliki fragmentu kodu z okna rozwijanego Zapisz jako typ.

  8. Użyj listy rozwijanej Zapisz w , aby zmienić lokalizację pliku na Folder Moje dokumenty\Visual Studio 2005\Fragmenty kodu\XML\Moje fragmenty kodu XML, a następnie naciśnij przycisk Zapisz.

Opis fragmentu kodu

W tej sekcji opisano niektóre kluczowe elementy we fragmencie fragmentu kodu. Aby uzyskać więcej informacji na temat elementów schematu używanych przez fragmenty kodu XML, zobacz Dokumentacja schematu fragmentów kodu.

Fragment kodu, element

Edytor obsługuje dwa typy fragmentów kodu:

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

Typ Expansion określa, czy fragment kodu jest wyświetlany podczas wywoływania polecenia Wstaw fragment kodu . Typ SurroundsWith określa, czy fragment kodu jest wyświetlany podczas wywoływania polecenia Surrounds With .

Element kodu

Element Code definiuje tekst XML, który zostanie wstawiony podczas wywoływania fragmentu kodu.

Uwaga

Tekst fragmentu kodu XML musi być ujęta w <![CDATA[...]]> sekcji.

Poniżej znajduje Code się element, który jest tworzony przez standardowy fragment kodu.

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

Element Code zawiera trzy zmienne.

  • $name$ jest zmienną zdefiniowaną przez użytkownika. Tworzy element name , który ma edytowalną wartość domyślną "name". Zmienne zdefiniowane przez użytkownika są definiowane przy użyciu Literal elementu .

  • $selected$ jest wstępnie zdefiniowaną zmienną. Reprezentuje on tekst wybrany w edytorze XML przed wywołaniem fragmentu kodu. Umieszczenie tej zmiennej określa, gdzie zaznaczony tekst pojawia się we fragmencie kodu, który otacza ten wybór.

  • $end$ jest wstępnie zdefiniowaną zmienną. Gdy użytkownik naciśnie klawisz Enter , aby zakończyć edytowanie pól fragmentu kodu, ta zmienna określa miejsce przeniesienia karetki (^).

    Powyższy Code element wstawia następujący tekst XML:

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

Wartość elementu name jest oznaczona jako region edytowalny.

Element literału

Element Literal służy do identyfikowania tekstu zastępczego, który można dostosować po wstawieniu go do pliku. Na przykład ciągi literału, wartości liczbowe i niektóre nazwy zmiennych mogą być deklarowane jako literały. Możesz zdefiniować dowolną liczbę literałów we fragmencie kodu XML i odwoływać się do nich wiele razy z poziomu fragmentu kodu. Poniżej przedstawiono przykład Literal elementu definiującego zmienną $name$, której wartość domyślna to "name".

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

Literały mogą również odwoływać się do funkcji. Edytor XML zawiera funkcję o nazwie LookupPrefix. Funkcja LookupPrefix wyszukuje identyfikator URI danej przestrzeni nazw z lokalizacji w dokumencie XML, z którego jest wywoływany ten fragment kodu i zwraca prefiks przestrzeni nazw zdefiniowany dla tej przestrzeni nazw, jeśli istnieje, i zawiera dwukropek (:) w tej nazwie. Poniżej przedstawiono przykład Literal elementu, który używa funkcji LookupPrefix .

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

Zmienna $prefix$ może być następnie używana w innym miejscu w fragmencie kodu XML.