Crea elemento tabella

In questa guida passo passo, ti guideremo attraverso il processo di creazione di un elemento array usando Aspose.PDF per .NET. Aspose.PDF è una potente libreria che ti consente di manipolare i documenti PDF a livello di programmazione. Creare un elemento array è un requisito comune quando si generano PDF dinamici e Aspose.PDF offre un modo semplice ed efficiente per realizzarlo.

Analizziamo il codice e impariamo come creare un elemento array utilizzando Aspose.PDF per .NET.

Prerequisiti

Prima di iniziare, assicurati di avere quanto segue:

  1. Libreria Aspose.PDF per .NET installata.
  2. Conoscenza di base del linguaggio di programmazione C#.

Fase 1: Impostazione dell’ambiente

Per iniziare, apri il tuo ambiente di sviluppo C# e crea un nuovo progetto. Assicurati di aver aggiunto un riferimento alla libreria Aspose.PDF per .NET nel tuo progetto.

// Percorso verso la directory dei documenti.
string dataDir = "YOUR DOCUMENTS DIRECTORY";

Fase 2: Creazione del documento

Il primo passo è creare un nuovo documento PDF utilizzandoDocument classe.

// Crea il documento
Document document = new Document();
ITaggedContent taggedContent = document.TaggedContent;
taggedContent.SetTitle("Example Array");
taggedContent.SetLanguage("fr-FR");

Qui impostiamo anche il titolo e la lingua per il contenuto taggato.

Passaggio 3: creazione dell’elemento array

Successivamente, dobbiamo creare l’elemento array e aggiungerlo al documento. Iniziamo ottenendo l’elemento struttura radice, quindi creiamo un nuovo elemento tabella usandoCreateTableElement metodo.

// Ottieni l'elemento della struttura radice
StructureElement rootElement = taggedContent.RootElement;
TableElement tableElement = taggedContent.CreateTableElement();
rootElement.AppendChild(tableElement);
tableElement.Border = new BorderInfo(BorderSide.All, 1.2F, Color.DarkBlue);
TableTHeadElement tableTHeadElement = tableElement.CreateTHead();
TableTBodyElement tableTBodyElement = tableElement.CreateTBody();
TableTFootElement tableTFootElement = tableElement.CreateTFoot();
int rowCount = 50;
int colCount = 4;
int rowIndex;
int colIndex;
TableTRElement headTrElement = tableTHeadElement.CreateTR();
headTrElement.AlternativeText = "Header Row";
headTrElement.BackgroundColor = Color.LightGray;
for (colIndex = 0; colIndex < colCount; colIndex++)
{
TableTHElement theElement = headTrElement.CreateTH();
thElement.SetText(String.Format("Header {0}", colIndex));
theElement.BackgroundColor = Color.GreenYellow;
theElement.Border = new BorderInfo(BorderSide.All, 4.0F, Color.Gray);
theElement. IsNoBorder = true;
theElement.Margin = new MarginInfo(16.0, 2

.0, 8.0, 2.0);
theElement.Alignment = HorizontalAlignment.Right;
}
for (rowIndex = 0; rowIndex < rowCount; rowIndex++)
{
TableTRElement trElement = tableTBodyElement.CreateTR();
trElement.AlternativeText = String.Format("Row {0}", rowIndex);
for (colIndex = 0; colIndex < colCount; colIndex++)
{
int colSpan = 1;
int rowSpan = 1;
if (colIndex == 1 && rowIndex == 1)
{
colSpan = 2;
rowSpan = 2;
}
else if (colIndex == 2 && (rowIndex == 1 || rowIndex == 2))
{
keep on going;
}
else if (rowIndex == 2 && (colIndex == 1 || colIndex == 2))
{
keep on going;
}
TableTDElement tdelement = trElement.CreateTD();
tdElement.SetText(String.Format("Cell [{0}, {1}]", rowIndex, colIndex));
tdElement.BackgroundColor = Color.Yellow;
tdElement.Border = new BorderInfo(BorderSide.All, 4.0F, Color.Gray);
tdElement.IsNoBorder = false;
tdElement.Margin = new MarginInfo(8.0, 2.0, 8.0, 2.0);
tdElement.Alignment = HorizontalAlignment.Center;
TextState cellTextState = new TextState();
cellTextState.ForegroundColor = Color.DarkBlue;
cellTextState.FontSize = 7.5F;
cellTextState.FontStyle = FontStyles.Bold;
cellTextState.Font = FontRepository.FindFont("Arial");
tdElement. DefaultCellTextState = cellTextState;
tdElement.IsWordWrapped = true;
tdElement.VerticalAlignment = VerticalAlignment.Center;
tdElement.ColSpan = colSpan;
tdElement. RowSpan = rowSpan;
}
}
TableTRElement footTrElement = tableTFootElement.CreateTR();
footTrElement.AlternativeText = "Footline";
footTrElement.BackgroundColor = Color.LightSeaGreen;
for (colIndex = 0; colIndex < colCount; colIndex++)
{
TableTDElement tdElement = footTrElement.CreateTD();
tdElement.SetText(String.Format("Foot {0}", colIndex));
tdElement.Alignment = HorizontalAlignment.Center;
tdElement.StructureTextState.FontSize = 7F;
tdElement.StructureTextState.FontStyle = FontStyles.Bold;
}
StructureAttributes tableAttributes = tableElement.Attributes.GetAttributes(AttributeOwnerStandard.Table);
StructureAttribute summaryAttribute = new StructureAttribute(AttributeKey.Summary);
summaryAttribute.SetStringValue("The summary text for the table");
tableAttributes.SetAttribute(summaryAttribute);

