Aspose.Words for Java 24.12 Release Notes

public class ChartDataLabelCollection
{
    ...
    /// <summary>
    /// Gets or sets the position of the data labels.
    /// </summary>
    public ChartDataLabelPosition Position { get; set: }
}

public class ChartDataLabel
{
    ...
    /// <summary>
    /// Gets or sets the distance of the data label in points from the left edge of the chart or from the position
    /// specified by its <see cref="Position"/> property, depending on the value of the <see cref="LeftMode"/>
    /// property.
    /// </summary>
    /// <remarks>
    /// The value of the property changes proportionally if the chart shape is resized.
    /// The property cannot be set in a Word 2016 chart.
    /// </remarks>
    public double Left { get; set: }

    /// <summary>
    /// Gets or sets the interpretation mode of the <see cref="Left"/> property value: whether it sets the location
    /// of the data label from the left edge of the chart of from the position specified by its <see cref="Position"/>
    /// property.
    /// </summary>
    /// <remarks>
    /// The property cannot be set in a Word 2016 chart.
    /// </remarks>
    public ChartDataLabelLocationMode LeftMode { get; set: }

    /// <summary>
    /// Gets or sets the distance of the data label in points from the top edge of the chart or from the position
    /// specified by its <see cref="Position"/> property, depending on the value of the <see cref="TopMode"/>
    /// property.
    /// </summary>
    /// <remarks>
    /// The value of the property changes proportionally if the chart shape is resized.
    /// The property cannot be set in a Word 2016 chart.
    /// </remarks>
    public double Top { get; set: }

    /// <summary>
    /// Gets or sets the interpretation mode of the <see cref="Top"/> property value: whether it sets the location
    /// of the data label from the top edge of the chart of from the position specified by its <see cref="Position"/>
    /// property.
    /// </summary>
    /// <remarks>
    /// The property cannot be set in a Word 2016 chart.
    /// </remarks>
    public ChartDataLabelLocationMode TopMode { get; set: }

    /// <summary>
    /// Gets or sets the position of the data label.
    /// </summary>
    public ChartDataLabelPosition Position { get; set: }
}

/// <summary>
/// Specifies how the values that specify the location of a data label - the <see cref="ChartDataLabel.Left"/> and
/// <see cref="ChartDataLabel.Top"/> properties - are interpreted.
/// </summary>
public enum ChartDataLabelLocationMode
{
    /// <summary>
    /// The location of a data label is specified by an offset from the position defined by its
    /// <see cref="ChartDataLabel.Position"/> property.
    /// </summary>
    Offset,

    /// <summary>
    /// The location of a data label is specified using absolute coordinates, staring from the upper left corner
    /// of a chart.
    /// </summary>
    Absolute
}

/// <summary>
/// Specifies the position for a chart data label.
/// </summary>
/// <remarks>
/// Not all series types allow you to specify label positions. And those that do, do not support all values.
/// </remarks>
public enum ChartDataLabelPosition
{
    /// <summary>
    /// Specifies that a data label should be displayed centered on a data marker.
    /// </summary>
    Center,

    /// <summary>
    /// Specifies that a data label should be displayed to the left of a data marker.
    /// </summary>
    Left,

    /// <summary>
    /// Specifies that a data label should be displayed to the right of a data marker.
    /// </summary>
    Right,

    /// <summary>
    /// Specifies that a data label should be displayed above a data marker.
    /// </summary>
    Above,

    /// <summary>
    /// Specifies that a data label should be displayed below a data marker.
    /// </summary>
    Below,

    /// <summary>
    /// Specifies that a data label should be displayed inside the base of a data marker.
    /// </summary>
    InsideBase,

    /// <summary>
    /// Specifies that a data label should be displayed inside the end of a data marker.
    /// </summary>
    InsideEnd,

    /// <summary>
    /// Specifies that a data label should be displayed outside the end of a data marker.
    /// </summary>
    OutsideEnd,

    /// <summary>
    /// Specifies that a data label should be displayed in the most appropriate position.
    /// </summary>
    BestFit
}

/// <summary>
/// Specifies options that determine what items are removed during mail merge.
/// </summary>
public enum MailMergeCleanupOptions
{
    ...
    
    /// <summary>
    /// Specifies whether to remove from the document tables that contain mail merge regions that were removed using
    /// either the <see cref="RemoveUnusedRegions"/> or the <see cref="RemoveEmptyTableRows"/> option.
    /// </summary>
    /// <remarks>
    /// This option applies only to mail merge with regions.
    /// </remarks>
    RemoveEmptyTables = 0x40
}

/// <summary>
/// Translates the provided document into the specified target language.
/// This operation leverages the connected AI model for content translating.
/// </summary>
/// <param name="sourceDocument">The document to be translated.</param>
/// <param name="targetLanguage">The language into which the document will be translated.</param>
/// <returns>A new <see cref="Document"/> object containing the translated document.</returns>
Document Translate(Document sourceDocument, Language targetLanguage);

/// <summary>
/// Specifies the language into which the text will be translated using AI.
/// <seealso cref="IAiModelText.Translate"/>.
/// </summary>
public enum Language

