Tipo de controle preferido em documento do Word

Este artigo fornece um guia passo a passo sobre como usar o recurso de tipo de controle preferencial com Aspose.Words for .NET. Explicaremos cada parte do código em detalhes. Ao final deste tutorial, você poderá entender como especificar o tipo de controle preferido ao carregar um documento HTML.

Antes de começar, certifique-se de ter instalado e configurado a biblioteca Aspose.Words for .NET em seu projeto. Você pode encontrar a biblioteca e as instruções de instalação no site do Aspose.

Passo 1: Defina o código HTML

Para começar, você precisa definir o código HTML que deseja carregar como documento. Neste exemplo, definimos umhtml variável contendo o código HTML de um seletor com opções.

const string html=@"
<html>
<select name='ComboBox' size='1'>
<option value='val1'>item1</option>
<option value='val2'></option>
</select>
</html>
";

Etapa 2: definir opções de carregamento de HTML

A seguir, criamos umHtmlLoadOptions objeto e definir oPreferredControlTypepropriedade paraHtmlControlType.StructuredDocumentTag. Isso diz ao Aspose.Words para usar StructuredDocumentTags para representar HTML durante o carregamento.

HtmlLoadOptions loadOptions = new HtmlLoadOptions { PreferredControlType = HtmlControlType.StructuredDocumentTag };

Etapa 3: carregue e salve o documento

Nós usamos oDocument classe para carregar código HTML de um fluxo de memória com as opções de carregamento definidas anteriormente. Em seguida, salvamos o documento no diretório especificado com o.docxformato de arquivo.

Document doc = new Document(new MemoryStream(Encoding.UTF8.GetBytes(html)), loadOptions);
doc.Save(dataDir + "WorkingWithHtmlLoadOptions.PreferredControlType.docx", SaveFormat.Docx);

Exemplo de código-fonte para tipo de controle preferido com Aspose.Words for .NET

	
	const string html = @"
		<html>
			<select name='ComboBox' size='1'>
				<option value='val1'>item1</option>
				<option value='val2'></option>                        
			</select>
		</html>
	";
	// O caminho para o diretório de documentos.
	string dataDir = "YOUR DOCUMENT DIRECTORY";
	HtmlLoadOptions loadOptions = new HtmlLoadOptions { PreferredControlType = HtmlControlType.StructuredDocumentTag };

	Document doc = new Document(new MemoryStream(Encoding.UTF8.GetBytes(html)), loadOptions);

	doc.Save(dataDir + "WorkingWithHtmlLoadOptions.PreferredControlType.docx", SaveFormat.Docx);

Isso é tudo ! Você especificou com sucesso o tipo de controle preferido ao carregar um documento HTML com Aspose.Words for .NET.

Conclusão

Seguindo este guia passo a passo, você aprendeu como usar o recurso “Tipo de controle preferencial” no Aspose.Words for .NET para especificar o tipo de controle desejado ao carregar um documento HTML. Configurando oPreferredControlTypepropriedade paraHtmlControlType.StructuredDocumentTag permite que Aspose.Words use StructuredDocumentTags (SDT) para melhor representação e processamento de conteúdo HTML. Você também pode explorar outros tipos de controle para atender às suas necessidades específicas. O uso desse recurso ajuda a garantir o manuseio preciso e eficiente de documentos HTML em seu aplicativo C# com Aspose.Words.

Perguntas frequentes sobre o tipo de controle preferido em documentos do Word

P: Qual é o recurso “Tipo de controle preferencial” no Aspose.Words for .NET?

R: O recurso “Tipo de controle preferencial” permite especificar o tipo preferido de controle para representar elementos HTML ao carregar um documento HTML. Ajuda na seleção do tipo de controle apropriado para melhor representação e processamento do conteúdo HTML.

P: Como defino o tipo de controle preferido ao carregar um documento HTML?

R: Para definir o tipo de controle preferido, você precisa criar umHtmlLoadOptions objeto e definir seuPreferredControlType propriedade ao desejadoHtmlControlType . No exemplo fornecido,HtmlControlType.StructuredDocumentTag é usado.

P: Qual é a importância de usar StructuredDocumentTags (SDT) como tipo de controle preferencial?

R: StructuredDocumentTags (SDT) são elementos baseados em XML que podem ser usados para representar conteúdo e controles complexos em um documento do Word. Usar SDTs como tipo de controle preferencial pode fornecer melhor compatibilidade e representação do conteúdo HTML.

P: Como posso garantir que Aspose.Words use o tipo de controle preferido ao carregar o documento HTML?

R: Ao definir oPreferredControlTypepropriedade paraHtmlControlType.StructuredDocumentTagconforme mostrado no código-fonte de exemplo, Aspose.Words usará SDTs para representar elementos HTML ao carregar o documento.

P: Posso usar outros tipos de controle como opção preferida?

R: Sim, além deHtmlControlType.StructuredDocumentTag , Aspose.Words for .NET oferece suporte a outros tipos de controle, comoHtmlControlType.ContentControleHtmlControlType.CustomXmlMarkup.