• java.lang.Object
• com.aspose.words.LoadOptions

例：

显示如何加载加密的Microsoft Word文档。

文件doc;

    //如果我们尝试打开没有密码的加密文档，则Aspose.Words会引发异常。
    Assert.assertThrows（IncorrectPasswordException.class，（）->新文档（getMyDir（）+“ Encrypted.docx”））;

    //加载此类文档时，密码将使用LoadOptions对象传递给文档的构造函数。
    LoadOptions选项=新的LoadOptions（“ docPassword”）;

    //有两种使用LoadOptions对象加载加密文档的方式。
    // 1-按文件名从本地文件系统加载文档。
    doc =新文档（getMyDir（）+“ Encrypted.docx”，选项）；

    // 2-从流中加载文档。
    InputStream流=新的FileInputStream（getMyDir（）+“ Encrypted.docx”）;
    尝试
            {
        doc =新文档（流，选项）；
}
    最后{if（stream！= null）stream.close（）; }

使用默认值初始化此类的新实例。使用指定的密码初始化此类的新实例以加载加密文档的快捷方式。用于将属性设置为指定值的此类的新实例初始化的快捷方式。获取或设置在需要时将用于将文档中找到的相对URI解析为绝对URI的字符串。可以为null或空字符串。默认为空。获取或设置是否转换图元文件（世界货币基金组织 要么 电动势 ）图片到 ng 图片格式。

• getConvertMetafilesToPng / setConvertMetafilesToPng

  public boolean getConvertMetafilesToPng（）/ public void setConvertMetafilesToPng（boolean value）
  

   
  图元文件（世界货币基金组织 要么 电动势 ）是未压缩的图像格式，有时需要大量RAM来保存和处理文档。此选项允许将所有图元文件图像转换为ng 关于文档加载。请注意-将矢量图形转换为光栅会降低图像质量。

获取或设置是否将带有EquationXML的形状转换为Office Math对象。

• getConvertShapeToOfficeMath / setConvertShapeToOfficeMath

  public boolean getConvertShapeToOfficeMath（）/ public void setConvertShapeToOfficeMath（boolean value）
  

   

如果未在文档中指定编码，则获取或设置将用于加载HTML，TXT或CHM文档的编码。可以为null。默认为空。

• getEncoding / setEncoding

  公共java.nio.charset.Charset getEncoding（）/公共无效setEncoding（java.nio.charset.Charset值）
  

   

  仅在加载HTML，TXT或CHM文档时使用此属性。

  如果未在文档中指定编码，并且此属性为null，则系统将尝试自动检测编码。

允许指定文档字体设置。

• getFontSettings / setFontSettings

  public FontSettings  getFontSettings（）/ public void setFontSettings（FontSettings  value）
  

   

  加载某些格式时，Aspose.Words可能需要解析字体。例如，在加载HTML文档时，Aspose.Words可以解析字体以执行字体后备。

  如果设置为null，则为默认静态字体设置 FontSettings.DefaultInstance 将会被使用。

  默认值为空。

获取在加载文档时将使用的语言首选项。

• getLanguagePreferences

  公共LanguagePreferences  getLanguagePreferences（）
  

   

指定要加载的文档的格式。默认是加载格式。该属性的值为LoadFormat整数常量。

• getLoadFormat / setLoadFormat

  public int getLoadFormat（）/ public void setLoadFormat（int value）
  

   

  建议您指定 加载格式值，然后让Aspose.Words自动检测文件格式。如果知道要加载的文档的格式，则可以显式指定格式，这将通过自动检测格式带来的开销而略微减少加载时间。如果您指定了显式加载格式，但结果却是错误的，则将调用自动检测并再次尝试加载文件。

  例：

  显示打开html文档时如何指定基本URI。

  //如果要加载.html文档，其中包含通过相对URI链接的图像
  //当图片位于其他位置时，我们需要将相对URI解析为绝对的URI
  //通过创建HtmlLoadOptions并提供基本URI
  HtmlLoadOptions loadOptions =新的HtmlLoadOptions（LoadFormat.HTML，“”，getImageDir（））;
  
  Assert.assertEquals（LoadFormat.HTML，loadOptions.getLoadFormat（））;
  
  Document doc = new Document（getMyDir（）+“ Missing image.html”，loadOptions）;
  
  //当图片在输入.html中损坏时，已在我们的基本URI中成功找到它
  形状imageShape =（Shape）doc.getChildNodes（NodeType.SHAPE，true）.get（0）;
  Assert.assertTrue（imageShape.isImage（））;
  
  //图片将在输出文档中正确显示
  doc.save（getArtifactsDir（）+“ HtmlLoadOptions.BaseUri.docx”）;

允许指定文档加载过程应与特定的MS Word版本匹配。默认值为MsWordVersion.WORD_2007该属性的值为MsWordVersion整数常量。

• getMswVersion / setMswVersion

  public int getMswVersion（）/ public void setMswVersion（int value）
  

   
  不同的Word版本在加载过程中处理文档内容和格式的某些方面可能会略有不同，这可能导致文档对象模型之间的细微差异。

获取或设置用于打开加密文档的密码。可以为null或空字符串。默认为空。

