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文件添加附件只需兩步：

1. 使用要添加的文件和文件描述建立一個文件具體化對象。
2. 使用集合的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);

從PDF文檔獲取全部附件

---

使用Aspose.PDF，能夠從PDF文檔中獲取全部附件。當想要將文檔與PDF分開保存，或者須要剝離PDF附件時，這很是有用。

要從PDF文件中獲取全部附件只需兩步：

1. 循環遍歷文檔對象的EmbeddedFiles集合。EmbeddedFiles集合包含全部附件。這個集合的每一個元素都表示一個文件具體化對象。Foreach循環經過EmbeddedFiles集合的每次迭代都返回一個filspeciification對象。
2. 一旦對象可用，檢索全部附加文件的屬性或文件自己。

如下代碼段顯示如何從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();

 

從PDF文檔中刪除全部附件

---

Aspose.PDF能夠從PDF文件中刪除附件。PDF文檔的附件保存在Document對象的EmbeddedFiles集合中。

要刪除與PDF文件關聯的全部附件需兩步：

1. 調用EmbeddedFiles集合的Delete方法。
2. 使用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); }

-- 未完待續 --

更多教程資源可關注ASPOSE技術交流QQ羣（642018183）哦~歡迎交流討論！