PDF文件管理控件Aspose.PDF for .NET使用教程（一）：使用附件
Aspose.PDF for .NET是一种高PDF处理和解析API，用于在跨平台应用程序中执行文档管理和操作任务。API可以轻松用于生成、修改、转换、渲染、保护和打印PDF文档，而无需使用Adobe Acrobat。此外，API还提供PDF压缩选项，表格创建和操作，图形和图像功能，广泛的超链接功能，印章和水印任务，扩展的安全控制和自定义字体处理。
【下载体验Aspose.PDF for .NET最新版】
在接下来的系列教程中，将为开发者带来Aspose.PDF for .NET的一系列使用教程，例如进行文档间的转换，如何标记PDF文件，如何使用表单和图表等等。
附件可以包含各种各样的信息，并且可以是各种文件类型。想要向PDF文件添加附件只需两步：
使用要添加的文件和文件描述创建一个文件具体化对象。使用集合的Add方法将Filspeciification对象添加到文档对象的EmbeddedFiles集合中。
该EmbeddedFiles集合包含PDF文件中的所有附件。以下代码段显示了如何在PDF文档中添加附件：
//文档目录的路径。
string dataDir=RunExamples。GetDataDir_AsposePdf_Attachments（）;
//打开文档
Document pdfDocument=new Document(dataDir + "AddAttachment.pdf" );
//设置要添加为附件的新文件
FileSpecification fileSpecification=new FileSpecification（dataDir + “ test.txt ”，“ Sample text file ”）;
//添加附件到文档的附件集合
pdfDocument.EmbeddedFiles.Add(fileSpecification);
dataDir=dataDir + "AddAttachment_out.pdf" ;
//保存新输出
pdfDocument.Save(dataDir);
使用Aspose.PDF，可以从PDF文档中获取所有附件。当想要将文档与PDF分开保存，或者需要剥离PDF附件时，这非常有用。
要从PDF文件中获取所有附件只需两步：
循环遍历文档对象的EmbeddedFiles集合。EmbeddedFiles集合包含所有附件。这个集合的每个元素都表示一个文件具体化对象。Foreach循环通过EmbeddedFiles集合的每次迭代都返回一个filspeciification对象。一旦对象可用，检索所有附加文件的属性或文件本身。
以下代码段显示如何从PDF文档中获取所有附件：
//文档目录的路径
string dataDir=RunExamples.GetDataDir_AsposePdf_Attachments();
//打开文档
Document pdfDocument=new Document(dataDir + "GetAlltheAttachments.pdf" );
//获取嵌入式文件集合
EmbeddedFileCollection embeddedFiles=pdfDocument.EmbeddedFiles;
//获取嵌入文件的数量
Console.WriteLine( "Total files : {0}" , embeddedFiles.Count);
int count=1 ;
//遍历集合以获取所有附件
foreach (FileSpecification fileSpecification in embeddedFiles)
{
Console.WriteLine( "Name: {0}" , fileSpecification.Name);
Console.WriteLine( "Description: {0}" ,
fileSpecification.Description);
Console.WriteLine( "Mime Type: {0}" , fileSpecification.MIMEType);
//检查参数对象是否包含参数
if (fileSpecification.Params !=null )
{
Console.WriteLine( "CheckSum: {0}" ,
fileSpecification.Params.CheckSum);
Console.WriteLine( "Creation Date: {0}" ,
fileSpecification.Params.CreationDate);
Console.WriteLine( "Modification Date: {0}" ,
fileSpecification.Params.ModDate);
Console.WriteLine( "Size: {0}" , fileSpecification.Params.Size);
}
//获取附件并写入文件或流
byte[] fileContent=new byte[fileSpecification.Contents.Length];
fileSpecification.Contents.Read(fileContent, 0 ,
fileContent.Length);
FileStream fileStream=new FileStream(dataDir + count + "_out" + ".txt" ,
FileMode.Create);
fileStream.Write(fileContent, 0 , fileContent.Length);
fileStream.Close();
count+=1 ;
为了获得单独的附件，我们可以在文档实例的EmbeddedFiles对象中指定附件索引。请尝试使用以下代码片段。
//文档目录的路径
string dataDir=RunExamples.GetDataDir_AsposePdf_Attachments();
//打开文档
Document pdfDocument=new Document(dataDir + "GetIndividualAttachment.pdf" );
//获取特定的嵌入文件
FileSpecification fileSpecification=pdfDocument.EmbeddedFiles[ 1 ];
//获取文件属性
Console.WriteLine( "Name: {0}" , fileSpecification.Name);
Console.WriteLine( "Description: {0}" , fileSpecification.Description);
Console.WriteLine( "Mime Type: {0}" , fileSpecification.MIMEType);
//检查参数对象是否包含参数
if (fileSpecification.Params !=null )
{
Console.WriteLine( "CheckSum: {0}" ,
fileSpecification.Params.CheckSum);
Console.WriteLine( "Creation Date: {0}" ,
fileSpecification.Params.CreationDate);
Console.WriteLine( "Modification Date: {0}" ,
fileSpecification.Params.ModDate);
Console.WriteLine( "Size: {0}" , fileSpecification.Params.Size);
}
//获取附件并写入文件或流
byte[] fileContent=new byte[fileSpecification.Contents.Length];
fileSpecification.Contents.Read(fileContent, 0 , fileContent.Length);
FileStream fileStream=new FileStream(dataDir + "test_out" + ".txt" , FileMode.Create);
fileStream.Write(fileContent, 0 , fileContent.Length);
fileStream.Close();
Aspose.PDF可以从PDF文件中删除附件。PDF文档的附件保存在Document对象的EmbeddedFiles集合中。
要删除与PDF文件关联的所有附件需两步：
调用EmbeddedFiles集合的Delete方法。使用Document对象的Save方法保存更新的文件。
//文档目录的路径
string dataDir=RunExamples.GetDataDir_AsposePdf_Attachments();
//打开文档
Document pdfDocument=new Document(dataDir + "DeleteAllAttachments.pdf" );
//删除所有附件
pdfDocument.EmbeddedFiles.Delete();
dataDir=dataDir + "DeleteAllAttachments_out.pdf" ;
//保存更新的文件
pdfDocument.Save(dataDir);
附件信息保存在filspeciification对象中，与文档对象的EmbeddedFiles集合中的其他附件一起收集。文件化对象提供了获取hteattchment信息的方法，例如:
Name - 文件名。Description - 文件描述。MIMEType - 文件的MIME类型。Params-有关文件的参数信息。
要获取这些参数，请首先确保该Params属性不为null。EmbeddedFiles使用foreach循环遍历集合中的所有附件，或通过指定其索引值获取单个附件。以下代码段显示了如何获取有关特定附件的信息：
//文档目录的路径
string dataDir=RunExamples.GetDataDir_AsposePdf_Attachments();
//打开文档
Document pdfDocument=new Document(dataDir + "GetAttachmentInfo.pdf" );
//获取特定的嵌入文件
FileSpecification fileSpecification=pdfDocument.EmbeddedFiles[ 1 ];
//获取文件属性
Console.WriteLine( "Name: {0}" , fileSpecification.Name);
Console.WriteLine( "Description: {0}" , fileSpecification.Description);
Console.WriteLine( "Mime Type: {0}" , fileSpecification.MIMEType);
//检查参数对象是否包含参数
if (fileSpecification.Params !=null )
{
Console.WriteLine( "CheckSum: {0}" ,
fileSpecification.Params.CheckSum);
Console.WriteLine( "Creation Date: {0}" ,
fileSpecification.Params.CreationDate);
Console.WriteLine( "Modification Date: {0}" ,
fileSpecification.Params.ModDate);
Console.WriteLine( "Size: {0}" , fileSpecification.Params.Size);
}
-- 未完待续 --
