ITextTemplatingEngineHost.ResolveParameterValue - метод

Статья
08/11/2011

Получает имя параметра процессора директив с указанным значением, если этот параметр не указан в тексте шаблона.

Пространство имен: Microsoft.VisualStudio.TextTemplating
Сборка: Microsoft.VisualStudio.TextTemplating.Interfaces.10.0 (в Microsoft.VisualStudio.TextTemplating.Interfaces.10.0.dll)

Синтаксис

'Декларация
Function ResolveParameterValue ( _
    directiveId As String, _
    processorName As String, _
    parameterName As String _
) As String

string ResolveParameterValue(
    string directiveId,
    string processorName,
    string parameterName
)

String^ ResolveParameterValue(
    String^ directiveId, 
    String^ processorName, 
    String^ parameterName
)

abstract ResolveParameterValue : 
        directiveId:string * 
        processorName:string * 
        parameterName:string -> string

function ResolveParameterValue(
    directiveId : String, 
    processorName : String, 
    parameterName : String
) : String

Параметры

directiveId
Тип: System.String
Идентификатор вызова директивы, к которому относится параметр.Этот идентификатор устраняет неоднозначность в повторных вызовах одной и той же директивы из одного и того же текстового шаблона.

processorName
Тип: System.String
Имя процессора директивы, к которому относится директива.

parameterName
Тип: System.String
Имя параметра, для которого выполняется анализ.

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

Тип: System.String
Объект String, представляющий разрешенное значение параметра.

Заметки

Этот метод может быть вызван обработчиком директив или из кода текстового шаблона, чтобы получить значения из узла текстового шаблона. Как правило, обработчик директив вызывает этот метод для получения значения параметра директивы по умолчанию.

Например, в основном приложении, выполняемом в утилите командной строки TextTransform.exe, этот метод извлекает значения из параметра командной строки –a. Дополнительные сведения см. в разделе Создание файлов с помощью служебной программы TextTransform.

Примеры

В следующем примере кода показана возможная реализация пользовательского основного приложения. Данный пример кода является частью большего примера. Полный пример см. в разделе Пошаговое руководство. Создание пользовательского хост-класса для текстовых шаблонов.

public string ResolveParameterValue(string directiveId, string processorName, string parameterName)
{
    if (directiveId == null)
    {
        throw new ArgumentNullException("the directiveId cannot be null");
    }
    if (processorName == null)
    {
        throw new ArgumentNullException("the processorName cannot be null");
    }
    if (parameterName == null)
    {
        throw new ArgumentNullException("the parameterName cannot be null");
    }

    //code to provide "hard-coded" parameter values goes here
    //this code depends on the directive processors this host will interact with

    //if we cannot do better - return the empty string
    return String.Empty;
}

Public Function ResolveParameterValue(ByVal directiveId As String, ByVal processorName As String, ByVal parameterName As String) As String Implements Microsoft.VisualStudio.TextTemplating.ITextTemplatingEngineHost.ResolveParameterValue

    If directiveId Is Nothing Then
        Throw New ArgumentNullException("the directiveId cannot be null")
    End If
    If processorName Is Nothing Then
        Throw New ArgumentNullException("the processorName cannot be null")
    End If
    If parameterName Is Nothing Then
        Throw New ArgumentNullException("the parameterName cannot be null")
    End If

    'code to provide "hard-coded" parameter values goes here
    'this code depends on the directive processors this host will interact with

    'if we cannot do better - return the empty string
    Return String.Empty
End Function

Безопасность платформы .NET Framework

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

ITextTemplatingEngineHost Интерфейс

Microsoft.VisualStudio.TextTemplating - пространство имен

Другие ресурсы

Пошаговое руководство. Создание пользовательского хост-класса для текстовых шаблонов

Поделиться через