// Salva il documento PDF taggato
document.Save(dataDir + "CreateTableElement.pdf");

// Controllo di conformità PDF/UA
document = new Document(dataDir + "CreateTableElement.pdf");
bool isPdfUaCompliance = document.Validate(dataDir + "table.xml", PdfFormat.PDF_UA_1);
Console.WriteLine(String.Format("PDF/UA Compliance: {0}", isPdfUaCompliance));

Esempio di codice sorgente per creare un elemento tabella utilizzando Aspose.PDF per .NET

// Percorso verso la directory dei documenti.
string dataDir = "YOUR DOCUMENT DIRECTORY";

// Crea documento
Document document = new Document();
ITaggedContent taggedContent = document.TaggedContent;
taggedContent.SetTitle("Example table");
taggedContent.SetLanguage("en-US");

// Ottieni l'elemento della struttura radice
StructureElement rootElement = taggedContent.RootElement;
TableElement tableElement = taggedContent.CreateTableElement();
rootElement.AppendChild(tableElement);
tableElement.Border = new BorderInfo(BorderSide.All, 1.2F, Color.DarkBlue);
TableTHeadElement tableTHeadElement = tableElement.CreateTHead();
TableTBodyElement tableTBodyElement = tableElement.CreateTBody();
TableTFootElement tableTFootElement = tableElement.CreateTFoot();
int rowCount = 50;
int colCount = 4;
int rowIndex;
int colIndex;
TableTRElement headTrElement = tableTHeadElement.CreateTR();
headTrElement.AlternativeText = "Head Row";
headTrElement.BackgroundColor = Color.LightGray;
for (colIndex = 0; colIndex < colCount; colIndex++)
{
	TableTHElement thElement = headTrElement.CreateTH();
	thElement.SetText(String.Format("Head {0}", colIndex));
	thElement.BackgroundColor = Color.GreenYellow;
	thElement.Border = new BorderInfo(BorderSide.All, 4.0F, Color.Gray);
	thElement.IsNoBorder = true;
	thElement.Margin = new MarginInfo(16.0, 2.0, 8.0, 2.0);
	thElement.Alignment = HorizontalAlignment.Right;
}
for (rowIndex = 0; rowIndex < rowCount; rowIndex++)
{
	TableTRElement trElement = tableTBodyElement.CreateTR();
	trElement.AlternativeText = String.Format("Row {0}", rowIndex);
	for (colIndex = 0; colIndex < colCount; colIndex++)
	{
		int colSpan = 1;
		int rowSpan = 1;
		if (colIndex == 1 && rowIndex == 1)
		{
			colSpan = 2;
			rowSpan = 2;
		}
		else if (colIndex == 2 && (rowIndex == 1 || rowIndex == 2))
		{
			continue;
		}
		else if (rowIndex == 2 && (colIndex == 1 || colIndex == 2))
		{
			continue;
		}
		TableTDElement tdElement = trElement.CreateTD();
		tdElement.SetText(String.Format("Cell [{0}, {1}]", rowIndex, colIndex));
		tdElement.BackgroundColor = Color.Yellow;
		tdElement.Border = new BorderInfo(BorderSide.All, 4.0F, Color.Gray);
		tdElement.IsNoBorder = false;
		tdElement.Margin = new MarginInfo(8.0, 2.0, 8.0, 2.0);
		tdElement.Alignment = HorizontalAlignment.Center;
		TextState cellTextState = new TextState();
		cellTextState.ForegroundColor = Color.DarkBlue;
		cellTextState.FontSize = 7.5F;
		cellTextState.FontStyle = FontStyles.Bold;
		cellTextState.Font = FontRepository.FindFont("Arial");
		tdElement.DefaultCellTextState = cellTextState;
		tdElement.IsWordWrapped = true;
		tdElement.VerticalAlignment = VerticalAlignment.Center;
		tdElement.ColSpan = colSpan;
		tdElement.RowSpan = rowSpan;
	}
}
TableTRElement footTrElement = tableTFootElement.CreateTR();
footTrElement.AlternativeText = "Foot Row";
footTrElement.BackgroundColor = Color.LightSeaGreen;
for (colIndex = 0; colIndex < colCount; colIndex++)
{
	TableTDElement tdElement = footTrElement.CreateTD();
	tdElement.SetText(String.Format("Foot {0}", colIndex));
	tdElement.Alignment = HorizontalAlignment.Center;
	tdElement.StructureTextState.FontSize = 7F;
	tdElement.StructureTextState.FontStyle = FontStyles.Bold;
}
StructureAttributes tableAttributes = tableElement.Attributes.GetAttributes(AttributeOwnerStandard.Table);
StructureAttribute summaryAttribute = new StructureAttribute(AttributeKey.Summary);
summaryAttribute.SetStringValue("The summary text for table");
tableAttributes.SetAttribute(summaryAttribute);

