PlaceholderExtensionsReplaceTextAsync(IPlaceholderManager, String, Object, ISession, IUnityContainer, IDbScope, Card, NullableGuid, CardTask, Boolean, IDictionaryString, Object, Boolean, CancellationToken) - метод

Заменяет плейсхолдеры в строке текста и возвращает строку текста с заменёнными плейсхолдерами или null, если при замене возникли ошибки. Вторым значением возвращает результат операции ValidationResult. Для более сложных вариантов замены плейсхолдеров используйте метод FindAndReplaceAsync(IPlaceholderManager, IPlaceholderDocument, DictionaryString, Object, FindingOptions, ReplacementOptions, CreateAliasPlaceholderContextFuncAsync, CreateTablePlaceholderContextFuncAsync, CreateViewPlaceholderContextFuncAsync, IExtensionContainer, CancellationToken).

Definition

Пространство имён: Tessa.Platform.Placeholders
Сборка: Tessa (в Tessa.dll) Версия: 4.0.4
C#
public static Task<(string text, ValidationResult? result)> ReplaceTextAsync(
	this IPlaceholderManager manager,
	string text,
	Object context = null,
	ISession session = null,
	IUnityContainer unityContainer = null,
	IDbScope dbScope = null,
	Card card = null,
	Guid? cardID = null,
	CardTask task = null,
	bool noCardInDb = false,
	IDictionary<string, Object?>? info = null,
	bool withScripts = false,
	CancellationToken cancellationToken = default
)

Параметры

manager  IPlaceholderManager
Объект, управляющий операциями с плейсхолдерами.
text  String
Текст, в котором заменяются плейсхолдеры. Значения null и пустая строка одинаковы.
context  Object  (Optional)
Контекст, в рамках которого выполняется замена плейсхолдеров, или null, если контекст отсутствует. Чаще всего используется контекст текущего расширения context.
session  ISession  (Optional)
Сессия, которая используется в плейсхолдерах, или null, если плейсхолдеры не получат информацию по сессии.
unityContainer  IUnityContainer  (Optional)
Контейнер Unity, к которому получат доступ плейсхолдеры для замены
dbScope  IDbScope  (Optional)
Объект, используемый для выполнения запросов для базы данных, или null, если замена плейсхолдеров выполняется без доступа к базе данных.
card  Card  (Optional)
Карточка со всеми загруженными секциями, для которой заменяются плейсхолдеры, или null, если карточка не была загружены или если замена выполняется без привязки к карточке.
cardID  NullableGuid  (Optional)
Идентификатор карточки, для которой заменяются плейсхолдеры, или null, если замена выполняется без привязки к карточке или идентификатор определяется по карточке. Если карточка задана в параметре в card, но не указан этот параметр, то идентификатор определяется на основании объекта карточки.
task  CardTask  (Optional)
Задание со всеми загруженными секциями, для которой заменяются плейсхолдеры, или null, если замена выполняется без привязки к заданию.
noCardInDb  Boolean  (Optional)
Признак того, что карточка отсутствует в базе данных, и не следует выполнять запросы для получения данных по карточке, которые не были найдены в объекте card.
info  IDictionaryString, Object  (Optional)
Дополнительная информация, добавляемая в info замены плейсхолдеров. Переданные параметры можно использовать для плейсхолдеров info и tinfo
withScripts  Boolean  (Optional)
Признак того, что требуется выполнить скомпилированные скрипты при замене плейсхолдеров. Негативно влияет на производительность, используйте при необходимости.
cancellationToken  CancellationToken  (Optional)
Объект, посредством которого можно отменить асинхронную задачу.

Возвращаемое значение

TaskValueTupleString, ValidationResult
Строка текста с заменёнными плейсхолдерами или null, если при замене возникли ошибки.

Примечание об использовании

В Visual Basic и C# этот метод можно вызывать как метод экземпляра для любого объекта типа IPlaceholderManager. При вызове метода для экземпляра следует опускать первый параметр. Дополнительные сведения см. в разделе Методы расширения (Visual Basic) или Методы расширения (Руководство по программированию в C#).

См. также