Udostępnij za pośrednictwem

Metoda ITextTemplatingEngineHost.ResolveParameterValue —

  • Artykuł

Eliminuje wartość parametru dla procesora w dyrektywie, jeśli nie określono parametru w tekście szablonu.

Przestrzeń nazw:  Microsoft.VisualStudio.TextTemplating
Zestaw:  Microsoft.VisualStudio.TextTemplating.Interfaces.10.0 (w Microsoft.VisualStudio.TextTemplating.Interfaces.10.0.dll)

Składnia

'Deklaracja
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

Parametry

  • directiveId
    Typ: System.String
    Identyfikator wywołania dyrektywy, do której należy dany parametr.Ten identyfikator disambiguates powtarzające się wywołania do tej samej dyrektywy z tego samego szablonu tekstu.
  • processorName
    Typ: System.String
    Nazwa procesora w dyrektywie, do której należy dany dyrektywy.
  • parameterName
    Typ: System.String
    Nazwa jest rozpoznawana jako parametr.

Wartość zwracana

Typ: System.String
A String , reprezentuje wartość parametru rozwiązane.

Uwagi

Tę metodę można wywołać przez przetwórcę w dyrektywie lub z pola Kod szablonu tekstu, aby uzyskać wartości z hosta tekst szablonu.Zazwyczaj procesor dyrektywa będzie wywoływać metody, aby uzyskać wartość domyślna dla parametru dyrektywy.

Na przykład w hosta, który jest wykonywany w narzędziu wiersza polecenia TextTransform.exe, Metoda ta pobiera wartości z –a opcji wiersza polecenia.Aby uzyskać więcej informacji, zobacz Generowanie plików przy użyciu narzędzia TextTransform.

Przykłady

Poniższy przykład kodu pokazuje możliwe wdrożenie niestandardowych hosta.Poniższy przykład kodu jest częścią większej przykład.Na przykład pełną, zobacz Instruktaż: Tworzenie hosta szablon niestandardowy tekst.

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

Zabezpieczenia programu .NET Framework

Zobacz też

Informacje

ITextTemplatingEngineHost Interfejs

Przestrzeń nazw Microsoft.VisualStudio.TextTemplating

Inne zasoby

Instruktaż: Tworzenie hosta szablon niestandardowy tekst