Комментарий в xml: XML — Комментарии — CoderLessons.com

Можно ли закомментировать код внутри тега в xml?


Вопрос задан


Изменён
1 год 3 месяца назад


Просмотрен
172 раза

Можно ли закомментировать код внутри тега xml файла? Код не внутри тега возможно комментировать, но возможно ли комментировать код внутри тега? Так намного удобнее проверять функции.

    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
<!--        android:padding="16dp"-->
        android:text="Hello World!" />






1

Стандарт XML не позволяет объявлять комментарии внутри блока открытия тега.

Я обычно делаю так: комментирую атрибут с помощью Ctrl + /, далее вытаскиваю закомментированный атрибут за пределы тега с помощью Alt + Shift + :

<!--        android:padding="16dp"-->
    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Hello World!" />

Есть еще такой способ, может быть вам подойдет, объявить фейковый неймспейс _android="http://", и заменять android на _android, чтобы «выключить» атрибут:

<FrameLayout xmlns:android="http://schemas. android.com/apk/res/android"
    xmlns:_android="http://"
    android:layout_width="match_parent"
    android:layout_height="match_parent">
    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        _android:padding="16dp"
        android:text="Hello World!" />
</FrameLayout>







Зарегистрируйтесь или войдите

Регистрация через Google

Регистрация через Facebook

Регистрация через почту

Отправить без регистрации

Почта

Необходима, но никому не показывается

Отправить без регистрации


Почта

Необходима, но никому не показывается





Нажимая на кнопку «Отправить ответ», вы соглашаетесь с нашими пользовательским соглашением, политикой конфиденциальности и политикой о куки


XML-комментарии | Уроки C#



Блог начинающего специалиста


Каждый XML-комментарий в C#, начинается с трех слэшей «///», а в Visual Basic. NET с трех одиночных кавычек (апострофов) «’ ‘ ‘». В C#, обычные комментарии начинаются с двух слэшей, а третий слэш говорит синтаксическому анализатору, что это XML-комментарий. В барсике, аналогично, только обычный комментарий начинается с одной, одиночной кавычки.

Для чего же нужны XML-комментарии? 

Парсить XML-файл настоящий кайф, то бишь, ничего сложного в этом нет, так вот, одним из главных особенностей XML-комментариев является создание документации прямо из исходных файлов проекта, а так же документация самого кода — классы, процедуры, модули, структуры, функций, их аргументы (параметры). С помощью синтаксического анализатора (parser’a) можно раскрывать теги XML-комментария, внутри которого, находится дополнительная информация.

Сегодня, мы создадим процедуру, дадим ей описание, описание параметрам и добавим исключение. Когда мы будем вызывать нашу процедуру, IntelliSense будет показывать нам комментарии, которые мы написали.

Для примера будем использовать всего три тега:

  • Тег <summary>, в коде, встречается больше всего, т.к

он описывает элементы (члены) типа, включая методы, свойства и поля

  • Тег <param> описывает параметры метода или свойства. Имеет один атрибут Name = имя параметра
  • Тег <exception> описывает исключения, которые могут произойти. Атрибут cref = название исключения

Весь список тегов:

/// <summary>
/// Моя семья
/// </summary>
/// /// <exception cref="BrotherException">Описание</exception>
/// /// <exception cref="SisterException">Описание</exception>
/// <param name="I">Ваше имя</param>
/// <param name="Mam">Имя вашей мамы</param>
/// <param name="Dad">Имя вышего папы</param>
/// <param name="Sister">Имя вашей сестры</param>
/// <param name="Brother">Имя вашего брата</param>
static void MyFamily(string I, string Mam, string Dad, string Sister, string Brother)
 {
   // процедура
 }
''' <summary>
'''Моя семья
'''</summary>
''' <param name="I">Ваше имя</param>
''' <param name="Mam">Имя вашей мамы</param>
''' <param name="Dad">Имя вышего папы</param>
''' <param name="Sister">Имя вашей сестры</param>
''' <param name="Brother">Имя вашего брата</param>
Sub MyFamily(ByVal I As String, ByVal Mam As String, ByVal Dad As String, ByVal Sister As String, ByVal Brother As String)
    ' процедура
End Sub

Как будет показано в IntelliSense:

