Заменяет диапазон символьных данных.
Синтаксис
ЗаменитьДанные(<Смещение>, <Длина>, <Строка>)Полное описание, параметры и ограничения
ТекстDOM.ЗаменитьДанные (DOMText.ReplaceData)
ТекстDOM (DOMText)
ЗаменитьДанные (ReplaceData)
Доступен, начиная с версии 8.1.
Синтаксис:
ЗаменитьДанные(<Смещение>, <Длина>, <Строка>)
Параметры:
<Смещение> (обязательный)
Тип: Число.
Смещение от начала символьных данных.
<Длина> (обязательный)
Тип: Число.
Длина замещаемых символьных данных.
<Строка> (обязательный)
Тип: Строка.
Строка, замещающая символьные данные.
Описание:
Заменяет диапазон символьных данных.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Примечание:
Причины вызова исключения:
смещение превышает размер символьных данных;
данный узел в режиме Только для чтения.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Изменить символьные данные текста, комментария и CDATA
У трёх разных видов узлов одинаковая модель символьных данных. Делаем определённую правку ABCDEF → ABCxyz!, проверяя смещения с нуля.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Все три узла создаются с одинаковыми шестью ASCII-символами. Документ не читается из внешнего источника.
Для первого запуска оставьте ASCII: так смещения прозрачны и не смешиваются с особенностями Unicode.
Документ = Новый ДокументDOM;
Узлы = Новый Массив;
Узлы.Добавить(Документ.СоздатьТекстовыйУзел("ABCDEF"));
Узлы.Добавить(Документ.СоздатьКомментарий("ABCDEF"));
Узлы.Добавить(Документ.СоздатьСекциюCDATA("ABCDEF"));
Для Каждого Узел Из Узлы Цикл
Сообщить(Узел.Размер = 6);
Сообщить(Узел.ВыбратьДанные(0, 3) = "ABC");
Узел.ВставитьДанные(3, "-");
Сообщить(Узел.Данные = "ABC-DEF");
Узел.ДобавитьДанные("!");
Узел.ЗаменитьДанные(4, 3, "xyz");
Сообщить(Узел.Данные = "ABC-xyz!");
Узел.УдалитьДанные(3, 1);
Сообщить(Узел.Данные = "ABCxyz!");
Сообщить(Узел.Размер = 7);
КонецЦикла;Разбор по шагам
Создаём ТекстDOM, КомментарийDOM и СекцияCDATADOM, а не передаём неизвестный объект в универсальную функцию.
Размер считает символьные данные; ВыбратьДанные(0,3) берёт первые три символа.
Вставляем дефис на смещение 3, добавляем ! в конец. DEF теперь занимает позиции 4–6.
Заменяем три символа с позиции 4 на xyz и удаляем один дефис с позиции 3.
Как проверить результат
У каждого вида узла последовательность одинакова: ABC-DEF, ABC-xyz!, ABCxyz!.
Конечный Размер равен 7, все сравнения — Истина.
Проверьте смещение за пределами длины: метод должен вызвать ошибку, а не незаметно исправить индекс.
Ожидаемый результат
Три настоящих вида узлов обработаны одинаковым символьным контрактом с наблюдаемыми промежуточными результатами.
На что обратить внимание
Смещения DOM начинаются с нуля, в отличие от некоторых строковых функций 1С.
Комментарий не может содержать запрещённую XML-последовательность --, а CDATA — завершающую последовательность ]]>. Здесь их нет.
Текст, комментарий и CDATA сериализуются по-разному, даже когда их Данные совпадают.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Изменить и разделить текстовый узел DOM
У текстового узла операции со смещением начинаются с нуля. Разделение создаёт соседний узел, нормализация соединяет соседние текстовые узлы.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Выполняйте на сервере. Используйте приведённые строки без изменений для первой проверки смещений.
Все операции выполняются над содержимым XML в памяти; файл не изменяется.
Документ = Новый ДокументDOM("", "name");
Корень = Документ.ЭлементДокумента;
Текст = Документ.СоздатьТекстовыйУзел("Книга");
Корень.ДобавитьДочерний(Текст);
Текст.ВставитьДанные(0, "новая ");
Текст.ДобавитьДанные("!");
Сообщить(Текст.ВыбратьДанные(0, 5));
Текст.ЗаменитьДанные(6, 5, "Тетрадь");
Текст.УдалитьДанные(0, 6);
Сообщить(Текст.Данные);
Сообщить(Текст.Размер);
ВтораяЧасть = Текст.РазделитьТекст(7);
Сообщить(Текст.Данные);
Сообщить(ВтораяЧасть.Данные);
Сообщить(Текст.ПолныйТекст);
Сообщить(Корень.ДочерниеУзлы.Количество());
Корень.Нормализовать();
Сообщить(Корень.ДочерниеУзлы.Количество());
Текст = Корень.ПервыйДочерний;
НовыйТекст = Текст.ЗаменитьПолныйТекст("Ручка");
Сообщить(НовыйТекст.Данные);
Сообщить(Корень.ТекстовоеСодержимое);
Сообщить(НовыйТекст.ЭтоПробельныеСимволыЭлемента);Разбор по шагам
Вставляем слово новая в начало и восклицательный знак в конец.
Заменяем Книга на Тетрадь, удаляем начальное слово со следующим пробелом.
РазделитьТекст(7) отделяет знак !; ПолныйТекст включает соседние текстовые узлы.
Нормализовать объединяет их; заново получаем первый дочерний узел и заменяем полный текст.
Как проверить результат
После удаления префикса данные Тетрадь! и размер 8; после разделения части Тетрадь и !.
Число дочерних узлов меняется 2 → 1; итоговое содержимое корня Ручка.
Ожидаемый результат
Текст изменён без разрушения XML-структуры, соседние части собраны обратно.
На что обратить внимание
Смещения здесь начинаются с 0; не переносите автоматически нумерацию из строковых функций 1С, где первая позиция часто 1.
После операций удаления и нормализации заново получайте нужный узел; прежняя ссылка может относиться к отсоединённому узлу.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.