/// <summary>
/// Compares the document with another document producing changes as number of edit and format revisions.
/// </summary>
/// <param name="v1">The original document.</param>
/// <param name="v2">The modified document.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="author">Initials of the author to use for revisions.</param>
/// <param name="dateTime">The date and time to use for revisions.</param>
public static void Compare(string v1, string v2, string outputFileName, string author, DateTime dateTime)

/// <summary>
/// Compares the document with another document producing changes as number of edit and format revisions.
/// </summary>
/// <param name="v1">The original document.</param>
/// <param name="v2">The modified document.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="saveFormat">The output's save format.</param>
/// <param name="author">Initials of the author to use for revisions.</param>
/// <param name="dateTime">The date and time to use for revisions.</param>
public static void Compare(string v1, string v2, string outputFileName, SaveFormat saveFormat, string author, DateTime dateTime)

/// <summary>
/// Compares the document with another document producing changes as number of edit and format revisions.
/// </summary>
/// <param name="v1">The original document.</param>
/// <param name="v2">The modified document.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="author">Initials of the author to use for revisions.</param>
/// <param name="dateTime">The date and time to use for revisions.</param>
/// <param name="compareOptions">Document comparison options.</param>
public static void Compare(string v1, string v2, string outputFileName, string author, DateTime dateTime, CompareOptions compareOptions)

/// <summary>
/// Compares the document with another document producing changes as number of edit and format revisions.
/// </summary>
/// <param name="v1">The original document.</param>
/// <param name="v2">The modified document.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="saveFormat">The output's save format.</param>
/// <param name="author">Initials of the author to use for revisions.</param>
/// <param name="dateTime">The date and time to use for revisions.</param>
/// <param name="compareOptions">Document comparison options.</param>
public static void Compare(string v1, string v2, string outputFileName, SaveFormat saveFormat, string author, DateTime dateTime, CompareOptions compareOptions)

/// <summary>
/// Compares the document with another document producing changes as number of edit and format revisions.
/// </summary>
/// <param name="v1">The original document.</param>
/// <param name="v2">The modified document.</param>
/// <param name="outputStream">The output stream.</param>
/// <param name="saveFormat">The output's save format.</param>
/// <param name="author">Initials of the author to use for revisions.</param>
/// <param name="dateTime">The date and time to use for revisions.</param>
public static void Compare(Stream v1, Stream v2, Stream outputStream, SaveFormat saveFormat, string author, DateTime dateTime)

