Обработка XML-файла (Visual Basic)

  • Статья

Компилятор создает строку идентификатора для каждой конструкции в коде, помеченной для создания документации. (Сведения о теге кода см. в разделе >.Теги комментариев XML.) Строка идентификатора однозначно идентифицирует конструкцию. Программы, обрабатывающие XML-файл, могут использовать строку идентификатора для идентификации соответствующего элемента платформа .NET Framework метаданных и отражения.

XML-файл не является иерархическим представлением кода; Это плоский список с созданным идентификатором для каждого элемента.

Компилятор соблюдает следующие правила при формировании строк идентификаторов.

  • Пробелы в строку не вставляются.

  • Первая часть строки идентификатора определяет тип идентифицируемого члена. Это один символ, за которым следует двоеточие. Используются следующие типы элементов.

Символ Description
N пространство имен

Комментарии к пространству имен нельзя добавлять в пространство имен, но ссылки на CREF можно добавлять в них, где поддерживается.
T тип: Class, , InterfaceModuleStructure, EnumDelegate
F Поле: Dim
P свойство: Property (включая свойства по умолчанию)
Пн. метод: Sub, , DeclareFunctionOperator
E событие: Event
! текст ошибки

Остальная часть строки предоставляет сведения об ошибке. Компилятор Visual Basic создает сведения об ошибках для ссылок, которые не могут быть разрешены.

  • Вторая часть String — полное имя элемента, начиная с корневого каталога пространства имен. Имя элемента, его вложенных типов и пространства имен разделяются точками. Если имя самого элемента содержит периоды, они заменяются знаком номера (#). Предполагается, что ни один элемент не имеет знака номера непосредственно в его имени. Например, полное имя конструктора String будет System.String.#ctor.

  • Для свойств и методов, имеющих аргументы, список этих аргументов заключается в круглые скобки и указывается в конце. Если аргументы не используются, скобки отсутствуют. Аргументы разделяются запятыми. Кодировка каждого аргумента следует непосредственно тому, как он кодируется в платформа .NET Framework сигнатуре.

Пример

В следующем коде показано, как создаются строки идентификатора для класса и его членов.

Namespace SampleNamespace

  ''' <summary>Signature is
  ''' "T:SampleNamespace.SampleClass"
  ''' </summary>
  Public Class SampleClass

    ''' <summary>Signature is
    ''' "M:SampleNamespace.SampleClass.#ctor"
    ''' </summary>
    Public Sub New()
    End Sub

    ''' <summary>Signature is
    ''' "M:SampleNamespace.SampleClass.#ctor(System.Int32)"
    ''' </summary>
    Public Sub New(ByVal i As Integer)
    End Sub

    ''' <summary>Signature is
    ''' "F:SampleNamespace.SampleClass.SampleField"
    ''' </summary>
    Public SampleField As String

    ''' <summary>Signature is
    ''' "F:SampleNamespace.SampleClass.SampleConstant"
    ''' </summary>
    Public Const SampleConstant As Integer = 42

    ''' <summary>Signature is
    ''' "M:SampleNamespace.SampleClass.SampleFunction"
    ''' </summary>
    Public Function SampleFunction() As Integer
    End Function

    ''' <summary>Signature is
    ''' "M:SampleNamespace.SampleClass.
    ''' SampleFunction(System.Int16[],System.Int32[0:,0:])"
    ''' </summary>
    Public Function SampleFunction(
        ByVal array1D() As Short,
        ByVal array2D(,) As Integer) As Integer
    End Function

    ''' <summary>Signature is
    ''' "M:SampleNamespace.SampleClass.
    ''' op_Addition(SampleNamespace.SampleClass,
    '''             SampleNamespace.SampleClass)"
    ''' </summary>
    Public Shared Operator +(
        ByVal operand1 As SampleClass,
        ByVal operand2 As SampleClass) As SampleClass

      Return Nothing
    End Operator

    ''' <summary>Signature is
    ''' "P:SampleNamespace.SampleClass.SampleProperty"
    ''' </summary>
    Public Property SampleProperty() As Integer
      Get
      End Get
      Set(ByVal value As Integer)
      End Set
    End Property

    ''' <summary>Signature is
    ''' "P:SampleNamespace.SampleClass.Item(System.String)"
    ''' </summary>
    Default Public ReadOnly Property Item(
        ByVal s As String) As Integer

      Get
      End Get
    End Property

    ''' <summary>Signature is
    ''' "T:SampleNamespace.SampleClass.NestedClass"
    ''' </summary>
    Public Class NestedClass
    End Class

    ''' <summary>Signature is
    ''' "E:SampleNamespace.SampleClass.SampleEvent(System.Int32)"
    ''' </summary>
    Public Event SampleEvent As SampleDelegate

    ''' <summary>Signature is
    ''' "T:SampleNamespace.SampleClass.SampleDelegate"
    ''' </summary>
    Public Delegate Sub SampleDelegate(ByVal i As Integer)
  End Class
End Namespace

См. также