Nazwy deklarowanych elementów XML oraz atrybuty (Visual Basic)

Ten temat zawiera wytyczne języka Visual Basic dotyczące nazewnictwa elementów i atrybutów XML w literałach XML. W literału XML można określić nazwę lokalną lub kwalifikowaną nazwę. Kwalifikowana nazwa składa się z prefiksu przestrzeni nazw XML, dwukropka i nazwy lokalnej. Aby uzyskać więcej informacji na temat prefiksów przestrzeni nazw XML, zobacz Literał elementu XML.

Reguły

Lokalna nazwa elementu lub atrybutu w Visual Basic musi być zgodna z następującymi regułami.

  • Może zaczynać się od przestrzeni nazw. Musi zaczynać się od znaku alfabetycznego lub podkreślenia (_).

  • Musi zawierać tylko znaki alfabetyczne, cyfry dziesiętne, podkreślenia, kropki (.) i łączniki (-).

  • Długość nie może przekraczać 1024 znaków.

  • Dwukropki, które pojawiają się w nazwach, wskazują demarcation przestrzeni nazw. W związku z tym można użyć dwukropków tylko do określenia przestrzeni nazw XML dla określonej nazwy.

Ponadto należy przestrzegać poniższych wskazówek.

  • Specyfikacja XML 1.0 zastrzega sobie wszystkie nazwy rozpoczynające się od ciągu "xml" dowolnej odmiany wielkich liter. W związku z tym nie należy używać tych nazw dla nazw elementów i atrybutów.

Wskazówki dotyczące długości nazw

W praktyce nazwa powinna być tak krótka, jak to możliwe, jednocześnie wyraźnie identyfikując charakter elementu. Poprawia to czytelność kodu i zmniejsza długość wiersza oraz rozmiar pliku źródłowego.

Jednak nazwa nie powinna być tak krótka, że nie opisuje odpowiednio elementu ani sposobu jego użycia. Jest to ważne dla czytelności kodu. Jeśli ktoś inny próbuje to zrozumieć lub jeśli samodzielnie patrzysz na to długo po jego napisaniu, odpowiednie nazwy elementów mogą zaoszczędzić czas.

Ważność wielkości liter w nazwach

W nazwach elementów XML jest rozróżniana wielkość liter. Oznacza to, że gdy kompilator języka Visual Basic porównuje dwie nazwy, które różnią się tylko literami alfabetycznymi, interpretuje je jako różne nazwy. Na przykład interpretuje ABC i abc odnosi się do oddzielnych elementów.

Przestrzenie nazw XML

Podczas tworzenia literału elementu XML można określić prefiks przestrzeni nazw XML dla nazwy elementu. Aby uzyskać więcej informacji, zobacz Literał elementu XML.

Zobacz też