Metodo ITextTemplatingEngineHost.LogErrors

Riceve un insieme di errori e avvisi dal motore di trasformazione.

Spazio dei nomi:  Microsoft.VisualStudio.TextTemplating
Assembly:  Microsoft.VisualStudio.TextTemplating.Interfaces.10.0 (in Microsoft.VisualStudio.TextTemplating.Interfaces.10.0.dll)

Sintassi

'Dichiarazione
Sub LogErrors ( _
    errors As CompilerErrorCollection _
)

void LogErrors(
    CompilerErrorCollection errors
)

void LogErrors(
    CompilerErrorCollection^ errors
)

abstract LogErrors : 
        errors:CompilerErrorCollection -> unit 

function LogErrors(
    errors : CompilerErrorCollection
)

Parametri

• errors
  Tipo: System.CodeDom.Compiler.CompilerErrorCollection
  Oggetto CompilerErrorCollection passato all'host dal motore.

Note

Il motore chiama questo metodo quando termina l'elaborazione di un modello di testo e passa gli eventuali errori che si sono verificati all'host. L'host può decidere come visualizzarli. Ad esempio, l'host può visualizzare gli errori nell'interfaccia utente o può scriverli in un file.

Esempi

Questo metodo può essere chiamato da un modello di testo. È necessario impostare hostspecific="true".

<#@ template hostspecific="true" language="C#" #>
<#@ output extension=".txt" #>
<#@ import namespace="System.CodeDom.Compiler" #>
<#
  string message = "test message";
  this.Host.LogErrors(new CompilerErrorCollection() 
    { new CompilerError(
       this.Host.TemplateFile, // Identify the source of the error.
       0, 0, "0",   // Line, column, error ID.
       message) }); // Message displayed in error window.
#>

Nell'esempio di codice seguente viene illustrata una possibile implementazione di un host personalizzato. In questo esempio, gli errori vengono archiviati in una proprietà. Il programma che crea un'istanza di questo host personalizzato accederà alla proprietà e scriverà gli errori in Console. Questo esempio di codice fa parte di un esempio più esaustivo. Per l'esempio completo, vedere Walkthrough: Creating a Custom Text Template Host.

private CompilerErrorCollection errorsValue;

public void LogErrors(CompilerErrorCollection errors)
{
    errorsValue = errors;
}

Private errorsValue As CompilerErrorCollection

Public Sub LogErrors(ByVal errors As System.CodeDom.Compiler.CompilerErrorCollection) Implements Microsoft.VisualStudio.TextTemplating.ITextTemplatingEngineHost.LogErrors

    errorsValue = errors
End Sub

Nell'esempio di codice seguente viene illustrata un'altra possibile implementazione di un host personalizzato. In questo esempio, gli errori vengono scritti immediatamente in Console.

public void LogErrors(CompilerErrorCollection errors)
{
    foreach (CompilerError error in errors)
    {
        Console.WriteLine(error.ToString());
    }
}

Public Sub LogErrors(ByVal errors As System.CodeDom.Compiler.CompilerErrorCollection) Implements Microsoft.VisualStudio.TextTemplating.ITextTemplatingEngineHost.LogErrors

    Dim e As CompilerError
    For Each e In errors
        Console.WriteLine(e.ToString())
    Next
End Sub

Sicurezza di .NET Framework

• Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

ITextTemplatingEngineHost Interfaccia

Spazio dei nomi Microsoft.VisualStudio.TextTemplating

CompilerErrorCollection

Altre risorse

Walkthrough: Creating a Custom Text Template Host