PrintQueue.MergeAndValidatePrintTicket 方法

参考

定义

命名空间:: System.Printing

程序集:: System.Printing.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

合并两种 PrintTicket，保证所得的 PrintTicket 有效且不请求打印机所不支持的任何打印功能。

重载

MergeAndValidatePrintTicket(PrintTicket, PrintTicket)	合并两种 PrintTicket，保证所得的 PrintTicket 有效且不请求打印机所不支持的任何打印功能。
MergeAndValidatePrintTicket(PrintTicket, PrintTicket, PrintTicketScope)	合并两种 PrintTicket，保证所得的 PrintTicket 有效，不请求打印机所不支持的任何打印功能，且限于指定的作用域。

MergeAndValidatePrintTicket(PrintTicket, PrintTicket)

合并两种 PrintTicket，保证所得的 PrintTicket 有效且不请求打印机所不支持的任何打印功能。

public:
 System::Printing::ValidationResult MergeAndValidatePrintTicket(System::Printing::PrintTicket ^ basePrintTicket, System::Printing::PrintTicket ^ deltaPrintTicket);

public System.Printing.ValidationResult MergeAndValidatePrintTicket (System.Printing.PrintTicket basePrintTicket, System.Printing.PrintTicket deltaPrintTicket);

member this.MergeAndValidatePrintTicket : System.Printing.PrintTicket * System.Printing.PrintTicket -> System.Printing.ValidationResult

Public Function MergeAndValidatePrintTicket (basePrintTicket As PrintTicket, deltaPrintTicket As PrintTicket) As ValidationResult

参数

basePrintTicket: PrintTicket

第一种打印票证。

deltaPrintTicket: PrintTicket

第二种打印票证。它可以是 null。

ValidationResult

一个 ValidationResult，其中包括合并的 PrintTicket 和一个指示，该指示表明是否为了保证可行性而不得不更改其任何设置。

例外

ArgumentException

至少有一个输入打印票证无效。

ArgumentNullException

basePrintTicket 为 null。

PrintQueueException

验证、合并和可行性检查操作失败。

示例

以下示例演示如何使用此方法合并两个打印票证并响应 ValidationResult 返回的。

/// <summary>
/// Changes the user-default PrintTicket setting of the specified print queue.
/// </summary>
/// <param name="queue">the printer whose user-default PrintTicket setting needs to be changed</param>
static private void ChangePrintTicketSetting(PrintQueue queue)
{
    //
    // Obtain the printer's PrintCapabilities so we can determine whether or not
    // duplexing printing is supported by the printer.
    //
    PrintCapabilities printcap = queue.GetPrintCapabilities();

    //
    // The printer's duplexing capability is returned as a read-only collection of duplexing options
    // that can be supported by the printer. If the collection returned contains the duplexing
    // option we want to set, it means the duplexing option we want to set is supported by the printer,
    // so we can make the user-default PrintTicket setting change.
    //
    if (printcap.DuplexingCapability.Contains(Duplexing.TwoSidedLongEdge))
    {
        //
        // To change the user-default PrintTicket, we can first create a delta PrintTicket with
        // the new duplexing setting.
        //
        PrintTicket deltaTicket = new PrintTicket();
        deltaTicket.Duplexing = Duplexing.TwoSidedLongEdge;

        //
        // Then merge the delta PrintTicket onto the printer's current user-default PrintTicket,
        // and validate the merged PrintTicket to get the new PrintTicket we want to set as the
        // printer's new user-default PrintTicket.
        //
        ValidationResult result = queue.MergeAndValidatePrintTicket(queue.UserPrintTicket, deltaTicket);

        //
        // The duplexing option we want to set could be constrained by other PrintTicket settings
        // or device settings. We can check the validated merged PrintTicket to see whether the
        // the validation process has kept the duplexing option we want to set unchanged.
        //
        if (result.ValidatedPrintTicket.Duplexing == Duplexing.TwoSidedLongEdge)
        {
            //
            // Set the printer's user-default PrintTicket and commit the set operation.
            //
            queue.UserPrintTicket = result.ValidatedPrintTicket;
            queue.Commit();
            Console.WriteLine("PrintTicket new duplexing setting is set on '{0}'.", queue.FullName);
        }
        else
        {
            //
            // The duplexing option we want to set has been changed by the validation process
            // when it was resolving setting constraints.
            //
            Console.WriteLine("PrintTicket new duplexing setting is constrained on '{0}'.", queue.FullName);
        }
    }
    else
    {
        //
        // If the printer doesn't support the duplexing option we want to set, skip it.
        //
        Console.WriteLine("PrintTicket new duplexing setting is not supported on '{0}'.", queue.FullName);
    }
}