• getPassword / setPassword

  公共java.lang.String getPassword（）/公共无效setPassword（java.lang.String值）
  

   

  您需要知道密码才能打开加密的文档。如果文档未加密，请将其设置为null或空字符串。

  例：

  显示如何对加密的文档文件进行签名。

  //从PKCS＃12存储区创建X.509证书，该存储区应包含私钥。
  CertificateHolder certificateHolder = CertificateHolder.create（getMyDir（）+“ morzal.pfx”，“ aw”）;
  
  //创建注释，日期和解密密码，这些密码将与我们的新数字签名一起使用。
  SignOptions signOptions = new SignOptions（）;
  {
  signOptions.setComments（“ Comment”）;
      signOptions.setSignTime（new Date（））;
  signOptions.setDecryptionPassword（“ docPassword”）;
  }
  
  //为未签名的输入文档设置本地系统文件名，为其新的数字签名副本设置输出文件名。
  字符串inputFileName = getMyDir（）+“ Encrypted.docx”;
  字符串outputFileName = getArtifactsDir（）+“ DigitalSignatureUtil.DecryptionPassword.docx”;
  
  DigitalSignatureUtil.sign（inputFileName，outputFileName，certificateHolder，signOptions）;

获取或设置在读取Microsoft Word格式时是否保留INCLUDEPICTURE字段。默认值为false。

• getPreserveIncludePictureField / setPreserveIncludePictureField

  public boolean getPreserveIncludePictureField（）/ public void setPreserveIncludePictureField（boolean value）
  

   

  默认情况下，INCLUDEPICTURE字段将转换为形状对象。如果需要保留字段，例如，如果您希望以编程方式进行更新，则可以覆盖该字段。但是请注意，这种方法在Aspose.Words中并不常见。自行承担使用风险。

  可能的一种使用情况可能是使用MERGEFIELD作为子字段来动态更改图片的源路径。在这种情况下，您需要将INCLUDEPICTURE保留在模型中。

允许控制从HTML，MHTML导入文档时如何加载外部资源（图像，样式表）。

• getResourceLoadingCallback / setResourceLoadingCallback

  公共IResourceLoadingCallback  getResourceLoadingCallback（）/公共无效setResourceLoadingCallback（IResourceLoadingCallback 值）
  

   

读取文档时允许使用临时文件。默认情况下，此属性为null并且不使用任何临时文件。

• getTempFolder / setTempFolder

  公共java.lang.String getTempFolder（）/公共无效setTempFolder（java.lang.String值）
  

   

  该文件夹必须存在并且可写，否则将引发异常。

  读取完成后，Aspose.Words会自动删除所有临时文件。

  例：

  显示如何使用临时文件加载文档。

  //请注意，这种方法可以减少内存使用，但会降低速度。
  LoadOptions loadOptions = new LoadOptions（）;
  loadOptions.setTempFolder（“ C：\\ TempFolder \\”）;
  
  //确保目录存在并加载。
  新File（loadOptions.getTempFolder（））。mkdir（）;
  
  Document doc = new Document（getMyDir（）+“ Document.docx”，loadOptions）;

指定是否使用dirty属性更新字段。

• getUpdateDirtyFields / setUpdateDirtyFields

  public boolean getUpdateDirtyFields（）/ public void setUpdateDirtyFields（boolean value）
  

   

  例：

  显示如何使用特殊属性更新字段结果。

  Document doc = new Document（）;
  DocumentBuilder builder =新的DocumentBuilder（doc）;
  
  //提供文档的内置“ Author”属性值，然后在字段中显示它。
  doc.getBuiltInDocumentProperties（）。setAuthor（“ John Doe”）;
  FieldAuthor字段=（FieldAuthor）builder.insertField（FieldType.FIELD_AUTHOR，true）;
  
  Assert.assertFalse（field.isDirty（））;
  Assert.assertEquals（“ John Doe”，field.getResult（））;
  
  //更新属性。该字段仍显示旧值。
  doc.getBuiltInDocumentProperties（）。setAuthor（“ John＆Jane Doe”）;
  
  Assert.assertEquals（“ John Doe”，field.getResult（））;
  
  //由于该字段的值已过期，因此我们可以将其标记为“脏”。
  //此值将保持过期，直到我们使用Field.Update（）方法手动更新该字段为止。
  field.isDirty（true）;
  
  OutputStream docStream = new FileOutputStream（getArtifactsDir（）+“ Filed.UpdateDirtyFields.docx”）;
  尝试{
      //如果我们保存而未调用更新方法，
      //该字段将继续在输出文档中显示过期值。
      doc.save（docStream，SaveFormat.DOCX）;
  
      // LoadOptions对象具有更新所有字段的选项
      //加载文档时标记为“脏”。
      LoadOptions options = new LoadOptions（）;
      options.setUpdateDirtyFields（updateDirtyFields）;
  
      doc = new Document（String.valueOf（docStream），options）;
  
      Assert.assertEquals（“ John＆Jane Doe”，doc.getBuiltInDocumentProperties（）。getAuthor（））;
  
      field =（FieldAuthor）doc.getRange（）。getFields（）。get（0）;
  
      //这样更新脏字段会自动将其“ IsDirty”标志设置为false。
      如果（updateDirtyFields）
      {
          Assert.assertEquals（“ John＆Jane Doe”，field.getResult（））;
          Assert.assertFalse（field.isDirty（））;
      }其他{
          Assert.assertEquals（“ John Doe”，field.getResult（））;
          Assert.assertTrue（field.isDirty（））;
      }
  }最后{
      如果（docStream！= null）docStream.close（）;
  }

在加载操作期间被调用，当检测到可能导致数据或格式保真度损失的问题时。

• getWarningCallback / setWarningCallback

  公共IWarningCallback  getWarningCallback（）/公共无效setWarningCallback（IWarningCallback 值）

com.aspose.words 类LoadOptions