Познакомиться с XML-комментариями, тегами и описанием можно на

  • MSDN (VB. NET)
  • Отличная статья про XML-комментарии (C#)





Как закомментировать блок тегов в XML?

Как закомментировать блок тегов в XML?

Т.е. Как я могу закомментировать и все, что внутри него, в приведенном ниже коде?

 <деталь>
    <диапазон>
      <статический текст>
        <элемент отчета x="180" y="0"/>
        
      
    
  
 

Я мог бы использовать , но это только для одиночных тегов (как я знаю), например // в Java и C. Я бы хотел что-то более похожее на то, как /** comment **/ можно использовать в Java и C, поэтому я может комментировать более длинные блоки XML-кода.

  • xml
  • комментарии

2

Вы можете использовать этот стиль комментариев в нескольких строках (который существует также в HTML)

 
    <диапазон>
    
     

 

7

Вы можете обернуть текст несуществующей инструкцией по обработке, например:

 

    <статический текст>
      <элемент отчета x="180" y="0"/>
      
    
  
?>

 

Вложенные инструкции обработки не допускаются, и ‘?>’ завершает инструкцию обработки (см. здесь комментарий заканчивается

Довольно распространенная ошибка. Он унаследован от того, как SGML обрабатывает комментарии. (Прочитайте спецификацию XML в этой теме)

3

На самом деле, вы можете использовать формат с несколькими строками или тегами:

 
 

Здесь для комментирования мы должны написать, как показано ниже:

 
 

Ярлыки для IntelliJ Idea и Eclipse

For Windows & Linux:

Shortcut for Commenting a single line:

Ctrl + /

Shortcut for Commenting multiple lines:

Ctrl + Shift + /

Для Mac:

Ярлык для комментирования одной строки:

cmnd + /

Ярлык для комментирования нескольких строк:

cmnd + Shift + /

Вы должны помнить одну вещь: вы не можете комментировать атрибут тега XML. Например:

 <текстовое представление
    Android: layout_width = "match_parent"
    android:layout_height="wrap_content"
    
    андроид: textStyle="жирный" />
 

Здесь TextView — это тег XML, а text — атрибут этого тега. Вы не можете комментировать атрибуты тега XML. Вы должны прокомментировать полный тег XML. Например:

 
 

0

Вы можете легко закомментировать данные, используя это:

 
 

метод комментирования в xml.

Синтаксис для XML:

напр.

 
   
   <список_классов>
   <студент>
   <имя>
   <класс>A
   
   
 

Правила комментариев XML

 Комментарии не могут появляться перед объявлением XML.
Комментарии могут появляться в любом месте документа.
Комментарии не должны появляться внутри значений атрибутов.
Комментарии не могут быть вложены в другие комментарии.
 

В Notepad++ вы можете выбрать несколько строк и использовать CTRL+Q, что автоматически сделает блочные комментарии для выбранных строк.

Если вы используете Eclipse IDE, вы можете закомментировать строки в файле XML, выделив их и нажав Ctrl+Shift+c.

Как закомментировать раздел XML, внутри которого есть комментарии?

спросил

Изменено
2 года, 1 месяц назад

Просмотрено
26 тысяч раз

Как закомментировать раздел XML, внутри которого есть комментарии?

Следующее не будет работать. Он закомментировал только stuff0 :

 
вещи2

вещи4

вещи6
-->
 
  • xml
  • комментарии

1

Я знаю, тебе не следует этого делать. В соответствии со спецификацией XML вы не должны этого делать.

Сказав это… Мне это было очень нужно, так что вот в чем хитрость. Окружите раздел, который вы хотите прокомментировать, неиспользуемой инструкцией обработки :

 

  
    
  
  
?>
<остальные-мои-теги />
 

Вы можете использовать любую неиспользуемую инструкцию обработки. Я выбрал «комментарий» в качестве неиспользуемой инструкции обработки, поэтому я начал большой комментарий с и закончил его ?> .

В качестве инструкции по обработке подойдет почти любое слово, так как в действительности они не используются большую часть времени. Я имею в виду, когда вы в последний раз им пользовались?

1

-- нельзя использовать в XML-комментариях. Вы можете добавить пробел между двумя - . Если вы хотите сделать это программно, XSLT может сделать эту работу за вас. Например, следующий XSLT:

 
    
        <а>
            
        
    

 

Выдает следующий результат:

 
 

Однако XSLT-процессор также может выдать ошибку. Учитывая спецификацию, реализация может добавить пробел или вызвать ошибку.

Нет. XML согласно его спецификации не поддерживает вложенные комментарии.

У вас есть два варианта:

  1. Удалить его, а не комментировать - вы всегда можете вернуться позже.
  2. Сначала замените все экземпляры -- чем-то другим.

Вот еще один подход: можно просто использовать вложенные комментарии, как если бы они поддерживались в XML:

 
-->
 

Затем используйте только этот XML внутри текстового редактора. XML, который вы на самом деле передаете в процесс, является результатом написания некоторой простой программы, которая читает вложенный-комментарий-XML и выдает невложенный-комментарий-XML.

Еще один подобный прием — использование препроцессора компилятора C. Я сделал это несколько лет назад с помощью компилятора Microsoft C++. Компилятор cl.exe на самом деле вызывал две отдельные программы, cl1.exe и cl2.exe. Cl1.exe — это препроцессор. Таким образом, вы можете загрузить в эту штуку что угодно (XML, скрипты nmake и т.

Imacros | Все права защищены © 2021