Interface ITextTemplatingEngineHost

A interface do host que transforma os modelos de texto. Isso está disponível para processadores de diretriz e também pode ser acessado pelos modelos de texto.

Namespace:  Microsoft.VisualStudio.TextTemplating
Assembly:  Microsoft.VisualStudio.TextTemplating.Interfaces.10.0 (em Microsoft.VisualStudio.TextTemplating.Interfaces.10.0.dll)

Sintaxe

'Declaração
<CLSCompliantAttribute(True)> _
Public Interface ITextTemplatingEngineHost

[CLSCompliantAttribute(true)]
public interface ITextTemplatingEngineHost

[CLSCompliantAttribute(true)]
public interface class ITextTemplatingEngineHost

[<CLSCompliantAttribute(true)>]
type ITextTemplatingEngineHost =  interface end

public interface ITextTemplatingEngineHost

O tipo ITextTemplatingEngineHost expõe os membros a seguir.

Propriedades

	Nome	Descrição
	StandardAssemblyReferences	Obtém uma lista de referências de assembly.
	StandardImports	Obtém uma lista de namespaces.
	TemplateFile	Obtém o caminho e o nome do modelo de texto que está sendo processado.

Início

Métodos

	Nome	Descrição
	GetHostOption	Chamado pelo mecanismo para pedir o valor de uma opção especificada.Retorne null se você não souber.
	LoadIncludeText	Adquire o texto que corresponde a uma solicitação para incluir um arquivo de modelo de partes do texto.
	LogErrors	Recebe a uma coleção de erros e avisos do mecanismo de transformação.
	ProvideTemplatingAppDomain	Fornece um domínio de aplicativo para executar a classe de transformação gerada.
	ResolveAssemblyReference	Permite que um host fornecer informações adicionais sobre a localização de um assembly.
	ResolveDirectiveProcessor	Retorna o tipo de processador de diretriz, dado seu nome amigável.
	ResolveParameterValue	Resolve o valor de um parâmetro para um processador de diretriz se o parâmetro não for especificado no texto do modelo.
	ResolvePath	Permite que um host fornecer um caminho completo, o dado um nome de arquivo ou caminho relativo.
	SetFileExtension	Informa ao host a extensão de nome de arquivo que é esperada para a saída de texto gerado.
	SetOutputEncoding	Informa ao host a codificação é esperada para a saída de texto gerado.

Início

Comentários

Um host usa um arquivo de modelo de texto como entrada e produz um arquivo de texto como saída. Um host típico é o TextTemplatingFileGenerator ferramenta que transforma os modelos em um Visual Studio project. Ele chama um ou mais processadores de diretriz para lidar com diferentes tipos de modelo. Os membros desta interface são acessíveis para os processadores de diretriz e o código do modelo de texto. O mecanismo de modelo de texto controla esse processo e interage com um host e um ou mais processadores de diretriz. Para saber mais sobre esses componentes, consulte Modelos de texto T4 e de geração de código.

Para fazer com que o host acessível para o código de um modelo de texto, defina a hostspecific parâmetro da diretiva de modelo. Por exemplo:

<#@template language="c#" hostspecific="true" #>
<# // This template is specific to the TextTemplatingFileGenerator host,
   // which transforms templates in a Visual Studio project. #>
These are the projects in this solution:
<#=this.Host.ResolveParameterValue("-", "-", "projects") #>

Se você quiser usar os modelos de texto fora Visual Studio ou com ferramentas personalizadas, você pode escrever um host personalizado, a implementação dessa interface. Para um exemplo, consulte Demonstra Passo a passo: A criação de um Host de modelo de texto personalizado.

Consulte também

Referência

Namespace Microsoft.VisualStudio.TextTemplating

Outros recursos

Demonstra Passo a passo: A criação de um Host de modelo de texto personalizado

Modelos de texto T4 e de geração de código

Histórico de alterações