Имена объявляемых элементов и атрибутов XML (Visual Basic)Names of Declared XML Elements and Attributes (Visual Basic)

В этом разделе приводятся Visual Basic рекомендации по именованию XML-элементов и атрибутов в XML-литералах.This topic provides Visual Basic guidelines for naming XML elements and attributes in XML literals. В XML-литерале можно указать локальное имя или полное имя.In an XML literal, you can specify a local name or a qualified name. Полное имя состоит из префикса пространства имен XML, двоеточия и локального имени.A qualified name consists of an XML namespace prefix, a colon, and a local name. Дополнительные сведения о префиксах пространств имен XML см. в разделе литерал XML-элемента.For more information about XML namespace prefixes, see XML Element Literal.

ПравилаRules

Локальное имя элемента или атрибута в Visual Basic должно соответствовать следующим правилам.A local name of an element or attribute in Visual Basic must adhere to the following rules.

  • Он может начинаться с пространства имен.It can begin with a namespace. Оно должно начинаться с алфавитного символа или знака подчеркивания ( _ ).It must begin with an alphabetical character or an underscore (_).

  • Он должен содержать только алфавитные символы, десятичные цифры, символы подчеркивания, точки (.) и дефисы (-).It must contain only alphabetical characters, decimal digits, underscores, periods (.), and hyphens (-).

  • Длина не должна превышать 1 024 символов.It must not be more than 1,024 characters long.

  • Двоеточия, отображаемые в именах, указывают на пространство имен разделительной.Colons that appear in names indicate namespace demarcation. Таким образом, можно использовать двоеточия только для указания пространства имен XML для определенного имени.Therefore, you can use colons only to specify an XML namespace for a particular name.

Кроме того, следует следовать приведенным ниже рекомендациям.In addition, you should adhere to the following guideline.

  • Спецификация XML 1,0 резервирует все имена, начинающиеся с строки "XML", из любого варианта капитализации.The XML 1.0 specification reserves all names starting with the string "xml", of any capitalization variation. Поэтому не используйте эти имена для элементов и имен атрибутов.Therefore, do not use those names for your element and attribute names.

Рекомендации по длине имениName Length Guidelines

По сути, имя должно быть как можно более коротким, а также четко определять природу элемента.As a practical matter, a name should be as short as possible while still clearly identifying the nature of the element. Это повышает удобочитаемость кода и сокращает длину строки и размер исходного файла.This improves the readability of your code and reduces line length and source-file size.

Однако ваше имя не должно быть настолько коротким, что оно не описывает элемент или его использование в коде.However, your name should not be so short that it does not adequately describe the element or how your code uses it. Это важно для удобочитаемости кода.This is important for the readability of your code. Если кто-то другой пытается понять его, или если вы самостоятельно просматриваете его после написания, соответствующие имена элементов могут сэкономить время.If somebody else is trying to understand it, or if you yourself are looking at it a long time after you wrote it, appropriate element names can save time.

Чувствительность к регистру в именахCase Sensitivity in Names

В именах XML-элементов учитывается регистр.XML element names are case sensitive. Это означает, что когда компилятор Visual Basic сравнивает два имени, отличающиеся только регистром букв, оно интерпретирует их как разные имена.This means that when the Visual Basic compiler compares two names that differ in alphabetical case only, it interprets them as different names. Например, он интерпретирует ABC и abc ссылается на отдельные элементы.For example, it interprets ABC and abc as referring to separate elements.

Пространства имен XMLXML Namespaces

При создании литерала XML-элемента можно указать префикс пространства имен XML для имени элемента.When creating an XML element literal, you can specify the XML namespace prefix for the element name. Дополнительные сведения см. в разделе литерал XML-элемента.For more information, see XML Element Literal.

См. также разделSee also