/// <summary>
/// Compares the document with another document producing changes as number of edit and format revisions.
/// </summary>
/// <param name="v1">The original document.</param>
/// <param name="v2">The modified document.</param>
/// <param name="outputStream">The output stream.</param>
/// <param name="saveFormat">The output's save format.</param>
/// <param name="author">Initials of the author to use for revisions.</param>
/// <param name="dateTime">The date and time to use for revisions.</param>
/// <param name="compareOptions">Document comparison options.</param>
public static void Compare(Stream v1, Stream v2, Stream outputStream, SaveFormat saveFormat, string author, DateTime dateTime, Com

/// <summary>
/// Performs a mail merge operation for a single record.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="fieldNames">Array of merge field names. Field names are not case sensitive. If a field name that is not found in the document is encountered, it is ignored.</param>
/// <param name="fieldValues">Array of values to be inserted into the merge fields. Number of elements in this array must be the same as the number of elements in fieldNames.</param>
public static void Execute(string inputFileName, string outputFileName, string[] fieldNames, object[] fieldValues)

/// <summary>
/// Performs a mail merge operation for a single record.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="saveFormat">The output's save format.</param>
/// <param name="fieldNames">Array of merge field names. Field names are not case sensitive. If a field name that is not found in the document is encountered, it is ignored.</param>
/// <param name="fieldValues">Array of values to be inserted into the merge fields. Number of elements in this array must be the same as the number of elements in fieldNames.</param>
public static void Execute(string inputFileName, string outputFileName, SaveFormat saveFormat, string[] fieldNames, object[] fieldValues)

/// <summary>
/// Performs a mail merge operation for a single record.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="saveFormat">The output's save format.</param>
/// <param name="mailMergeOptions">Mail merge options.</param>
/// <param name="fieldNames">Array of merge field names. Field names are not case sensitive. If a field name that is not found in the document is encountered, it is ignored.</param>
/// <param name="fieldValues">Array of values to be inserted into the merge fields. Number of elements in this array must be the same as the number of elements in fieldNames.</param>
public static void Execute(string inputFileName, string outputFileName, SaveFormat saveFormat, MailMergeOptions mailMergeOptions, string[] fieldNames, object[] fieldValues)

/// <summary>
/// Performs a mail merge operation for a single record.
/// </summary>
/// <param name="inputStream">The input file stream.</param>
/// <param name="outputStream">The output file stream.</param>
/// <param name="saveFormat">The output's save format.</param>
/// <param name="fieldNames">Array of merge field names. Field names are not case sensitive. If a field name that is not found in the document is encountered, it is ignored.</param>
/// <param name="fieldValues">Array of values to be inserted into the merge fields. Number of elements in this array must be the same as the number of elements in fieldNames.</param>
public static void Execute(Stream inputStream, Stream outputStream, SaveFormat saveFormat, string[] fieldNames, object[] fieldValues)

/// <summary>
/// Performs a mail merge operation for a single record.
/// </summary>
/// <param name="inputStream">The input file stream.</param>
/// <param name="outputStream">The output file stream.</param>
/// <param name="saveFormat">The output's save format.</param>
/// <param name="mailMergeOptions">Mail merge options.</param>
/// <param name="fieldNames">Array of merge field names. Field names are not case sensitive. If a field name that is not found in the document is encountered, it is ignored.</param>
/// <param name="fieldValues">Array of values to be inserted into the merge fields. Number of elements in this array must be the same as the number of elements in fieldNames.</param>
public static void Execute(Stream inputStream, Stream outputStream, SaveFormat saveFormat, MailMergeOptions mailMergeOptions, string[] fieldNames, object[] fieldValues)

/// <summary>
/// Performs mail merge from a DataRow into the document.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="dataRow">Row that contains data to be inserted into mail merge fields. Field names are not case sensitive. If a field name that is not found in the document is encountered, it is ignored.</param>
public static void Execute(string inputFileName, string outputFileName, DataRow dataRow)

/// <summary>
/// Performs mail merge from a DataRow into the document.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="saveFormat">The output's save format.</param>
/// <param name="dataRow">Row that contains data to be inserted into mail merge fields. Field names are not case sensitive. If a field name that is not found in the document is encountered, it is ignored.</param>
public static void Execute(string inputFileName, string outputFileName, SaveFormat saveFormat, DataRow dataRow)

/// <summary>
/// Performs mail merge from a DataRow into the document.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="saveFormat">The output's save format.</param>
/// <param name="mailMergeOptions">Mail merge options.</param>
/// <param name="dataRow">Row that contains data to be inserted into mail merge fields. Field names are not case sensitive. If a field name that is not found in the document is encountered, it is ignored.</param>
public static void Execute(string inputFileName, string outputFileName, SaveFormat saveFormat, MailMergeOptions mailMergeOptions, DataRow dataRow)

/// <summary>
/// Performs a mail merge operation for a single record.
/// </summary>
/// <param name="inputStream">The input file stream.</param>
/// <param name="outputStream">The output file stream.</param>
/// <param name="saveFormat">The output's save format.</param>
/// <param name="dataRow">Row that contains data to be inserted into mail merge fields. Field names are not case sensitive. If a field name that is not found in the document is encountered, it is ignored.</param>
public static void Execute(Stream inputStream, Stream outputStream, SaveFormat saveFormat, DataRow dataRow)

/// <summary>
/// Performs a mail merge operation for a single record.
/// </summary>
/// <param name="inputStream">The input file stream.</param>
/// <param name="outputStream">The output file stream.</param>
/// <param name="saveFormat">The output's save format.</param>
/// <param name="mailMergeOptions">Mail merge options.</param>
/// <param name="dataRow">Row that contains data to be inserted into mail merge fields. Field names are not case sensitive. If a field name that is not found in the document is encountered, it is ignored.</param>
public static void Execute(Stream inputStream, Stream outputStream, SaveFormat saveFormat, MailMergeOptions mailMergeOptions, DataRow dataRow)

/// <summary>
/// Performs mail merge from a DataTable into the document.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="dataTable">Table that contains data to be inserted into mail merge fields. Field names are not case sensitive. If a field name that is not found in the document is encountered, it is ignored.</param>
public static void Execute(string inputFileName, string outputFileName, DataTable dataTable)

/// <summary>
/// Performs mail merge from a DataRow into the document.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="saveFormat">The output's save format.</param>
/// <param name="dataTable">Table that contains data to be inserted into mail merge fields. Field names are not case sensitive. If a field name that is not found in the document is encountered, it is ignored.</param>
public static void Execute(string inputFileName, string outputFileName, SaveFormat saveFormat, DataTable dataTable)

/// <summary>
/// Performs mail merge from a DataRow into the document.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="saveFormat">The output's save format.</param>
/// <param name="mailMergeOptions">Mail merge options.</param>
/// <param name="dataTable">Table that contains data to be inserted into mail merge fields. Field names are not case sensitive. If a field name that is not found in the document is encountered, it is ignored.</param>
public static void Execute(string inputFileName, string outputFileName, SaveFormat saveFormat, MailMergeOptions mailMergeOptions, DataTable dataTable)

/// <summary>
/// Performs a mail merge operation for a single record.
/// </summary>
/// <param name="inputStream">The input file stream.</param>
/// <param name="outputStream">The output file stream.</param>
/// <param name="saveFormat">The output's save format.</param>
/// <param name="dataTable">Table that contains data to be inserted into mail merge fields. Field names are not case sensitive. If a field name that is not found in the document is encountered, it is ignored.</param>
public static void Execute(Stream inputStream, Stream outputStream, SaveFormat saveFormat, DataTable dataTable)

/// <summary>
/// Performs a mail merge operation for a single record.
/// </summary>
/// <param name="inputStream">The input file stream.</param>
/// <param name="outputStream">The output file stream.</param>
/// <param name="saveFormat">The output's save format.</param>
/// <param name="mailMergeOptions">Mail merge options.</param>
/// <param name="dataTable">Table that contains data to be inserted into mail merge fields. Field names are not case sensitive. If a field name that is not found in the document is encountered, it is ignored.</param>
public static void Execute(Stream inputStream, Stream outputStream, SaveFormat saveFormat, MailMergeOptions mailMergeOptions, DataTable dataTable)

/// <summary>
/// Performs mail merge from a DataTable into the document with mail merge regions.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="dataTable">Data source for the mail merge operation. The table must have its TableName property set.</param>
public static void ExecuteWithRegions(string inputFileName, string outputFileName, DataTable dataTable)

/// <summary>
/// Performs mail merge from a DataTable into the document with mail merge regions.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="saveFormat">The output's save format.</param>
/// <param name="dataTable">Table that contains data to be inserted into mail merge fields. Field names are not case sensitive. If a field name that is not found in the document is encountered, it is ignored.</param>
public static void ExecuteWithRegions(string inputFileName, string outputFileName, SaveFormat saveFormat, DataTable dataTable)

/// <summary>
/// Performs mail merge from a DataTable into the document with mail merge regions.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="saveFormat">The output's save format.</param>
/// <param name="mailMergeOptions">Mail merge options.</param>
/// <param name="dataTable">Table that contains data to be inserted into mail merge fields. Field names are not case sensitive. If a field name that is not found in the document is encountered, it is ignored.</param>
public static void ExecuteWithRegions(string inputFileName, string outputFileName, SaveFormat saveFormat, MailMergeOptions mailMergeOptions, DataTable dataTable)

/// <summary>
/// Performs mail merge from a DataTable into the document with mail merge regions.
/// </summary>
/// <param name="inputStream">The input file stream.</param>
/// <param name="outputStream">The output file stream.</param>
/// <param name="saveFormat">The output's save format.</param>
/// <param name="dataTable">Table that contains data to be inserted into mail merge fields. Field names are not case sensitive. If a field name that is not found in the document is encountered, it is ignored.</param>
public static void ExecuteWithRegions(Stream inputStream, Stream outputStream, SaveFormat saveFormat, DataTable dataTable)

/// <summary>
/// Performs a mail merge operation for a single record.
/// </summary>
/// <param name="inputStream">The input file stream.</param>
/// <param name="outputStream">The output file stream.</param>
/// <param name="saveFormat">The output's save format.</param>
/// <param name="mailMergeOptions">Mail merge options.</param>
/// <param name="dataTable">Table that contains data to be inserted into mail merge fields. Field names are not case sensitive. If a field name that is not found in the document is encountered, it is ignored.</param>
public static void ExecuteWithRegions(Stream inputStream, Stream outputStream, SaveFormat saveFormat, MailMergeOptions mailMergeOptions, DataTable dataTable)

/// <summary>
/// Performs mail merge from a DataSet into a document with mail merge regions.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="dataSet">DataSet that contains data to be inserted into mail merge fields.</param>
public static void ExecuteWithRegions(string inputFileName, string outputFileName, DataSet dataSet)

/// <summary>
/// Performs mail merge from a DataTable into the document with mail merge regions.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="saveFormat">The output's save format.</param>
/// <param name="dataSet">DataSet that contains data to be inserted into mail merge fields.</param>
public static void ExecuteWithRegions(string inputFileName, string outputFileName, SaveFormat saveFormat, DataSet dataSet)

/// <summary>
/// Performs mail merge from a DataTable into the document with mail merge regions.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="saveFormat">The output's save format.</param>
/// <param name="mailMergeOptions">Mail merge options.</param>
/// <param name="dataSet">DataSet that contains data to be inserted into mail merge fields.</param>
public static void ExecuteWithRegions(string inputFileName, string outputFileName, SaveFormat saveFormat, MailMergeOptions mailMergeOptions, DataSet dataSet)

/// <summary>
/// Performs mail merge from a DataTable into the document with mail merge regions.
/// </summary>
/// <param name="inputStream">The input file stream.</param>
/// <param name="outputStream">The output file stream.</param>
/// <param name="saveFormat">The output's save format.</param>
/// <param name="dataSet">DataSet that contains data to be inserted into mail merge fields.</param>
public static void ExecuteWithRegions(Stream inputStream, Stream outputStream, SaveFormat saveFormat, DataSet dataSet)

/// <summary>
/// Performs a mail merge operation for a single record.
/// </summary>
/// <param name="inputStream">The input file stream.</param>
/// <param name="outputStream">The output file stream.</param>
/// <param name="saveFormat">The output's save format.</param>
/// <param name="mailMergeOptions">Mail merge options.</param>
/// <param name="dataSet">DataSet that contains data to be inserted into mail merge fields.</param>
public static void ExecuteWithRegions(Stream inputStream, Stream outputStream, SaveFormat saveFormat, MailMergeOptions mailMergeO

/// <summary>
/// Replaces all occurrences of a specified character string pattern with a replacement string.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="pattern">A string to be replaced.</param>
/// <param name="replacement">A string to replace all occurrences of pattern.</param>
/// <returns>The number of replacements made.</returns>
public static int Replace(string inputFileName, string outputFileName, string pattern, string replacement)

/// <summary>
/// Replaces all occurrences of a specified character string pattern with a replacement string.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="saveFormat">The save format.</param>
/// <param name="pattern">A string to be replaced.</param>
/// <param name="replacement">A string to replace all occurrences of pattern.</param>
/// <returns>The number of replacements made.</returns>
public static int Replace(string inputFileName, string outputFileName, SaveFormat saveFormat, string pattern, string replacement)

/// <summary>
/// Replaces all occurrences of a specified character string pattern with a replacement string.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="saveFormat">The save format.</param>
/// <param name="pattern">A string to be replaced.</param>
/// <param name="replacement">A string to replace all occurrences of pattern.</param>
/// <param name="options"><see cref="FindReplaceOptions"/> object to specify additional options.</param>
/// <returns>The number of replacements made.</returns>
public static int Replace(string inputFileName, string outputFileName, SaveFormat saveFormat, string pattern, string replacement, FindReplaceOptions options)

/// <summary>
/// Replaces all occurrences of a specified character string pattern with a replacement string.
/// </summary>
/// <param name="inputStream">The input stream.</param>
/// <param name="outputStream">The output stream.</param>
/// <param name="saveFormat">The save format.</param>
/// <param name="pattern">A string to be replaced.</param>
/// <param name="replacement">A string to replace all occurrences of pattern.</param>
/// <returns>The number of replacements made.</returns>
public static int Replace(Stream inputStream, Stream outputStream, SaveFormat saveFormat, string pattern, string replacement)

/// <summary>
/// Replaces all occurrences of a specified character string pattern with a replacement string.
/// </summary>
/// <param name="inputStream">The input stream.</param>
/// <param name="outputStream">The output stream.</param>
/// <param name="saveFormat">The save format.</param>
/// <param name="pattern">A string to be replaced.</param>
/// <param name="replacement">A string to replace all occurrences of pattern.</param>
/// <param name="options"><see cref="FindReplaceOptions"/> object to specify additional options.</param>
/// <returns>The number of replacements made.</returns>
public static int Replace(Stream inputStream, Stream outputStream, SaveFormat saveFormat, string pattern, string replacement, FindReplaceOptions options)

/// <summary>
/// Replaces all occurrences of a specified character string pattern with a replacement string.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="pattern">A regular expression pattern used to find matches.</param>
/// <param name="replacement">A string to replace all occurrences of pattern.</param>
/// <returns>The number of replacements made.</returns>
public static int Replace(string inputFileName, string outputFileName, Regex pattern, string replacement)

/// <summary>
/// Replaces all occurrences of a specified character string pattern with a replacement string.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="saveFormat">The save format.</param>
/// <param name="pattern">A regular expression pattern used to find matches.</param>
/// <param name="replacement">A string to replace all occurrences of pattern.</param>
/// <returns>The number of replacements made.</returns>
public static int Replace(string inputFileName, string outputFileName, SaveFormat saveFormat, Regex pattern, string replacement)

/// <summary>
/// Replaces all occurrences of a specified character string pattern with a replacement string.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="saveFormat">The save format.</param>
/// <param name="pattern">A regular expression pattern used to find matches.</param>
/// <param name="replacement">A string to replace all occurrences of pattern.</param>
/// <param name="options"><see cref="FindReplaceOptions"/> object to specify additional options.</param>
/// <returns>The number of replacements made.</returns>
public static int Replace(string inputFileName, string outputFileName, SaveFormat saveFormat, Regex pattern, string replacement, FindReplaceOptions options)

/// <summary>
/// Replaces all occurrences of a specified character string pattern with a replacement string.
/// </summary>
/// <param name="inputStream">The input stream.</param>
/// <param name="outputStream">The output stream.</param>
/// <param name="saveFormat">The save format.</param>
/// <param name="pattern">A regular expression pattern used to find matches.</param>
/// <param name="replacement">A string to replace all occurrences of pattern.</param>
/// <returns>The number of replacements made.</returns>
public static int Replace(Stream inputStream, Stream outputStream, SaveFormat saveFormat, Regex pattern, string replacement)

/// <summary>
/// Replaces all occurrences of a specified character string pattern with a replacement string.
/// </summary>
/// <param name="inputStream">The input stream.</param>
/// <param name="outputStream">The output stream.</param>
/// <param name="saveFormat">The save format.</param>
/// <param name="pattern">A regular expression pattern used to find matches.</param>
/// <param name="replacement">A string to replace all occurrences of pattern.</param>
/// <param name="options"><see cref="FindReplaceOptions"/> object to specify additional options.</param>
/// <returns>The number of replacements made.</returns>
public static int Replace(Stream inputStream, Stream outputStream, SaveFormat saveFormat, Regex pattern, string replacement, Fi

/// <summary>
/// Populates the specified template document with data from the specified source making it a ready report.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="data">A data source object.</param>
public static void BuildReport(string inputFileName, string outputFileName, object data)

/// <summary>
/// Populates the specified template document with data from the specified source making it a ready report.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="data">A data source object.</param>
/// <param name="reportBuilderOptions">Additional report build options.</param>
public static void BuildReport(string inputFileName, string outputFileName, object data, ReportBuilderOptions reportBuilderOptions)

/// <summary>
/// Populates the specified template document with data from the specified source making it a ready report.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="saveFormat">The output's save format.</param>
/// <param name="data">A data source object.</param>
public static void BuildReport(string inputFileName, string outputFileName, SaveFormat saveFormat, object data)

/// <summary>
/// Populates the specified template document with data from the specified source making it a ready report.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="saveFormat">The output's save format.</param>
/// <param name="data">A data source object.</param>
/// <param name="reportBuilderOptions">Additional report build options.</param>
public static void BuildReport(string inputFileName, string outputFileName, SaveFormat saveFormat, object data, ReportBuilderOptions reportBuilderOptions)

/// <summary>
/// Populates the specified template document with data from the specified source making it a ready report.
/// </summary>
/// <param name="inputStream">The input file stream.</param>
/// <param name="outputStream">The output file stream.</param>
/// <param name="saveFormat">The output's save format.</param>
/// <param name="data">A data source object.</param>
public static void BuildReport(Stream inputStream, Stream outputStream, SaveFormat saveFormat, object data)

/// <summary>
/// Populates the specified template document with data from the specified source making it a ready report.
/// </summary>
/// <param name="inputStream">The input file stream.</param>
/// <param name="outputStream">The output file stream.</param>
/// <param name="saveFormat">The output's save format.</param>
/// <param name="data">A data source object.</param>
/// <param name="reportBuilderOptions">Additional report build options.</param>
public static void BuildReport(Stream inputStream, Stream outputStream, SaveFormat saveFormat, object data, ReportBuilderOptions reportBuilderOptions)

/// <summary>
/// Populates the specified template document with data from the specified source making it a ready report.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="data">A data source object.</param>
/// <param name="dataSourceName">A name to reference the data source object in the template.</param>
public static void BuildReport(string inputFileName, string outputFileName, object data, string dataSourceName)

/// <summary>
/// Populates the specified template document with data from the specified source making it a ready report.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="data">A data source object.</param>
/// <param name="dataSourceName">A name to reference the data source object in the template.</param>
/// <param name="reportBuilderOptions">Additional report build options.</param>
public static void BuildReport(string inputFileName, string outputFileName, object data, string dataSourceName, ReportBuilderOptions reportBuilderOptions)

/// <summary>
/// Populates the specified template document with data from the specified source making it a ready report.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="saveFormat">The output's save format.</param>
/// <param name="data">A data source object.</param>
/// <param name="dataSourceName">A name to reference the data source object in the template.</param>
public static void BuildReport(string inputFileName, string outputFileName, SaveFormat saveFormat, object data, string dataSourceName)

/// <summary>
/// Populates the specified template document with data from the specified source making it a ready report.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="saveFormat">The output's save format.</param>
/// <param name="data">A data source object.</param>
/// <param name="dataSourceName">A name to reference the data source object in the template.</param>
/// <param name="reportBuilderOptions">Additional report build options.</param>
public static void BuildReport(string inputFileName, string outputFileName, SaveFormat saveFormat, object data, string dataSourceName, ReportBuilderOptions reportBuilderOptions)

/// <summary>
/// Populates the specified template document with data from the specified source making it a ready report.
/// </summary>
/// <param name="inputStream">The input file stream.</param>
/// <param name="outputStream">The output file stream.</param>
/// <param name="saveFormat">The output's save format.</param>
/// <param name="data">A data source object.</param>
/// <param name="dataSourceName">A name to reference the data source object in the template.</param>
public static void BuildReport(Stream inputStream, Stream outputStream, SaveFormat saveFormat, object data, string dataSourceName)

/// <summary>
/// Populates the specified template document with data from the specified source making it a ready report.
/// </summary>
/// <param name="inputStream">The input file stream.</param>
/// <param name="outputStream">The output file stream.</param>
/// <param name="saveFormat">The output's save format.</param>
/// <param name="data">A data source object.</param>
/// <param name="dataSourceName">A name to reference the data source object in the template.</param>
/// <param name="reportBuilderOptions">Additional report build options.</param>
public static void BuildReport(Stream inputStream, Stream outputStream, SaveFormat saveFormat, object data, string dataSourceName, ReportBuilderOptions reportBuilderOptions)

/// <summary>
/// Populates the specified template document with data from the specified sources making it a ready report.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="data">An array of data source objects.</param>
/// <param name="dataSourceNames">An array of names to reference the data source objects within the template.</param>
public static void BuildReport(string inputFileName, string outputFileName, object[] data, string[] dataSourceNames)

/// <summary>
/// Populates the specified template document with data from the specified sources making it a ready report.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="data">An array of data source objects.</param>
/// <param name="dataSourceNames">An array of names to reference the data source objects within the template.</param>
/// <param name="reportBuilderOptions">Additional report build options.</param>
public static void BuildReport(string inputFileName, string outputFileName, object[] data, string[] dataSourceNames, ReportBuilderOptions reportBuilderOptions)

/// <summary>
/// Populates the specified template document with data from the specified sources making it a ready report.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="saveFormat">The output's save format.</param>
/// <param name="data">An array of data source objects.</param>
/// <param name="dataSourceNames">An array of names to reference the data source objects within the template.</param>
public static void BuildReport(string inputFileName, string outputFileName, SaveFormat saveFormat, object[] data, string[] dataSourceNames)

/// <summary>
/// Populates the specified template document with data from the specified sources making it a ready report.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="saveFormat">The output's save format.</param>
/// <param name="data">An array of data source objects.</param>
/// <param name="dataSourceNames">An array of names to reference the data source objects within the template.</param>
/// <param name="reportBuilderOptions">Additional report build options.</param>
public static void BuildReport(string inputFileName, string outputFileName, SaveFormat saveFormat, object[] data, string[] dataSourceNames, ReportBuilderOptions reportBuilderOptions)

/// <summary>
/// Populates the specified template document with data from the specified sources making it a ready report.
/// </summary>
/// <param name="inputStream">The input file stream.</param>
/// <param name="outputStream">The output file stream.</param>
/// <param name="saveFormat">The output's save format.</param>
/// <param name="data">An array of data source objects.</param>
/// <param name="dataSourceNames">An array of names to reference the data source objects within the template.</param>
public static void BuildReport(Stream inputStream, Stream outputStream, SaveFormat saveFormat, object[] data, string[] dataSourceNames)

/// <summary>
/// Populates the specified template document with data from the specified sources making it a ready report.
/// </summary>
/// <param name="inputStream">The input file stream.</param>
/// <param name="outputStream">The output file stream.</param>
/// <param name="saveFormat">The output's save format.</param>
/// <param name="data">An array of data source objects.</param>
/// <param name="dataSourceNames">An array of names to reference the data source objects within the template.</param>
/// <param name="reportBuilderOptions">Additional report build options.</param>
public static void BuildReport(Stream inputStream, Stream outputStream, SaveFormat saveFormat, object[] data, string[] dataSourceNames, ReportBuilderOptions reportBuilderOptions)

/// <summary>
/// Removes empty pages from the document and saves the output.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <returns>List of page numbers has been considered as blank and removed.</returns>
public static List<int> RemoveBlankPages(string inputFileName, string outputFileName)

/// <summary>
/// Removes empty pages from the document and saves the output in the specified format.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="saveFormat">The save format.</param>
/// <returns>List of page numbers has been considered as blank and removed.</returns>
public static List<int> RemoveBlankPages(string inputFileName, string outputFileName, SaveFormat saveFormat)

/// <summary>
/// Removes empty pages from the document and saves the output in the specified format.
/// </summary>
/// <param name="inputStream">The input stream.</param>
/// <param name="outputStream">The output stream.</param>
/// <param name="saveFormat">The save format.</param>
/// <returns>List of page numbers has been considered as blank and removed.</returns>
public static List<int> RemoveBlankPages(Stream inputStream, Stream outputStream, SaveFormat saveFormat)

/// <summary>
/// Extracts a specified range of pages from a document file and saves the extracted pages to a new file. The output file format is determined by the extension of the output file name.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="startPageIndex">The zero-based index of the first page to extract.</param>
/// <param name="pageCount">Number of pages to be extracted.</param>
public static void ExtractPages(string inputFileName, string outputFileName, int startPageIndex, int pageCount)

/// <summary>
/// Extracts a specified range of pages from a document file and saves the extracted pages to a new file using the specified save format.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="saveFormat">The save format.</param>
/// <param name="startPageIndex">The zero-based index of the first page to extract.</param>
/// <param name="pageCount">Number of pages to be extracted.</param>
public static void ExtractPages(string inputFileName, string outputFileName, SaveFormat saveFormat, int startPageIndex, int pageCount)

/// <summary>
/// Extracts a specified range of pages from a document stream and saves the extracted pages to an output stream using the specified save format.
/// </summary>
/// <param name="inputStream">The input stream.</param>
/// <param name="outputStream">The output stream.</param>
/// <param name="saveFormat">The save format.</param>
/// <param name="startPageIndex">The zero-based index of the first page to extract.</param>
/// <param name="pageCount">Number of pages to be extracted.</param>
public static void ExtractPages(Stream inputStream, Stream outputStream, SaveFormat saveFormat, int startPageIndex, int pageCount)

/// <summary>
/// Splits a document into multiple parts based on the specified split options and saves the resulting parts to files. The output file format is determined by the extension of the output file name.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name used to generate file name for document parts using rule "outputFile_partIndex.extension"</param>
/// <param name="options">Document split options.</param>
public static void Split(string inputFileName, string outputFileName, SplitOptions options)

/// <summary>
/// Splits a document into multiple parts based on the specified split options and saves the resulting parts to files in the specified save format.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name used to generate file name for document parts using rule "outputFile_partIndex.extension"</param>
/// <param name="saveFormat">The save format.</param>
/// <param name="options">Document split options.</param>
public static void Split(string inputFileName, string outputFileName, SaveFormat saveFormat, SplitOptions options)

/// <summary>
/// Splits the document into parts.
/// </summary>
/// <param name="inputStream">The input stream.</param>
/// <param name="saveFormat">The save format.</param>
/// <param name="options">Document split options.</param>
public static Stream[] Split(Stream inputStream, SaveFormat saveFormat, SplitOptions options)

/// <summary>
/// Adds Text watermark into the document.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="watermarkText">Text that is displayed as a watermark.</param>
public static void SetText(string inputFileName, string outputFileName, string watermarkText)

/// <summary>
/// Adds Text watermark into the document.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="saveFormat">The save format.</param>
/// <param name="watermarkText">Text that is displayed as a watermark.</param>
public static void SetText(string inputFileName, string outputFileName, SaveFormat saveFormat, string watermarkText)

/// <summary>
/// Adds Text watermark into the document.
/// </summary>
/// <param name="inputStream">The input stream.</param>
/// <param name="outputStream">The output stream.</param>
/// <param name="saveFormat">The save format.</param>
/// <param name="watermarkText">Text that is displayed as a watermark.</param>
public static void SetText(Stream inputStream, Stream outputStream, SaveFormat saveFormat, string watermarkText)

/// <summary>
/// Adds Text watermark into the document.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="watermarkText">Text that is displayed as a watermark.</param>
/// <param name="options">Defines additional options for the text watermark.</param>
public static void SetText(string inputFileName, string outputFileName, string watermarkText, TextWatermarkOptions options)

/// <summary>
/// Adds Text watermark into the document.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="saveFormat">The save format.</param>
/// <param name="watermarkText">Text that is displayed as a watermark.</param>
/// <param name="options">Defines additional options for the text watermark.</param>
public static void SetText(string inputFileName, string outputFileName, SaveFormat saveFormat, string watermarkText, TextWatermarkOptions options)

/// <summary>
/// Adds Text watermark into the document.
/// </summary>
/// <param name="inputStream">The input stream.</param>
/// <param name="outputStream">The output stream.</param>
/// <param name="saveFormat">The save format.</param>
/// <param name="watermarkText">Text that is displayed as a watermark.</param>
/// <param name="options">Defines additional options for the text watermark.</param>
public static void SetText(Stream inputStream, Stream outputStream, SaveFormat saveFormat, string watermarkText, TextWatermarkOptions options)

/// <summary>
/// Adds Image watermark into the document.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="watermarkImageFileName">Image that is displayed as a watermark.</param>
public static void SetImage(string inputFileName, string outputFileName, string watermarkImageFileName)

/// <summary>
/// Adds Image watermark into the document.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="saveFormat">The save format.</param>
/// <param name="watermarkImageFileName">Image that is displayed as a watermark.</param>
public static void SetImage(string inputFileName, string outputFileName, SaveFormat saveFormat, string watermarkImageFileName)

/// <summary>
/// Adds Image watermark into the document.
/// </summary>
/// <param name="inputStream">The input stream.</param>
/// <param name="outputStream">The output stream.</param>
/// <param name="saveFormat">The save format.</param>
/// <param name="watermarkImage">Image that is displayed as a watermark.</param>
public static void SetImage(Stream inputStream, Stream outputStream, SaveFormat saveFormat, Image watermarkImage)

/// <summary>
/// Adds Image watermark into the document.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="watermarkImageFileName">Image that is displayed as a watermark.</param>
/// <param name="options">Defines additional options for the image watermark.</param>
public static void SetImage(string inputFileName, string outputFileName, string watermarkImageFileName, ImageWatermarkOptions options)

/// <summary>
/// Adds Image watermark into the document.
/// </summary>
/// <param name="inputFileName">The input file name.</param>
/// <param name="outputFileName">The output file name.</param>
/// <param name="saveFormat">The save format.</param>
/// <param name="watermarkImageFileName">Image that is displayed as a watermark.</param>
/// <param name="options">Defines additional options for the image watermark.</param>
public static void SetImage(string inputFileName, string outputFileName, SaveFormat saveFormat, string watermarkImageFileName, ImageWatermarkOptions options)

/// <summary>
/// Adds Image watermark into the document.
/// </summary>
/// <param name="inputStream">The input stream.</param>
/// <param name="outputStream">The output stream.</param>
/// <param name="saveFormat">The save format.</param>
/// <param name="watermarkImage">Image that is displayed as a watermark.</param>
/// <param name="options">Defines additional options for the image watermark.</param>
public static void SetImage(Stream inputStream, Stream outputStream, SaveFormat saveFormat, Image watermarkImage, ImageWatermarkOptions options)