// Salva il documento PDF taggato
document.Save(dataDir + "CreateTableElement.pdf");

// Controllo della conformità PDF/UA
document = new Document(dataDir + "CreateTableElement.pdf");
bool isPdfUaCompliance = document.Validate(dataDir + "table.xml", PdfFormat.PDF_UA_1);
Console.WriteLine(String.Format("PDF/UA compliance: {0}", isPdfUaCompliance));

Conclusione

Hai imparato come creare un elemento array usando Aspose.PDF per .NET. Ora puoi generare documenti PDF con tabelle dinamiche usando questo metodo. Sentiti libero di esplorare altre funzionalità di Aspose.PDF per scoprire il suo pieno potenziale.

Domande frequenti

D: Cos’è un elemento array in un documento PDF e perché dovrei crearne uno utilizzando Aspose.PDF per .NET?

R: Un elemento array in un documento PDF rappresenta una raccolta strutturata di dati, spesso utilizzata per creare tabelle o griglie. Potresti dover creare un elemento array utilizzando Aspose.PDF per .NET quando generi PDF dinamici che richiedono una presentazione di dati strutturati, come informazioni tabulari o griglie.

D: In che modo Aspose.PDF per .NET semplifica il processo di creazione di un elemento array?

R: Aspose.PDF per .NET fornisce un set completo di classi e metodi che consentono di creare, personalizzare e gestire gli elementi array (tabelle) in un documento PDF in modo programmatico. Ciò elimina la necessità di manipolazione manuale dei PDF e semplifica la creazione di rappresentazioni di dati strutturati.