''' <summary>
''' Changes the user-default PrintTicket setting of the specified print queue.
''' </summary>
''' <param name="queue">the printer whose user-default PrintTicket setting needs to be changed</param>
Private Shared Sub ChangePrintTicketSetting(ByVal queue As PrintQueue)
    '
    ' Obtain the printer's PrintCapabilities so we can determine whether or not
    ' duplexing printing is supported by the printer.
    '
    Dim printcap As PrintCapabilities = queue.GetPrintCapabilities()

    '
    ' The printer's duplexing capability is returned as a read-only collection of duplexing options
    ' that can be supported by the printer. If the collection returned contains the duplexing
    ' option we want to set, it means the duplexing option we want to set is supported by the printer,
    ' so we can make the user-default PrintTicket setting change.
    '
    If printcap.DuplexingCapability.Contains(Duplexing.TwoSidedLongEdge) Then
        '
        ' To change the user-default PrintTicket, we can first create a delta PrintTicket with
        ' the new duplexing setting.
        '
        Dim deltaTicket As New PrintTicket()
        deltaTicket.Duplexing = Duplexing.TwoSidedLongEdge

        '
        ' Then merge the delta PrintTicket onto the printer's current user-default PrintTicket,
        ' and validate the merged PrintTicket to get the new PrintTicket we want to set as the
        ' printer's new user-default PrintTicket.
        '
        Dim result As ValidationResult = queue.MergeAndValidatePrintTicket(queue.UserPrintTicket, deltaTicket)

        '
        ' The duplexing option we want to set could be constrained by other PrintTicket settings
        ' or device settings. We can check the validated merged PrintTicket to see whether the
        ' the validation process has kept the duplexing option we want to set unchanged.
        '
        If result.ValidatedPrintTicket.Duplexing = Duplexing.TwoSidedLongEdge Then
            '
            ' Set the printer's user-default PrintTicket and commit the set operation.
            '
            queue.UserPrintTicket = result.ValidatedPrintTicket
            queue.Commit()
            Console.WriteLine("PrintTicket new duplexing setting is set on '{0}'.", queue.FullName)
        Else
            '
            ' The duplexing option we want to set has been changed by the validation process
            ' when it was resolving setting constraints.
            '
            Console.WriteLine("PrintTicket new duplexing setting is constrained on '{0}'.", queue.FullName)
        End If
    Else
        '
        ' If the printer doesn't support the duplexing option we want to set, skip it.
        '
        Console.WriteLine("PrintTicket new duplexing setting is not supported on '{0}'.", queue.FullName)
    End If
End Sub

注解

方法生成可行的打印票证;即，不请求打印机不支持的打印功能的票证。方法首先根据打印架构验证两个输入打印票证。如果其中一个无效，则会引发异常。

然后合并这两个票证。如果它们针对特定属性具有不同的值，则生成的合并票证最初使用增量票证的值。

然后，根据打印机的实际功能检查合并的票证。如果票证中的任何设置与打印机的功能不兼容，则打印机驱动程序会使用所需的任何逻辑更改这些设置。通常，它将用户或打印机的默认值替换为设置。因此，驱动程序的替代值的源与不是相同的票证 basePrintTicket，那么合并的票证可能具有一些与这两个输入票证不同的设置。如果打印机驱动程序必须更改任何设置，则会在的 ValidationResult属性中ConflictStatus报告此事实。

若要根据打印队列的默认设置进行合并和验证，应将设置为 basePrintTicketDefaultPrintTicket 或 UserPrintTicket。

参数 deltaPrintTicket 可以是 null，在这种情况下， basePrintTicket 将验证、检查可行性并返回（可能包含更改）。

如果重载为 MergeAndValidatePrintTicket，则返回的中的 ValidationResult 和 PrintTicket 都具有deltaPrintTicket作业范围。若要指定不同的范围，请使用此方法的另一个重载。

适用于

MergeAndValidatePrintTicket(PrintTicket, PrintTicket, PrintTicketScope)

合并两种 PrintTicket，保证所得的 PrintTicket 有效，不请求打印机所不支持的任何打印功能，且限于指定的作用域。

public:
 System::Printing::ValidationResult MergeAndValidatePrintTicket(System::Printing::PrintTicket ^ basePrintTicket, System::Printing::PrintTicket ^ deltaPrintTicket, System::Printing::PrintTicketScope scope);

public System.Printing.ValidationResult MergeAndValidatePrintTicket (System.Printing.PrintTicket basePrintTicket, System.Printing.PrintTicket deltaPrintTicket, System.Printing.PrintTicketScope scope);

member this.MergeAndValidatePrintTicket : System.Printing.PrintTicket * System.Printing.PrintTicket * System.Printing.PrintTicketScope -> System.Printing.ValidationResult

Public Function MergeAndValidatePrintTicket (basePrintTicket As PrintTicket, deltaPrintTicket As PrintTicket, scope As PrintTicketScope) As ValidationResult

参数

basePrintTicket: PrintTicket