D: Quali sono i passaggi chiave per creare un elemento array utilizzando Aspose.PDF per .NET?

R: I passaggi chiave includono l’impostazione dell’ambiente, la creazione del documento, l’ottenimento dell’elemento struttura radice, la creazione di un elemento tabella, la definizione di righe e celle all’interno della tabella e la specificazione della formattazione e delle proprietà per gli elementi. L’esempio di codice fornito dimostra questi passaggi.

D: Quale ruolo ha iltaggedContent object play in creating an array element?

A: IltaggedContent oggetto, ricavato dal documentoTaggedContentproprietà, consente di definire la struttura del contenuto taggato all’interno del documento PDF. Ciò include la creazione e l’organizzazione di elementi array e dei loro elementi figlio in modo gerarchico.

D: In che modo il codice garantisce l’accessibilità e la semantica dell’elemento array creato?

A: Il codice imposta attributi comeAlternativeText, BackgroundColor, Border, Margin, Alignment , EColSpan per migliorare l’accessibilità e la semantica dell’elemento array. Questi attributi contribuiscono a una rappresentazione dei dati ben strutturata, informativa e visivamente accattivante.

D: Qual è l’importanza della conformità PDF/UA nel contesto della creazione di elementi array?

A: La conformità PDF/UA (Universal Accessibility) garantisce che i documenti PDF generati siano accessibili agli utenti con disabilità e soddisfino determinati standard di accessibilità. L’esempio di codice verifica la conformità PDF/UA utilizzandoValidate metodo, aiutandoti a creare documenti inclusivi e accessibili.

D: Posso personalizzare ulteriormente la formattazione e l’aspetto degli elementi dell’array?

R: Sì, puoi personalizzare la formattazione e l’aspetto degli elementi dell’array regolando attributi come il colore di sfondo, lo stile del bordo, la dimensione del carattere e l’allineamento. Aspose.PDF per .NET fornisce un’ampia gamma di proprietà per adattare la presentazione visiva alle tue esigenze.

D: Come posso ampliare queste conoscenze per creare strutture di tabelle più complesse o incorporare elementi array in documenti PDF più grandi?

R: È possibile ampliare questa conoscenza esplorando funzionalità aggiuntive di Aspose.PDF per .NET, come l’unione di più elementi array, la creazione di tabelle nidificate, l’aggiunta di intestazioni e piè di pagina e l’integrazione di elementi array in layout PDF più grandi. La documentazione e gli esempi della libreria forniscono indicazioni per questi scenari avanzati.

D: È possibile importare dati da fonti esterne, come database o fogli di calcolo, per popolare gli elementi dell’array?

R: Sì, puoi importare dati da fonti esterne per popolare gli elementi dell’array. Puoi usare tecniche di recupero e trasformazione dei dati in C# per recuperare dati da database, fogli di calcolo o altre fonti e quindi popolare di conseguenza gli elementi dell’array.

D: Come posso utilizzare le conoscenze acquisite in questo tutorial per migliorare la qualità e l’usabilità dei documenti PDF che creo a livello di programmazione?

R: Le conoscenze acquisite da questo tutorial ti consentono di creare elementi array (tabelle) strutturati e visivamente accattivanti nei documenti PDF. Incorporando queste tecniche, puoi migliorare la leggibilità, l’accessibilità e l’esperienza utente dei PDF generati dinamicamente, rendendoli più informativi e intuitivi.

Crea elementi di struttura albero Nome tag personalizzato